zzusp/doc-first-dev / skills/spec-multi
spec-multi
Verified| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 1.8 KB |
| assets/multi-spec-blank.md | markdown | 1.3 KB |
| assets/services-index-blank.md | markdown | 559 B |
| error-handling.md | markdown | 1.6 KB |
| evals/eval-01-cross-service-feature.md | markdown | 2.5 KB |
| evals/eval-02-interface-drift.md | markdown | 1.8 KB |
| evals/eval-03-partial-service-change.md | markdown | 2.2 KB |
| init.md | markdown | 1.9 KB |
| phase-a.md | markdown | 4.3 KB |
| phase-b.md | markdown | 2.6 KB |
| phase-c.md | markdown | 6.1 KB |
| phase-d.md | markdown | 2.9 KB |
| step0.md | markdown | 1.2 KB |
phase-d.md
View on GitHub# Phase D — 收尾
**前提:所有 A-xxx(含 [E2E])均为 ✅。**
---
## D.1 一致性审计
**① 接口定义 ↔ 提供方代码**
对需求文档"接口定义"节中每个提供方接口,读取对应代码的实际实现,检查:
- 方法签名(参数、返回类型)是否与文档一致
- 响应字段是否与文档一致
**② 调用方代码 ↔ 接口定义**
对需求文档"接口定义"节中每个调用方引用,读取调用方代码实际发送的请求格式,检查:
- 请求字段与提供方接口定义是否一致
- 对返回数据的处理方式是否与接口响应格式一致
**若发现不符**:
收集所有问题,一次性展示给用户:
```
发现以下不一致,请确认如何处理:
1. 接口定义:[backend] POST /api/export 响应 { fileUrl: string }
实际代码:ExportController 返回 { url: string }
→ 以代码为准(更新需求文档)/ 以文档为准(修改代码)?
```
按用户指示更新需求文档或代码。
---
## D.2 清理任务和验收节
- **删除**:状态为 ✅ 的 T-xxx(实现已在代码中,无需留存)
- **保留**:状态为"已取消"的 T-xxx,附取消原因(作为决策记录)
- **检查**:若仍有"待开始"/"进行中"的 T-xxx,标注为风险项,提示用户处理
- **A-xxx**:保留所有 A-xxx(含通过证据),作为验收记录
- **循环计数器**:删除验收节末尾的循环计数器行(`验收循环次数:N`),过程状态交付后无意义
---
## D.3 更新 SERVICES.md 需求记录表
在 `docs/plans/SERVICES.md` 末尾"需求记录"表中追加一行:
```
| <需求名称> | [<需求名>](requirements/<文件名>.md) | <今日日期> |
```
---
## D.4 交付摘要
生成交付摘要并展示给用户:
```
## 交付摘要 — <需求名称>
**涉及服务**:<服务A>、<服务B>、<服务C>
**完成情况**:
- [服务A]:实现 N 项任务
- [服务B]:实现 N 项任务
- [E2E]:N 项集成验收全部通过
**验收总览(共 N 项,N 项一次通过,N 项修复后通过)**:
从验收历史记录表中读取所有数据,输出如下表格(每个 R 列对应一个验收轮次,仅展示实际发生的轮次):
| 服务 | 项 | 验证点摘要 | R1 | R2 | R3 | 根因(失败时) |
|------|-----|-----------|----|----|----|-|
| backend | A-05 | POST /api/export | ❌ 500 | ✅ 200 | — | NPE at ExportService |
| backend | A-07 | GET /api/list | ✅ 200, total:3 | — | — | — |
| E2E | A-10 | 导出完整链路 | ❌ 链路第2步失败 | ✅ 全链路通过 | — | 调用方请求格式不匹配 |
> 若验收历史记录表不存在(全程一次通过),表格仅含 R1 列,所有行均为 ✅。
**取消项**(若有):
- T-xx [服务A] — <取消原因>
**遗留风险**(若有):
- <未完成的 T-xxx 及原因>
---
建议运行 /whylog-record 记录本次开发中的关键决策和取舍。
```
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 |