这个项目能做什么

Repo Agent Orchestration 是一个非官方的社区 Codex Skill（采用 MIT 许可），它将多智能体仓库交付规范保留在仓库本身而非中央服务中。其既定目标是在适当的上下文中完成仓库工作，并确保明确的所有权、比例验证和可恢复的移交。该项目明确指出，它不授予任何权限，不解锁任何产品功能，也不复制任何专有编排系统。 文档定义了三种所有权模式——直接（direct）、交付（delivery）和架构（architected）——这些模式是对决策所有者的描述，而非固定对话数量。指南涵盖了委派可分离的工作、在依赖就绪时继续工作而非轮询未变更状态、保持实现与评审判断独立，以及验证实际 Git 身份和排他性路径。内部写入者被描述为与其所有者共享树但具有不相交的作用域，而独立运行的 App 写入者则使用单独注册的仓库本地 worktrees。独立设计评审在用户或仓库明确要求，或存在重大跨领域或不可逆风险时是必需的。 安装通过源码检出执行，使用 scripts/install_repository.py 指向仓库路径。它将 Skill 复制到 .agents/skills/repo-agent-orchestration，并幂等地更新仓库根目录 AGENTS.md 中的标记块，同时保留该块之外的规则。--dry-run 标志用于预览写入，--check 用于在不修改目标的情况下检测已安装文件或配置文件的漂移。安装程序接受涵盖主分支、worktree 根目录、分支前缀、根 worktree 策略、任务主机策略、控制器模型策略、各角色模型设置、共享集成路径、连续性策略和外部门禁的选项。模型默认值为 app_default（省略模型和思考覆盖）；升级将保留现有的显式绑定，但一个已弃用的安装程序默认值将迁移回 app_default。 一个可选的结构化适配器支持在主机支持保存项目（saved-project）本地路由时显式请求的 App 任务。其构造函数和验证器处理八种数据包类型——binding、write、review、update、design_handoff、delivery_update、design_reopen 和 design_decision——并共享一个 schema。文档指出，适配器检查路径包含情况、saved-project 身份、当前 Git 分支和提交、只读评审及保留的报告设置，但不证明任务授权、实际交付、评审质量或接受度，且报告的 DELIVERY 字段是预期路由而非回执。 验证依赖于 Python 标准库的 unittest 发现机制、一个示例验证器和一个本地演示，CI 目标为 Python 3.11 和 3.13；安装程序和 worktree 测试需要 Git。演示程序创建临时 Git 仓库和隔离的写入者树，仅证明本地 Git 和合约检查，而非 App 创建、消息传递、有效模型或真实的智能体行为。对于断言无法证明的行为案例，提供了练习用例。清理指南要求对每个拥有的 worktree 和分支做出明确决定，仅通过 Git 的 worktree 流程删除经过验证的干净、已集成或明确放弃的残留物，并保留具有精确坐标的不安全或有用残留物；不包括基于时间的清理、强制删除可恢复工作、远程分支删除、后台守护进程或自动权限提升。布局将可安装的 Skill、安装程序、示例验证器、本地演示、行为输入、可选的桌面运行手册和确定性测试分开。