# Project Dev

> 正式开发阶段工作流(承接 project-intake 预热):把 backlog 需求转化为可验证交付。特性循环:需求三问 → Spec → 用户确认 → Plan → Tasks;修改循环:Explore → Plan → Implement → Verify → Commit。当用户需要:在已完成预热(docs/ + AGENTS.md 就位)的工程上做需求开发、缺陷修复、优化时使用。前置:项目已完成 project-intake 预热。

- Skill: `jiujiugou/project-dev` (Agent Skill, multi-file: 4 files)
- Install (CLI): `npx skillmds@latest add jiujiugou/project-dev`
- Raw SKILL.md: https://api.skillmd.com/api/skills/jiujiugou/project-dev/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Product & Planning
- Author: jiujiugou (https://skillmd.com/u/jiujiugou)
- Updated: 2026-09-22
- Page: https://skillmd.com/skills/jiujiugou/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/templates.md);流程细节见 [references/workflow.md](references/workflow.md)。

## 完成定义

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

## 前置检查(动工前)

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