Project Dev

Project Dev

正式开发阶段:承接 project-intake 的开工基线,把 backlog 里的需求做出来并验证掉。前置:预热已完成(docs/00~04 + AGENTS.md 就位);若未完成,先跑 project-intake。

定位与边界

• 只做开发:需求 → 规格 → 任务 → 实现 → 验证,不改动预热产物结构。
• 一次只跑一个特性;git 提交由用户执行。
• 需求实现后同步 docs/,不留过期结论。

核心原则

1. 一次只做一个需求。backlog 顶部未完成前冻结新功能,新想法只入池。
2. Spec 先确认后动工。未获用户确认,不拆任务、不写代码。
3. 验收标准必须可执行。每条对应一条命令或复现步骤,能跑、能勾选。
4. AI 自验后交付。实现完 AI 自己跑完验证,结果随交付报告,不自说自话。
5. 大改动先写 ADR。接口/数据模型/模块边界/依赖版本变更,先记录决策再动手。
6. 记忆在文档。结论入 notes/ 与 docs/,聊天不承担记忆。
7. git 提交由用户执行。AI 准备提交信息,用户确认后提交。
8. 破坏性操作需审批。删除/移动/覆盖/重置文件前,先列出完整清单向用户说明,获明确确认后才执行;禁止通配符批量删除;AI 不执行 git reset --hard / git checkout -- . 等批量回滚。

两层循环

特性循环(管"做对的事")

backlog 顶部需求 → 需求三问 → Spec → 用户确认 → Plan → Tasks(3~5个)

• 需求三问:为什么做 / 验收标准是什么 / 不做会怎样。用户直接需求,答案即 spec 素材,不拦截;AI 自发想法必须完整过三问。
• Spec 未确认,不拆任务、不实现。
• Tasks 拆成可独立实现、独立验证的小块。

修改循环(管"把事做对",每个任务一遍)

Explore → Plan → Implement → Verify → Commit

• Explore:读相关代码,对照 docs/ 认识文档,确认改动点,不写代码。
• Verify:跑任务级验证(命令/步骤),AI 自己跑完,记录结果;跑不起来标"待验证"+原因,不算完成。
• Commit:按任务粒度准备提交信息,用户执行提交。

产出

notes/
  README.md      # 入口: 必读规则 + 目录导航; 动工前必读
  backlog.md     # 需求池: 功能/缺陷/优化, 顶部为当前目标
  specs/         # 一页纸需求规格, 每条需求一份(NNN-短标题.md)
  tasks/         # 任务清单, 每个特性一份(NNN-短标题.md)
  ADR/           # 关键决策记录(NNN-标题.md)
  worklog/       # 工作日志, 按日期一个文件(YYYY-MM-DD.md)

目录与全部模板见 references/templates.md;流程细节见 references/workflow.md。

完成定义

• 任务完成 = 验证通过(AI 自验,命令/步骤 + 结果记录)。
• 特性完成 = 全部任务"已验证" + spec 验收标准逐条勾选 + docs/02~04 同步(仅行为变化处)并刷新导读 + worklog 记录。

前置检查(动工前)

1. docs/00~04 与 AGENTS.md 存在;未完成先跑 project-intake。
2. notes/ 未建立则先按 references/templates.md 搭建。
3. 把本技能的工作流规则补进 AGENTS.md 的"项目规则"节(替换预热的最小协作规则)。