zzusp/doc-first-dev / skills/spec-first
spec-first
Verified管理项目模块的完整开发周期:需求分析→更新技术方案→spec确认→开发→验收→收尾。适用于功能新增、Bug修复、需求变更、接口调整、重构、字段增删等涉及代码变更的任务;项目下有或无 spec 文档均可触发,无需用户明确指定流程。
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 3.9 KB |
| assets/api-blank.md | markdown | 2.7 KB |
| assets/claude-md-snippet.md | markdown | 1.8 KB |
| assets/project-index.md | markdown | 1.7 KB |
| assets/tech-spec-blank.md | markdown | 4.8 KB |
| error-handling.md | markdown | 1.4 KB |
| evals/eval-01-new-feature.md | markdown | 1.8 KB |
| evals/eval-02-spec-code-mismatch.md | markdown | 1.3 KB |
| evals/eval-03-init-flow.md | markdown | 1.2 KB |
| init.md | markdown | 1.2 KB |
| phase-a.md | markdown | 10.5 KB |
| phase-b.md | markdown | 4.9 KB |
| phase-c.md | markdown | 6.8 KB |
| phase-d.md | markdown | 5.3 KB |
| step0.md | markdown | 3.9 KB |
SKILL.md
View on GitHub---
name: spec-first
description: 管理项目模块的完整开发周期:需求分析→更新技术方案→spec确认→开发→验收→收尾。适用于功能新增、Bug修复、需求变更、接口调整、重构、字段增删等涉及代码变更的任务;项目下有或无 spec 文档均可触发,无需用户明确指定流程。
---
# /spec-first — 文档驱动开发周期管理
本 skill 驱动从需求到交付的完整流程:
```
需求到来 → 匹配文档 → 分析 → 更新spec → spec确认 → 开发 → 验收 → 收尾
```
适用于:新功能、Bug修复、需求调整、重构——有或无 spec 均可触发,无 spec 时会在流程中创建。
**触发后立即输出以下进度 Checklist;每个阶段完成时,重新输出当前状态的 Checklist(已完成项标为 `[x]`):**
```
开发周期进度
- [ ] Step 0 需求接收,文档匹配
- [ ] Step 1 阶段判断
- [ ] Phase A 分析与更新 spec
- [ ] Phase B 按方案开发
- [ ] Phase C 验收
- [ ] Phase D 收尾
```
异常处理规则见 [error-handling.md](error-handling.md)。
**模板文件**(按需读取):
- [assets/project-index.md](assets/project-index.md) — 项目索引骨架(PROJECT.md)
- [assets/tech-spec-blank.md](assets/tech-spec-blank.md) — 技术方案骨架
- [assets/api-blank.md](assets/api-blank.md) — 接口文档骨架
- [assets/claude-md-snippet.md](assets/claude-md-snippet.md) — CLAUDE.md 片段
---
## 前置检查 — 环境就绪
**在执行任何步骤前**,依次检查以下两项:
**① 检查项目根目录 `CLAUDE.md`**:
- **存在且包含"构建命令"/"启动与认证"等章节** → 正常,继续 ②
- **存在但缺少上述章节** → 立即分析项目文件推断缺失内容并补全写入 `CLAUDE.md`(参照 `assets/claude-md-snippet.md` 对应章节格式;无法推断的字段保留占位符),继续 ②
- **不存在** → 读取 [assets/claude-md-snippet.md](assets/claude-md-snippet.md),在项目根目录创建 `CLAUDE.md` 并写入完整片段内容(占位符保留,后续各阶段执行时再实际填写),继续 ②
**② 检查 `docs/plans/PROJECT.md`**:
- **存在** → 直接进入 Step 0
- **不存在** → 读取 [init.md](init.md),完成初始化后进入 Step 0
---
## Step 0 — 接收需求,匹配文档
读取 [step0.md](step0.md) 并执行。
---
## Step 1 — 判断当前阶段
**前置检查**:确认 spec 已加载(本 session 中 Step 0 已执行,或用户提供了 spec 文件路径)。若两者均未满足,输出以下提示后**立即终止,不执行后续任何步骤**:
```
⛔ 未找到工作文档。请重新运行 /spec-first 并在 Step 0 选择或创建 spec 文档。
```
扫描 spec 的任务状态(T-xxx)和验收状态(A-xxx),按以下条件**从上到下优先匹配**,读取并执行对应 Phase 文档:
**第一条"用户描述了新需求或变更"的判断标准**:用户**本轮**消息中包含尚未体现在 spec 中的需求、功能描述或变更说明(包含新功能、Bug 修复、调整要求等)。若用户本轮仅发送"继续"/"接着做"/"开始开发"等不含新信息的指令,跳过第一条,按任务/验收状态向下匹配。
| 条件 | Phase |
|---|---|
| 用户描述了新需求或变更 | 读取 [phase-a.md](phase-a.md) — 分析与更新 |
| 有"待开始"/"进行中"的 T-xxx | 读取 [phase-b.md](phase-b.md) — 按方案开发 |
| 所有 T-xxx 均为 ✅ 或已取消,有"待验证"/"未通过"的 A-xxx | 读取 [phase-c.md](phase-c.md) — 验收 |
| 所有 T-xxx 均为 ✅ 或已取消,且所有 A-xxx ✅(A-xxx 不为空) | 读取 [phase-d.md](phase-d.md) — 收尾 |
| spec 无任务/验收项,或有 T-xxx 但无 A-xxx | 读取 [phase-a.md](phase-a.md) — 分析与更新 |
状态混乱时询问用户确认;用户可显式指定阶段覆盖自动判断。
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |