ship-roadmap

交付路线图（自动驾驶）

找到路线图后，运行由驱动器触发的循环（Claude /loop、外部驱动器或手动重新调用）：规划、实现、审查、为路线图中的每个单元创建一个 PR，并可选择合并。完成路线图后，检查现有 issue，交付应立即修复的工作，将剩余事项作为提案报告（绝不自动创建待办事项），并输出最终报告。使用高阶模型进行判断，使用低成本模型完成输入工作，并在人为干预代价高的决策点交由人类处理。

ship-roadmap 是循环的指挥者。它会输出原生固定格式的 SHIP: 横幅和结尾的 → Next: 区块；软件包自带的机器结果配置文件适用于驱动器在循环中调用的工作者和传感器技能。

轮次约定——结束轮次前先验证

✓ Exactly ONE stage advanced (or a terminal banner printed) and ONE line appended to the run log
✓ Nothing was merged outside the active --fullauto wrapper; direct merge
  commands remained blocked and no authorization survived the iteration
✓ Artifact language: explicit user instruction > the project's declared docs language > English. The CONVERSATION language never decides — a Spanish prompt still produces English PRs/issues/commits/SPECs unless one of the first two says otherwise
✓ The closing `→ Next:` block is printed as the ABSOLUTE last output

任何未勾选的框都表示该轮次尚未完成。

何时使用

适用于需要在合并和结束节点进行监督的已锁定路线图。对于单个功能、单个 bug 或探索性工作，请改用手动规划／执行流程。

步骤 0 — 发现项目（始终首先执行）

行动前请先阅读：CLAUDE.md/AGENTS.md 工作流约定、文档索引、docs/features/ROADMAP.md、修复索引、架构文档以及 .github/ 模板。然后确认：

1. **基础设施：**如果指南、索引、路线图和修复索引都已存在，则跳过奠基流程并确认其中的信息；否则，奠基流程会创建缺失的内容。
2. **技能：**验证 plan-feature、execute-phase、review-change 和 audit-pr 已安装，并记录其目录以用于工作者提示词。如果缺少任何一项，请停止并运行 npx skills add gtrabanco/agentic-workflow。使用 --fullauto 时，还要求 .agentic-workflow/hooks/fullauto-merge.sh 可执行且包含其平台守卫；否则转到 init-workspace，绝不直接合并。
3. **运行：**已有 docs/features/SHIP_DECISIONS.md 或存在未关闭的 docs/ship-founding PR 时，使用 --continue 恢复；直接调用时应报告状态，而不是再次运行奠基流程。
4. **形态：**确认项目是全新还是已有、当前分支以及工作区是否干净；如果默认分支有无法解释的未提交更改，则停止（绝不悄悄清理）。

渐进式加载——选择调用路线

允许列表仅包含下面链接的路径。切勿自行编造其他引用。 每条路线都以 guardrails 开始，然后仅加载 与其匹配的行：

**关于 AUDIT 阶段 --continue 的硬性规则：**严格按以下顺序加载： references/GUARDRAILS.md、references/RECOVERY_AND_SELECTION.md、 references/STOP_CONDITIONS.md、references/ADVANCE.md、 references/MODEL_ROUTING.md 和 references/AUDIT_AND_MERGE.md；阶段结束后，加载 references/CLOSEOUT_AND_LOG.md。当运行未处于终止状态且所有指定的 原语都存在时，本轮禁止加载其他任何引用。

当前条件	按此顺序加载完整路线	此时跳过
查找或检查一次运行，未使用 --continue（默认模式或全新项目的 --fullauto）	guardrails → founding	recovery、stop conditions、advance、model routing、audit/merge、terminal report、portability
使用 --fullauto 对现有仓库进行初始化	guardrails → founding → audit and merge policy	recovery、stop conditions、advance、model routing、terminal report、portability
继续一次非 AUDIT 迭代	guardrails → recovery and selection → stop conditions → advance → 阶段执行前加载 model routing → 阶段执行后加载 closeout and log	founding、audit/merge、terminal report、portability
继续一次 AUDIT/全自动迭代	guardrails → recovery and selection → stop conditions → advance → model routing → AUDIT 阶段开始前加载 audit and merge policy → 阶段执行后加载 closeout and log	founding、terminal report、portability
终止后停止/报告	先加载上方对应行，再加载 terminal report	无关行
缺少某个具名平台原语	先加载上方对应行，再加载 portability	无关行

终止状态出现前，不要加载终止报告；所有原语都存在时，不要加载可移植性内容。每个阶段开始前都要加载模型路由；每个 AUDIT 阶段开始前都要加载 audit/merge，包括非 --fullauto 运行。

所选资源与本文件仅相隔一跳。固定横幅、过渡内容、底线检查和输出块均为规范性要求；若无法读取必需资源，则停止运行——绝不要根据旧运行自行发挥。

可移植性

此工作流与驱动程序无关。仅当某个原语不可用时，才使用 portability 中的精确回退方案；保持阶段顺序和安全底线不变。

与其他技能的关系

关系	技能/策略
组合（同级/低级）	init-workspace；即时调用 design-feature + plan-feature-scaffold；plan-feature；审查→整合手动流程（/review-change → 若为 REVIEW-FAIL，则运行 /fold-findings → 重新运行 /review-change）；仅给出判定的 audit-pr；audit-docs。
低成本工作线程	execute-phase（全新上下文/阶段）、机械式整合、审计阻塞项修复；使用经过验证的工作线程模型。
人工交接	默认合并、product-audit（更高投入），以及通过 triage-issue 处理的问题报告批次。
同级技能	workflow-status 提供严格的传感器结果；工作线程技能使用由包定义的输出配置，而指挥者保留其原生的 SHIP: 轮次约定。

按功能逐项手动执行的流程仍是默认方式；此技能将其封装起来，并在流程两端保留人工参与。

完成条件

• 存在终端横幅和最终报告，且有一个开放的 PR；路线图状态均为真；每个 PR 均已合并、处于开放／已审计状态，或已说明原因并搁置。SHIP: COMPLETE 还需涵盖问题清查，并将剩余事项报告为提案。
• 锁定的答案、迭代证据、结果和建议均可在 SHIP_DECISIONS.md、运行日志和报告中追溯；报告需明确列出接下来由人工执行的操作（合并、分流、提案、产品审计时间安排）。