Spec first

Agent Skills for doc-first delivery — one living spec per module, decisions logged separately.

Install

npx -y skills add zzusp/doc-first-dev --skill spec-first

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

One thing to look at

4 stars4 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

Copied from the file, not written here

管理项目模块的完整开发周期：需求分析→更新技术方案→spec确认→开发→验收→收尾。适用于功能新增、Bug修复、需求变更、接口调整、重构、字段增删等涉及代码变更的任务；项目下有或无 spec 文档均可触发，无需用户明确指定流程。

3.9 KB, as published. Nobody here has run it

本 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。

模板文件（按需读取）：

在执行任何步骤前，依次检查以下两项：

① 检查项目根目录 CLAUDE.md：

存在且包含"构建命令"/"启动与认证"等章节 → 正常，继续 ②
存在但缺少上述章节 → 立即分析项目文件推断缺失内容并补全写入 CLAUDE.md（参照 assets/claude-md-snippet.md 对应章节格式；无法推断的字段保留占位符），继续 ②
不存在 → 读取 assets/claude-md-snippet.md，在项目根目录创建 CLAUDE.md 并写入完整片段内容（占位符保留，后续各阶段执行时再实际填写），继续 ②

② 检查 docs/plans/PROJECT.md：

读取 step0.md 并执行。

前置检查：确认 spec 已加载（本 session 中 Step 0 已执行，或用户提供了 spec 文件路径）。若两者均未满足，输出以下提示后立即终止，不执行后续任何步骤：

⛔ 未找到工作文档。请重新运行 /spec-first 并在 Step 0 选择或创建 spec 文档。

扫描 spec 的任务状态（T-xxx）和验收状态（A-xxx），按以下条件从上到下优先匹配，读取并执行对应 Phase 文档：

第一条"用户描述了新需求或变更"的判断标准：用户本轮消息中包含尚未体现在 spec 中的需求、功能描述或变更说明（包含新功能、Bug 修复、调整要求等）。若用户本轮仅发送"继续"/"接着做"/"开始开发"等不含新信息的指令，跳过第一条，按任务/验收状态向下匹配。

条件	Phase
用户描述了新需求或变更	读取 phase-a.md — 分析与更新
有"待开始"/"进行中"的 T-xxx	读取 phase-b.md — 按方案开发
所有 T-xxx 均为 ✅ 或已取消，有"待验证"/"未通过"的 A-xxx	读取 phase-c.md — 验收
所有 T-xxx 均为 ✅ 或已取消，且所有 A-xxx ✅（A-xxx 不为空）	读取 phase-d.md — 收尾
spec 无任务/验收项，或有 T-xxx 但无 A-xxx	读取 phase-a.md — 分析与更新

状态混乱时询问用户确认；用户可显式指定阶段覆盖自动判断。