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-b.md
View on GitHub# Phase B — 编排开发
**前提:Phase A 确认门已通过,需求文档中所有节已填充。**
---
## B.1 提取任务并确定批次
读取需求文档:
- 从"涉及服务与依赖顺序"节获取服务依赖顺序
- 从"任务"节按 `[服务名]` 标签分组提取各服务的 T-xxx 列表
**确定执行批次**(依赖顺序 → 串行批次,无依赖 → 并行):
```
示例:
批次 1(并行):data-service
批次 2(并行):backend(依赖 data-service 完成)
批次 3(并行):frontend(依赖 backend 完成)
```
若多个服务互不依赖,可合并到同一批次并行执行。
---
## B.2 逐批次执行
对每个批次:
**开始前**:将本批次各服务的 T-xxx 状态更新为"进行中"。若发现已有"进行中"状态的 T-xxx(上次 session 中断留下的断点标记),先输出提示 `"检测到上次中断的任务 T-xx [服务名],将从头重新执行"`,再将状态改为"待开始"继续流程。
**启动 subagent**:为批次中每个服务独立启动一个 subagent,携带:
- 服务本地路径(来自 SERVICES.md)
- 需求文档路径
- 该服务的 T-xxx 列表(过滤 `[服务名]` 标签)
- 需求文档中"接口定义"节的相关内容(该服务作为调用方时需要知道提供方的接口)
subagent 职责:
1. 读取该服务的代码,理解现有结构
2. 按 T-xxx 实现代码变更
3. 每完成一个 T-xxx,在需求文档中将其标记为 ✅
4. 若发现需求文档(接口定义/代码地图)与实际代码有出入,记录差异,**不擅自决定**,在返回摘要中标注
**汇总结果**:收到 subagent 返回后,检查是否有标注的差异。
**若有 spec ↔ 代码不符**:
暂停后续批次,收集本批次所有差异,一次性展示给用户:
```
发现以下 spec 与代码不符之处,请确认如何处理:
1. backend: 需求文档定义接口返回 `{ fileUrl: string }`,
但代码中现有同名接口返回 `{ url: string }`
→ 以 spec 为准(修改代码)/ 以代码为准(更新文档)?
2. ...
```
按用户指示逐项处理后,继续下一批次。
---
## B.3 Build 验证
所有批次完成后,按 SERVICES.md 中各服务的启动命令推断 build 命令,逐一执行各服务 build:
- 全部通过 → 进入 [phase-c.md](phase-c.md)
- 任意失败 → 展示错误输出,定位失败原因并尝试修复后重跑;反复失败时停止并等待用户指示
- 无法推断某服务的 build 命令 → 向用户报告并等待用户提供,不自动跳过——未经构建验证的代码进入验收大概率失败
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 |