Skip to content

zzusp/doc-first-dev / skills/spec-multi

spec-multi

Verified

FileKindSize
SKILL.mdskill md1.8 KB
assets/multi-spec-blank.mdmarkdown1.3 KB
assets/services-index-blank.mdmarkdown559 B
error-handling.mdmarkdown1.6 KB
evals/eval-01-cross-service-feature.mdmarkdown2.5 KB
evals/eval-02-interface-drift.mdmarkdown1.8 KB
evals/eval-03-partial-service-change.mdmarkdown2.2 KB
init.mdmarkdown1.9 KB
phase-a.mdmarkdown4.3 KB
phase-b.mdmarkdown2.6 KB
phase-c.mdmarkdown6.1 KB
phase-d.mdmarkdown2.9 KB
step0.mdmarkdown1.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 记录本次开发中的关键决策和取舍。
```
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: 197kUpdated Claude CodeCodexVerifiedInstall
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: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
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: 194kUpdated Claude CodeCodexVerifiedInstall