Project Intake
开发流程的预热阶段(第 0 阶段):在正式开发之前,把已有工程认识清楚、跑得起来、纪律基线就位。预热完成即交付"开工基线",之后才进入正式开发阶段(另行规划)。
定位与边界
- 本技能只做预热:盘点(只读)→ 理解 → 沉淀入场纪律,不动业务代码。
- 预热完成 = 开工许可:能跑(或明确"待验证"原因)、认识齐、AGENTS.md 就位,才能开始正式开发。
- 正式开发不在本技能:需求规格、任务拆分、实现、验证、提交等工作流,预热完成后另行规划,本技能不内置。
核心原则
- 记忆在文档,不在聊天。每轮会话结束前,把结论写进
docs/ 认识文档,聊天记录不承担记忆职责。
- 先跑起来,再认识。不运行的代码,理解全是猜测;先建立运行基线。跑不起来(硬件/环境依赖)时,静态分析并把运行基线标为"待验证"。
- 功能清单基于代码,不是记忆。每个功能必须标注代码位置与触发方式。
- 风险先记疑点,验证后下结论。认识阶段不做风险评估,只记录两类:理解疑点(
docs/04-疑点清单.md)与修改雷区(AGENTS.md 项目警告节)。
- 阶段 2 由 AI 自主完成。人工不介入;AI 交付 HTML 导读,用户按需阅读验收。
- 预热期间不动业务代码。只读盘点;如遇"跑不起来"且修复属于最小运行阻塞,先向用户说明并获得确认后才改。
阶段流程
| 阶段 |
内容 |
产物 |
| 1 盘点(只读) |
侦察 + 跑通项目 |
docs/01-盘点.md |
| 2 理解(AI 自主) |
架构 + 功能清单 + 疑点 + 导读 |
docs/02~04 + docs/00-项目导读.html |
| 3 纪律收尾 |
整理雷区 + 生成 AGENTS.md + 收尾 |
AGENTS.md |
阶段 1/2 详见 references/understanding.md;阶段 3 详见 references/discipline.md。
产出目录
docs/ # 认识文档: 一次性理解沉淀(阶段 1 + 2)
00-项目导读.html # 人类阅读入口: 概览、导航、架构图(阶段 2 生成, 双击可开)
01-盘点.md # 技术栈、结构、怎么跑(阶段 1)
02-架构理解.md # 模块边界、数据流(阶段 2)
03-功能清单.md # 已有功能 + 代码位置(阶段 2)
04-疑点清单.md # 待验证疑点, 验证后回填结论(阶段 2)
AGENTS.md # 入场纪律基线: 描述/模块/原则/规则/警告(阶段 3 生成)
预热阶段不创建 notes/ 等开发阶段目录;需求池、规格、决策记录、工作日志等开发阶段运转系统,待开发阶段规划后另行建立。
验收标准(结束闸门)
预热完成 = 以下全部通过:
- 运行基线明确:已验证(记录命令与验证方式),或"待验证"(标注原因与验证方法)。
- 认识文档齐备:
docs/00-项目导读.html 可离线打开,与 docs/01~04 一致;用户能不看代码,凭导读讲清项目是干什么的、怎么运转的。
- 功能清单可靠:覆盖所有可见入口,每条有代码位置与触发方式。
- 疑点清单诚实:全部标注"待验证"或已验证结论,没有未经验证就写成结论的条目。
- 纪律基线就位:
AGENTS.md 五节齐全,项目警告包含全部已发现雷区,每条规则可执行。
- 记忆已沉淀:所有结论已写入文档,未留在聊天里。
闸门未过,不进入正式开发;闸门已过,交付开工基线,进入开发阶段(另行规划)。
后续
预热闸门通过后进入正式开发阶段,流程见独立技能 project-dev(需求三问、spec/tasks/ADR/worklog、验证闭环)。AGENTS.md 生成规范见 references/agentsdescription.md;通用项目原则见 references/agentrules.md。
1---2name: project-intake3description: 开发预热阶段(第 0 阶段)工作流:接手已有代码库(尤其 AI 生成、缺少文档的项目)时,盘点、跑通、理解,并沉淀入场纪律(docs/ 认识文档 + AGENTS.md)。当用户需要:开工前先把工程认识清楚、建立运行基线与修改雷区时使用。适合"接收项目、准备开工"场景。需求转化、任务拆分、实现验证等属于预热完成后的正式开发阶段,另行规划,不在本技能范围。4---56# Project Intake78开发流程的**预热阶段(第 0 阶段)**:在正式开发之前,把已有工程认识清楚、跑得起来、纪律基线就位。预热完成即交付"开工基线",之后才进入正式开发阶段(另行规划)。910## 定位与边界1112- **本技能只做预热**:盘点(只读)→ 理解 → 沉淀入场纪律,不动业务代码。13- **预热完成 = 开工许可**:能跑(或明确"待验证"原因)、认识齐、AGENTS.md 就位,才能开始正式开发。14- **正式开发不在本技能**:需求规格、任务拆分、实现、验证、提交等工作流,预热完成后另行规划,本技能不内置。1516## 核心原则17181. **记忆在文档,不在聊天**。每轮会话结束前,把结论写进 `docs/` 认识文档,聊天记录不承担记忆职责。192. **先跑起来,再认识**。不运行的代码,理解全是猜测;先建立运行基线。跑不起来(硬件/环境依赖)时,静态分析并把运行基线标为"待验证"。203. **功能清单基于代码,不是记忆**。每个功能必须标注代码位置与触发方式。214. **风险先记疑点,验证后下结论**。认识阶段不做风险评估,只记录两类:理解疑点(`docs/04-疑点清单.md`)与修改雷区(AGENTS.md 项目警告节)。225. **阶段 2 由 AI 自主完成**。人工不介入;AI 交付 HTML 导读,用户按需阅读验收。236. **预热期间不动业务代码**。只读盘点;如遇"跑不起来"且修复属于最小运行阻塞,先向用户说明并获得确认后才改。2425## 阶段流程2627| 阶段 | 内容 | 产物 |28| --- | --- | --- |29| 1 盘点(只读) | 侦察 + 跑通项目 | `docs/01-盘点.md` |30| 2 理解(AI 自主) | 架构 + 功能清单 + 疑点 + 导读 | `docs/02~04` + `docs/00-项目导读.html` |31| 3 纪律收尾 | 整理雷区 + 生成 AGENTS.md + 收尾 | `AGENTS.md` |3233阶段 1/2 详见 [references/understanding.md](references/understanding.md);阶段 3 详见 [references/discipline.md](references/discipline.md)。3435## 产出目录3637```38docs/ # 认识文档: 一次性理解沉淀(阶段 1 + 2)39 00-项目导读.html # 人类阅读入口: 概览、导航、架构图(阶段 2 生成, 双击可开)40 01-盘点.md # 技术栈、结构、怎么跑(阶段 1)41 02-架构理解.md # 模块边界、数据流(阶段 2)42 03-功能清单.md # 已有功能 + 代码位置(阶段 2)43 04-疑点清单.md # 待验证疑点, 验证后回填结论(阶段 2)4445AGENTS.md # 入场纪律基线: 描述/模块/原则/规则/警告(阶段 3 生成)46```4748预热阶段不创建 `notes/` 等开发阶段目录;需求池、规格、决策记录、工作日志等开发阶段运转系统,待开发阶段规划后另行建立。4950## 验收标准(结束闸门)5152预热完成 = 以下全部通过:53541. **运行基线明确**:已验证(记录命令与验证方式),或"待验证"(标注原因与验证方法)。552. **认识文档齐备**:`docs/00-项目导读.html` 可离线打开,与 `docs/01~04` 一致;用户能不看代码,凭导读讲清项目是干什么的、怎么运转的。563. **功能清单可靠**:覆盖所有可见入口,每条有代码位置与触发方式。574. **疑点清单诚实**:全部标注"待验证"或已验证结论,没有未经验证就写成结论的条目。585. **纪律基线就位**:`AGENTS.md` 五节齐全,项目警告包含全部已发现雷区,每条规则可执行。596. **记忆已沉淀**:所有结论已写入文档,未留在聊天里。6061闸门未过,不进入正式开发;闸门已过,交付开工基线,进入开发阶段(另行规划)。6263## 后续6465预热闸门通过后进入正式开发阶段,流程见独立技能 project-dev(需求三问、spec/tasks/ADR/worklog、验证闭环)。AGENTS.md 生成规范见 [references/agentsdescription.md](references/agentsdescription.md);通用项目原则见 [references/agentrules.md](references/agentrules.md)。
jiujiugou