用途:Pipeline 是一个模块化开发流水线编排器,按 triage → align → execute 三个前进式阶段组织开发流程,每个阶段逐步收窄范围,直到约束契约足够明确、可自动执行。可通过 /pipeline、pipeline init、pipeline resume、pipeline status 触发。
主要能力:阶段只前进不重复;state.json 是轻量缓存投影(<2KB),events.ndjson 是权威追加式账本;路径均为仓库根相对路径,不存绝对路径;编排器拥有 .pipeline/ 状态,manage-codex 拥有 relay 子状态。triage 为交互阶段探索问题空间;align 为交互阶段,产出受门禁检查的 execution-spec.md、constraints.json、verification-plan.md;准备就绪门禁检查 constraints.json 合法、allowed_paths 非空且无通配符、interface_changes 存在、verification_commands 非空、non_goals 非空、open_questions 为空,失败则阻止 execute,需新增 align 阶段补齐。
使用方式:初始化执行 ./scripts/pipeline/update-pipeline.sh --event init_pipeline --mission-id <id>;查看状态可 cat .pipeline/state.json;各阶段用 phase_added、phase_started、phase_completed 等事件推进;execute 阶段以显式 --root 指向 relay 目录分发 manage-codex,并用 child_checkpoint 监控。
适用场景:需要分阶段收敛需求、以产物与门禁约束自动执行的开发流程管理。限制:门禁不可用文字绕过;适配器状态陈旧(>30 分钟且非终态)、锁定阶段产物漂移或 automatic_resume.blocked 为真时须上报用户;在 adapter-lock.json 存在且非终态时不得分发新子工作流。其它细节暂未提供。