用途:在 harness-init 环境搭建与 harness-loop 自主冲刺之间,完成单个史诗的规划。每个史诗运行一次,重跑会从被中断处继续同一草稿。
主要能力:编排 Planner 子智能体产出三类工件——product-spec.md(含 What/Why/Out of Scope/Constraints,交互式撰写)、roadmap.md(冲刺拆分与打包 split|bundled)、每个冲刺一个 tracker Issue(当 _config.yml.tracker != none 时)。完成后项目即可进入 /harness-loop。
前置条件:需先初始化 Harness(.harness/_config.yml 与 .harness/templates/product-spec.md 存在);须在 Git 仓库内;需 jq 可用(状态读写依赖 jq 解析 JSON);若 tracker 为 github 需先验证 gh auth status。若子智能体注册表异常,需完全退出 Claude Code 后用 claude --resume 重启仓库再重试。任一检查失败会停止,不做部分生成。
执行流程(10 步):步骤 1 检测已有史诗(继续/新建/取消);步骤 2 设定 kebab-case 史诗名;步骤 3 复制 product-spec 模板;步骤 3.5 运行 .harness/scripts/foundation-readiness.sh --epic <epic> 做 Foundation 就绪检查;步骤 4 交互式撰写 product-spec(唯一对话式 Planner 阶段);步骤 5 生成 roadmap.md;步骤 6 路线图审批;步骤 7 每个冲刺派发独立的 Planner 生成 contract.md(可并行),threshold 与 max_iterations 留 ? 占位,由 harness-loop 协商阶段填充;步骤 8 创建 tracker Issue;步骤 9 写入 _state.json 交接游标;步骤 10 输出汇总报告。
使用方式:作为技能调用,支持 --auto-approve-roadmap 标志自动批准路线图。语言依据显式覆盖或 CLAUDE.md 项目规定解析,不从不含机器文本推断;参考文件有 .md 与 .ja.md 版本。
限制:Planner 每个史诗最多 6 个冲刺(超出需拆分),打包上限 3 个冲刺,打包须附 bundling_reason 并引用 schema/auth/UI/contract 四个耦合轴之一。路线图审批最多重试 3 次。tracker 为 github 而缺少 gh CLI 时直接中止,不回退。相关用法与批准细节详见 references/usage-and-approval.md。