# Project Intake

> 开发预热阶段(第 0 阶段)工作流:接手已有代码库(尤其 AI 生成、缺少文档的项目)时,盘点、跑通、理解,并沉淀入场纪律(docs/ 认识文档 + AGENTS.md)。当用户需要:开工前先把工程认识清楚、建立运行基线与修改雷区时使用。适合"接收项目、准备开工"场景。需求转化、任务拆分、实现验证等属于预热完成后的正式开发阶段,另行规划,不在本技能范围。

- Skill: `jiujiugou/project-intake` (Agent Skill, multi-file: 7 files)
- Install (CLI): `npx skillmds@latest add jiujiugou/project-intake`
- Raw SKILL.md: https://api.skillmd.com/api/skills/jiujiugou/project-intake/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: jiujiugou (https://skillmd.com/u/jiujiugou)
- Updated: 2026-09-22
- Page: https://skillmd.com/skills/jiujiugou/project-intake

---


# Project Intake

开发流程的**预热阶段(第 0 阶段)**:在正式开发之前,把已有工程认识清楚、跑得起来、纪律基线就位。预热完成即交付"开工基线",之后才进入正式开发阶段(另行规划)。

## 定位与边界

- **本技能只做预热**:盘点(只读)→ 理解 → 沉淀入场纪律,不动业务代码。
- **预热完成 = 开工许可**:能跑(或明确"待验证"原因)、认识齐、AGENTS.md 就位,才能开始正式开发。
- **正式开发不在本技能**:需求规格、任务拆分、实现、验证、提交等工作流,预热完成后另行规划,本技能不内置。

## 核心原则

1. **记忆在文档,不在聊天**。每轮会话结束前,把结论写进 `docs/` 认识文档,聊天记录不承担记忆职责。
2. **先跑起来,再认识**。不运行的代码,理解全是猜测;先建立运行基线。跑不起来(硬件/环境依赖)时,静态分析并把运行基线标为"待验证"。
3. **功能清单基于代码,不是记忆**。每个功能必须标注代码位置与触发方式。
4. **风险先记疑点,验证后下结论**。认识阶段不做风险评估,只记录两类:理解疑点(`docs/04-疑点清单.md`)与修改雷区(AGENTS.md 项目警告节)。
5. **阶段 2 由 AI 自主完成**。人工不介入;AI 交付 HTML 导读,用户按需阅读验收。
6. **预热期间不动业务代码**。只读盘点;如遇"跑不起来"且修复属于最小运行阻塞,先向用户说明并获得确认后才改。

## 阶段流程

| 阶段 | 内容 | 产物 |
| --- | --- | --- |
| 1 盘点(只读) | 侦察 + 跑通项目 | `docs/01-盘点.md` |
| 2 理解(AI 自主) | 架构 + 功能清单 + 疑点 + 导读 | `docs/02~04` + `docs/00-项目导读.html` |
| 3 纪律收尾 | 整理雷区 + 生成 AGENTS.md + 收尾 | `AGENTS.md` |

阶段 1/2 详见 [references/understanding.md](references/understanding.md);阶段 3 详见 [references/discipline.md](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/` 等开发阶段目录;需求池、规格、决策记录、工作日志等开发阶段运转系统,待开发阶段规划后另行建立。

## 验收标准(结束闸门)

预热完成 = 以下全部通过:

1. **运行基线明确**:已验证(记录命令与验证方式),或"待验证"(标注原因与验证方法)。
2. **认识文档齐备**:`docs/00-项目导读.html` 可离线打开,与 `docs/01~04` 一致;用户能不看代码,凭导读讲清项目是干什么的、怎么运转的。
3. **功能清单可靠**:覆盖所有可见入口,每条有代码位置与触发方式。
4. **疑点清单诚实**:全部标注"待验证"或已验证结论,没有未经验证就写成结论的条目。
5. **纪律基线就位**:`AGENTS.md` 五节齐全,项目警告包含全部已发现雷区,每条规则可执行。
6. **记忆已沉淀**:所有结论已写入文档,未留在聊天里。

闸门未过,不进入正式开发;闸门已过,交付开工基线,进入开发阶段(另行规划)。

## 后续

预热闸门通过后进入正式开发阶段,流程见独立技能 project-dev(需求三问、spec/tasks/ADR/worklog、验证闭环)。AGENTS.md 生成规范见 [references/agentsdescription.md](references/agentsdescription.md);通用项目原则见 [references/agentrules.md](references/agentrules.md)。