17
Spec Slim · workflow
spec-slimming-gate
17-spec-slimming-gate.md
◉
WHAT IS THIS
定位PRD/Spec 瘦身关口。它用于判断文档是否把 product decision、architecture decision、implementation plan、test fixture 全塞在一起。
⚡
TRIGGERS
触发场景▸用户问“是不是 over engineering”。
▸Requirements 文档越来越像实现计划。
▸PRD 里出现 hash 规则、schema shape、文件路径、测试 fixture。
▸Plan、ADR、PRD 之间职责不清。
▸文档太长，后续 agent 很难判断什么是必须、什么只是建议。
↹
INPUT & OUTPUT
输入 / 产出↘ INPUT
- PRD 或 requirements。
- ADR。
- Plan。
- CONTEXT。
- 当前实现状态，可选。
↗ OUTPUT
- 保留在 PRD 的内容。
- 下沉到 Plan 的内容。
- 需要 ADR 的内容。
- 删除或延后的内容。
- 一份瘦身 patch。
🪜
STEPS
编排步骤- 1标注句子职责每段标 product、architecture、implementation、verification、example、open question。
- 2判断文档目标PRD 回答为什么和必须是什么；Plan 回答怎么做；ADR 记录不可逆或长期架构决策。
- 3下沉实现细节文件路径、函数名、schema 细节、测试 fixture、脚本步骤移到 Plan。
- 4提升架构决策跨模块边界、协议、状态机、持久化策略移到 ADR。
- 5删除重复解释同一个约束只保留 canonical 位置，其它地方引用。
- 6保留验收标准不删 acceptance criteria，但要避免写成实现步骤。
⚙
AGENT ROLES
Agent 分工⚙
Classifier
给段落打职责标签。
⚙
Product Reviewer
判断目标和范围。
⚙
Architecture Reviewer
挑 ADR 候选。
⚙
Editor
做瘦身 patch。
⚙
Verifier
检查信息没有丢失，只是换位置。
✓
ACCEPTANCE GATE
验收 gate- ✓PRD 只回答目标、约束、用户价值、验收。
- ✓Plan 承载实现步骤。
- ✓ADR 承载长期架构决策。
- ✓没有同一决策多处重复表述。
- ✓瘦身后文档仍能指导实现。
- ✓open questions 清晰可回答。
⊘
FAILURE HANDLING
失败处理如果删掉某段会丢失验收标准，改写为 acceptance criteria，而不是删除。
如果 implementation detail 其实是 contract，转 ADR。
如果没有 Plan 文件，先创建 plan，不把内容硬塞回 PRD。
⌘
TEMPLATE
分类表模板| Section | Current role | Keep in PRD | Move to | Reason |
| --- | --- | --- | --- | --- |