你在岔路口拍板，AI 接力跑完全程——带着一支会自我分工的多智能体团队，把软件从需求一路做到落地，全程留在你仓库里，永不失忆。
You decide at the turns; AI relays the rest — with a traceable team that never forgets.
PathRelay（中文名「AI协作交付系统」）是一套能装进任意代码仓的「人 + AI + 多 Agent」软件交付协作框架。
它不动你的业务代码，而是在仓库里铺一层协作骨架，把「人怎么和 AI 一起把软件做出来」变成可复现、可追溯、可恢复的工程资产：需求怎么被逼问清楚、方案怎么被选定、哪些东西被验过、当前走到哪一步——全都跟着代码进 git，不再活在某个再也找不回来的聊天窗口里。
你的角色也变了：不再是盯着 AI 一行行写、生怕它跑偏的监工，而是只在关键路口拍板的掌舵人。AI 带着一支会自我分工的多智能体团队替你跑全程，每到要紧的岔路口才回来找你：现在走到哪、下一步打算干嘛、为什么是这么一路走过来的。
我们做它的初衷只有一句：让「人 + AI 协作做软件」这件事，像严肃工程一样可靠、可追溯、可持续——人始终掌舵，AI 始终在轨道上奔跑。
| 能力 | 做什么 | 怎么实现 |
|---|---|---|
| 关键路口拍板，AI 自动跑全程 | 把模糊目标自动拆成分阶段路线、自动推进阶段内任务；每到阶段交接处主动告诉你「现在到哪、下一步干嘛、为什么这么走过来」，不用你盯流程、记进度 | 一个状态驱动的编排器自动推进各阶段，由下面两套门禁判断哪些节点必须停下来交给你拍板 |
| 覆盖完整生命周期 | 一路管到底——需求采集（苏格拉底式追问，把问题/目标/范围/验收/技术栈逼问清楚）→ 方案与路线 → 架构与接口 → 原型 → 开发 → 验收与落地 → 复盘 → 把缺陷回流去改进流程本身 | 需求到规格这一段基于 OpenSpec 实现，用它的 change 提案与可演进规格；阶段编排与跨阶段记忆借鉴 Trellis 的设计思想；各阶段串成一条交付链 |
| 自动分工的智能体团队 | 不让一个 AI 扛所有：按「什么模型擅长什么」把活派给不同子 Agent——Leader 拆解、Worker 查写改试跑、Verifier 挑反例审代码，上下文隔离、产物互审。用「分工 + 验证 + 汇总 + 可追溯」换可靠性 | 基于 Superpowers 实现，用它的子代理驱动开发（subagent-driven development）与产物评审；团队怎么分工、证据怎么汇总由编排层调度 |
| 内置多智能体协商 | 关键方案、高风险选型时，把同一个问题发给多个互相隔离、跨模型的 Agent 各自独立作答，裁判只比对不和稀泥，综合出一个比任何单一模型都更稳的答案，最后你拍板。专治「单模型自信满满地错」 | 同一问题并行分发给多个隔离的跨模型 Agent 独立作答，一个 Judge 只比对归纳、不合并，最后交人拍板 |
| 分级介入，顶配 AI 协同教研 | 按你的掌控目标决定 AI 跑多远、你看多细：从「只看结果」到「全面 review」，再到最高一档——AI 不只替你做完，而是分阶段把你教懂、反过来追问你、要你亲手复现，确保最后拍板和接手的是真正理解了的你 | 一套掌控门禁 L0–L3：从只看结果，到全面 review，到顶配的教学共创（分阶段讲解 + 追问 + 要你复现） |
| 风险自动定档，松紧机器说了算 | AI 按改动风险（从小修小补到不可逆高危）算安全等级，再与你设定的掌控档取较严的一个，机器判定该上多少人工复核、要不要多 Agent 介入。该松别折腾你，该严一个都不少 | 一套风险门禁 G0–G3 自动给改动定级，与你的掌控档取较严者（max(L,G)），机器判定介入强度 |
| 永不失忆，全程留痕 | 每个决策、每步证据、每次被打回、当前进度，全部落进仓库跟 git 走。换会话不用重新解释，换同事直接接手，换 AI 工具也读得懂 | 借鉴 Trellis 的设计思想：把规格、任务、进度、证据都落进 repo 跟 git 走，新会话从仓库读回上下文 |
| 规格驱动，门禁才是规则 | 需求先固化成可审查、可演进的规格再写代码；关键约束不靠口头君子协定，而是落成可机器判定的 check——文档只是提示，机器门禁才是规则 | 规格部分基于 OpenSpec 实现（先写可审查、可演进的规格再写代码）；关键约束落成 gates/ 下可机器判定的 check |
| 一行命令接入任意仓 | 装进你现有项目，不覆盖业务文件，支持升级 / 同步 / 冲突解决 / 回滚 / 干净卸载；统一支持 Claude Code、Codex / OpenAI Agent 及其它 AI 工具入口 | 一个接入器把协作骨架装进目标仓、不覆盖业务文件，支持同步 / 升级 / 冲突解决 / 回滚 / 卸载，并为各 AI 工具生成统一入口 |
复用现成、只在该补的地方补：记忆与阶段编排借鉴 Trellis 的设计思想，规格用 OpenSpec 实现，工程纪律与子代理分工用 Superpowers 实现；门禁（风险 × 掌控）、多智能体协商、AI 协同教研，以及把这一切串起来的整体编排，是 PathRelay 在这些之上补的部分。
最短路径：拉下来，验证环境，一条命令装进你的项目。
git clone https://github.com/zhimeng16/PathRelay.git
cd PathRelay
./scripts/verify.sh
HARNESS_LOADER_BOUNDARY=/path/to/sandbox \
python3 loader-package/tools/harness_loader.py install \
--target /path/to/your-project \
--package loader-package/packages/current更多子命令，以及装好之后你的仓库会多出什么
# 同步：把最新协作骨架同步进目标仓
python3 loader-package/tools/harness_loader.py sync --target /path/to/your-project --package loader-package/packages/current
# 升级：升级目标仓里已装的 PathRelay（带兼容检查）
python3 loader-package/tools/harness_loader.py update --target /path/to/your-project --package loader-package/packages/current
# 卸载：干净移除，不动业务文件
python3 loader-package/tools/harness_loader.py uninstall --target /path/to/your-project升级 / 同步全程不覆盖你的业务文件，支持冲突解决与回滚。装好之后，目标仓会多出：
CLAUDE.md/AGENTS.md/AI_AGENT_GUIDE.md—— 给不同 AI 工具读的统一入口PROJECT_STATE.md—— 当前走到哪一步，换会话、换人、换工具都靠它对齐openspec/—— 可审查、可演进的规格gates/—— 门禁定义（风险 × 掌控）records/·evidence/—— 决策与证据留痕，跟 git 一起进版本库
它们是更聪明的「单兵编辑器」，帮你把这一段代码写得更快；PathRelay 是「交付协作框架」，管的是从需求到落地的整条路怎么走、谁来把关、过程怎么不丢——而且把这套协作沉进你的仓库，不绑死在任何一个工具里。
- 协作过程是资产，不是聊天记录。 值钱的是「为什么这么做」，它必须进仓库、跟 git 走。
- 文档是提示，机器门禁才是规则。 口头君子协定靠不住，关键约束落成可机器判定的 check。
- 人在岔路口掌舵，AI 在直道上奔跑。 你只管拍板，跑全程交给会自我分工的团队。
- 复用现成，只在该补的地方补。 借得来的不重造，补上的是别人没有的内核。
PathRelay 正处于 0.x / early-preview。核心理念与主干能力已经成形，接口和细节仍在打磨；已有真实项目把它用在持续交付中，边用边反哺设计。我更看重「在真实场景里被验证过」，而非「功能列表多长」——所以演进会稳一些、扎实一些。
欢迎试用、提 issue、给反馈。如果它在对你有着正向的帮助，那它就走在对的路上了。
PathRelay · 让 AI 协作沉淀为工程资产，而不是蒸发在聊天记录里 · Experimental early-preview (0.x) · 详见 LICENSE / SECURITY / CONTRIBUTING