pipeline-router

Pipeline Router

路由是一项承诺：根据目标产物和证据方法选择一个工作流，记录该选择，并呈现下一个人工决策。

输入

• GOAL.md；如果工作区是新建的，则使用当前用户请求。
• 如存在，则读取现有的 PIPELINE.lock.md、UNITS.csv、STATUS.md 和 DECISIONS.md。
• 选择时读取 docs/PIPELINE_TAXONOMY.md 和候选 Pipeline 的 front matter。

输出

• 为新绑定的目标生成 PIPELINE.lock.md。
• 在 DECISIONS.md 中生成初始 C0 检查点区块。
• 如果所选检索工作流从 C0 开始，则生成 queries.md。
• 在 STATUS.md 中同步当前 Pipeline／检查点投影。

步骤

1. 确定所请求的产物

阅读目标，并确定：

• 面向读者的交付物；
• 所需的证据方法；
• 所请求的格式或交付配置；
• 会实质性影响工作流选择的决策。

如果缺少路由判定信息，请在 DECISIONS.md 中写入最精简的分组问题集，并停在该决策处。

完成标准：所有可能影响工作流选择的信息均已明确，或已在 DECISIONS.md 中明确界定范围。

2. 选择一个工作流

加载 docs/PIPELINE_TAXONOMY.md，然后仅检查候选 Pipeline 合约。应根据目标产物和证据方法进行选择，而非仅匹配关键词。将交付配置和课程报告用例视为现有工作流系列中的覆盖层。

完成标准：恰好选定一个可执行 Pipeline，且其目标产物与目标一致。

3. 落实承诺

写入 PIPELINE.lock.md，内容如下：

pipeline: <pipeline path>
units_template: <template path from Pipeline front matter>
locked_at: <YYYY-MM-DD>

如果工作区是新建的，请根据该模板初始化 UNITS.csv。保留有效的现有锁定；路线变更必须是操作员明确作出的决策，并随后重新初始化或迁移，绝不能静默改写。

完成标准：锁定文件、Unit 模板和工作区投影均指向同一个 Pipeline。

4. 呈现 C0 检查点

在 DECISIONS.md 中生成 C0 启动区块和审批复选框。如果检索属于所选工作流的一部分，则根据目标填充 queries.md。后续检查点使用 checkpoint-brief。对于保存的 Unit 在 C0 之后仍调用 pipeline-router 的历史工作区，应将其交由 checkpoint-brief 处理，并发出弃用警告；路由器绝不会批准它们。

选择完成后，可以使用确定性辅助工具：

uv run python .codex/skills/pipeline-router/scripts/run.py \
  --workspace workspaces/<name> \
  --checkpoint C0

完成标准：DECISIONS.md 包含 C0 检查点以及一个清晰的审批或答复界面；检索工作流包含非空的 C0 查询种子。

5. 验证路线

检查已锁定的 Pipeline 是否存在、其 Unit 模板是否存在，以及当前检查点是否同时体现在 STATUS.md 和 DECISIONS.md 中。

完成标准：Pipeline Runner 无需再次推断路由，即可根据工作区文件继续执行。

上下文指引

• 仅在选择或有意更改工作流时阅读 docs/PIPELINE_TAXONOMY.md。
• 选择后，已锁定的 pipelines/*.pipeline.md 是执行合约，分类体系不再提供上下文。
• 仅当缺少路由信息、需要人工回答时，才使用 assets/pipeline-selection-form.md。
• 如果需要调试 C0 生成过程，请使用 --help 运行辅助工具；该工具会记录初始路线投影，但不会替你选择路线。