4.2 一个适合协作的最小项目骨架
面向经管学生、研究者与从业者的 AI 智能体设计教材

不是每个项目都需要复杂骨架,但一个最低限度可协作的目录,至少要把四类东西分开:输入、输出、参考、规则。
一个足够小、也足够稳的骨架可以是这样:
project/
├── inputs/ # 原始材料、待处理文件、用户输入
├── outputs/ # 最终交付物和中间产出
├── references/ # 模板、样例、背景说明
├── notes/ # 临时笔记、状态记录、问题清单
└── CLAUDE.md # 项目规则文件这个结构解决的是协作中的实际问题。
inputs/让智能体知道事实来源在哪里。outputs/让它知道产出该写到哪,而不是随手散落到根目录。references/把模板、风格说明、术语表这类辅助材料隔出来,避免和原始输入混淆。notes/给探索结果、待确认问题、阶段性状态一个临时落点,避免把这些内容硬塞进最终交付物。
目录设计不是为了好看,而是为了控边界。输入区和输出区没分开,智能体就更容易误改原文件;参考区和临时笔记混在一起,模型就更难判断什么是硬约束,什么只是草稿。
本章不追求固定模板,更重要的是建立两个原则。
第一,目录命名要让陌生人一眼看懂。第二,目录划分要直接服务后续动作:读什么、写什么、查什么、暂存什么。只要这两个原则成立,项目就已经有了可协作的基础。
最小骨架原则
项目目录不需要一步到位。先用 4-5 个顶层文件夹把输入、输出、参考、临时笔记和规则分开,后续再按需细化。起步阶段,目录越少越好维护。