spec-to-repo 是一个交付导向的技能，用于把产品规格（PRD、功能简介）转化为可执行的仓库计划，重点是“怎么拆解和落地”，而非撰写 PRD。
适用场景：将 PRD 或功能简介翻译成工单序列；为多周功能设计分支与 PR 顺序；审计现有工单拆解的风险（过大工单、隐藏依赖）；定义覆盖代码、测试、文档、遥测的完成标准；规划增量发布（特性开关、金丝雀、暗启动）；在冲刺规划前评审拆解方案。
使用前需确认输入：PRD 或规格文档、目标发布窗口、工程团队规模与构成、风险特征、特性开关与发布策略。若信息不明先询问，最多问会最影响结果的 2-3 项；若用户要求直接起草，则在产物顶部列出假设。
主要工作流：
- 将 PRD 拆解为工单，运行：python3 spec-to-repo/scripts/prd_to_tickets_decomposer.py --input prd.json --format markdown
- 校验分支与 PR 计划，运行：python3 spec-to-repo/scripts/pr_scope_analyzer.py --input pr_plan.json --format markdown
- 检查分支命名规范，运行：python3 spec-to-repo/scripts/branch_naming_validator.py --input branches.txt --format markdown
工单尺寸分为 XS 至 XL，L 或 XL 通常意味着拆解不足，应继续拆分。工单树为：Epic（产品功能）→ Story（用户可见能力）→ Ticket（工程工作项）→ Subtask。推荐“垂直切片”，让后端、前端、测试、遥测、文档在一次交付中完成；无法垂直切分时用特性开关和暗启动。
多 PR 功能的建议顺序：基础设施/脚手架、后端（开关后）、前端（开关后）、遥测、文档与 runbook、开关启用。每个 PR 尽量小于 400 行。完成标准涵盖代码、测试、遥测、文档、可访问性、特性开关与发布计划。
限制：资料未提供收费、价格、平台细节；具体脚本行为以实际文件为准。