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 |
evals/eval-02-spec-code-mismatch.md
View on GitHub# Eval 02 — Phase B 中途发现 spec 与代码不符
## 场景描述
开发过程中 Claude 读取源码后发现实际实现与 spec 描述不一致,触发暂停确认机制。
## 输入
```json
{
"skills": ["spec-first"],
"query": "继续执行 T-08,在 OrderService.createOrder() 增加库存校验",
"context": "spec 中 T-08 状态为"待开始";spec 代码地图记录 createOrder() 在 OrderServiceImpl.java;但实际读取文件发现该方法已拆分为 createOrder() + validateStock(),且 validateStock() 已实现库存校验逻辑"
}
```
## 预期行为
- [ ] Phase B 执行 T-08 时读取 OrderServiceImpl.java
- [ ] 发现代码与 spec 描述不符(方法已拆分,库存校验已存在)
- [ ] **暂停开发**,不自行修改 spec 或继续实现
- [ ] 向用户清晰描述不一致内容:spec 说 createOrder() 需新增库存校验 vs 代码中 validateStock() 已实现
- [ ] 提供两个选项:① 以代码为准更新 spec(标记 T-08 已完成)② 以 spec 为准调整代码(保留 T-08 待开始)
- [ ] 等待用户选择后按指示继续
## 不应出现的行为
- 自行判断"代码已实现,直接标记 T-08 完成"
- 自行修改 spec 后继续开发,不通知用户
- 忽略不一致,继续实现可能重复的功能
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: 197k | 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 |