Odai 任务治理框架
让 AI Agent 基于证据规划并完成任务，同时守住授权与风险边界。
- 源仓库
- orziz/odai
- Star 数
- ★ 119
- 最近更新
- 1 天前
- License
- MIT
- 主语言
- JavaScript
- FA 评分
- 49/100 · 缺口较多
30 秒速览
- 运行形态
- 可在哪里用
- 通用 · 跨平台CodexClaude Code（部分支持）
- 费用
- 免费，无需付费服务
- 上手难度
- 低 · 几分钟可跑通
- 开始前需要
- 典型场景
- 需要在仓库中修改代码、同时要求先核实项目约定和验收条件的开发者。
- 不适合
- 需要由框架自动保证跨主机模型路由的团队
- 依赖旧版 DSH 历史会话自动迁移的用户
- 源码审查
- 49/100 · 缺口较多
这个 Agent 能做什么，适合哪些场景？
Odai 是一个通过 /odai 调用的通用任务执行与治理框架，主要以可安装 skill 的形式提供。它会结合用户目标、文件和项目上下文，判断任务所需的处理深度，再选择直接执行、加载专业能力或使用可选的主机路由。执行过程中，它根据任务风险与验收要求采取行动、核验结果，并持续推进到可交付状态。可选 DSH Plugin 和 Agent 软件包提供 DSH 集成及中文 Control Center，skill 本身也可独立安装。路由与 hooks 是可选功能；文档明确指出，skill 文本不能机械保证主机完成模型切换或委派。
用户安装 odai skill 后，以 /odai 加自然语言任务发起工作；不支持斜杠命令的客户端也可直接提及 odai。框架先检查目标、事实、缺口、授权、风险和验收条件，并在任务清晰、低风险时直接行动。它可读取文件与项目上下文，按需借用主机工具、项目规则或专业 skill；对复杂任务可保存可恢复状态，并在主机支持且配置了路由时获取有界的专业贡献。随后它整合证据、核验交付物并报告结果；可选 hooks 能依据项目 .odai/hooks.json 保护明确声明的只读路径，或运行声明的验收命令。
- 需要在仓库中修改代码、同时要求先核实项目约定和验收条件的开发者。
- 希望先审查当前 diff、只报告发现且不改文件的维护者。
- 要更新 README 或入门文案，并要求在行为变更前先给出方案与风险的产品团队。
- 在支持的主机上需要一次配置 Codex、Claude Code 或 GitHub Copilot CLI 的项目团队。
- 使用 DeepSeek Harness、希望通过独立 Plugin 或 Agent 预设接入治理能力的用户。
如何安装或部署这个 Agent？
独立安装核心 skill：
npx skills add https://github.com/orziz/odai --skill odai可选安装 DSH 集成软件包：
dsh plugin --profile web add odai-dsh-plugin
npx odai-dsh-agent installREADME 未说明核心 skill 需要单独的 API 密钥；所需模型和运行能力取决于宿主。DSH Plugin 命令要求 pnpm 已在 PATH 中。DSH 软件包的当前源码候选基线为 DSH 0.2.1-rc.2；插件包与 Agent 包可分别安装。
如何使用这个 Agent？
安装后在支持 skill 斜杠命令的客户端调用：
/odai update the onboarding flow copy.
Goal: make it clearer for first-time users.
Materials: current app files and README.
Constraints: do not change behavior yet; give me the proposed copy and risks first.若客户端没有斜杠命令，可用自然语言提及 odai 并说明任务。需要托管能力路由时，可在支持的主机中提出：
/odai install and verify capability routing for this project.安装路由需要确认；它会从主机能力目录配置角色。主机无法验证模型切换或委派时，Odai 会使用一个控制器继续可安全完成的工作，不会声称路由已执行。
这个 Agent 有哪些优点和局限？
- 任务深度会随复杂度、清晰度、风险和领域需求调整，低风险小任务可直接处理。
- 要求先利用文件、命令、日志、测试和项目上下文核实可验证信息，再决定是否询问用户。
- 明确区分 skill、可选主机路由与项目 hooks，hooks 可按项目策略检查只读路径和验收命令。
- 核心 skill 可独立安装；另有 DSH Plugin 与 Agent 两种集成方式。
- 实际模型路由取决于主机能力；skill 文本本身不能保证模型切换或委派。
- DSH Plugin 安装命令要求
pnpm，DSH 软件包当前源码候选要求 DSH0.2.1-rc.2或更高兼容版本。 - DSH 会拒绝含未知 Odai 事件的历史 v0 会话日志，文档不提供自动迁移。
- 项目 hooks 只检查结构化写入工具和声明命令，不解析普通 shell 写入，不能代替主机权限或沙箱。
这个 Agent 与同类方案有什么区别？
相比把每项工作都固定为完整流程，Odai 会按任务证据调整处理深度；相比单独安装可选主机路由，它无需路由也能用于普通任务。README 将 SDD、TDD、BDD、agents、consensus 和正式计划列为可选方法，而非强制工作流。
与相关度最高的同类 agent 并排比较关键指标。
| Agent | 源码审查 | 形态 / 费用 | Star | 最近更新 | 主语言 | 完整支持的平台 |
|---|---|---|---|---|---|---|
| Odai 任务治理框架 当前 | 49 · 缺口较多 | Agent 插件 / 技能免费 | ★ 119 | 1 天前 | JavaScript | Codex |
| Coven | 79 · 表现良好 | 命令行工具免费 | ★ 73 | 今天 | Rust | Codex · Claude Code |
| Spec Kit 多运行时技能集 | 51 · 缺口较多 | Agent 插件 / 技能 | ★ 151 | 1 天前 | Shell | Codex · Claude Code |
| Gas Town — 多智能体工作区管理器 | 49 · 缺口较多 | 命令行工具免费 + 模型费 | ★ 18k | 2 天前 | Go | Codex · Claude Code |
FollowAgents 如何评估这个 Agent？
查看各维度的扣分理由
README 明确声明只读引用默认、变更需授权、安装/卸载需确认、卸载按清单精确还原并保留无关设置，且 hook 守卫默认不启用，故 least_privilege、user_confirmation、external_effects、rollback 给 2。但数据流透明度仅停留在文字承诺，未见实际数据流向说明或日志；敏感数据处理（human-safety 本地记录）只有 README 描述，无代码佐证；依赖安全仅见 devDependencies 与 npm ci，无审计或锁定策略说明；来源归属仅提及 skills.sh 与 MIT 版权，未验证发布者身份，故这几项扣至 1。
README 对路由失败、认证/配额/网络失败仅影响当前回退、无法验证路由时不假装已路由等有明确描述，自洽性较好给 2。但依赖可用性仅靠 README 声明 DSH 基线版本与开放 peer，未见锁定或降级策略；失败消息的具体形态无代码证据，故各扣至 1。
受众与场景（轻任务直做、复杂任务升级、多宿主 Codex/Claude/Copilot）描述充分给 2；能力边界（只读引用、授权边界、不假装验证）清晰给 2。但触发精度依赖 /odai 或自然语言命名，缺少可机械判定的触发规则；环境适配仅覆盖部分宿主且明确承认 skill 文本无法保证路由，故各扣至 1。
信息架构（Internal Map 表、分层引用）与安装说明（多种 npx 安装、DSH 包、宠物安装）充分给 2；示例与已知限制（历史 v0 日志不迁移、旧布局仅迁移用）明确给 2；MIT 许可证完整给 2。但命名稳定性存在 odai/odai-orchestration/odai-cli/odai-dsh-plugin/odai-dsh-agent 多名称并存且分支 mini/old 并存，扣至 1；版本与变更仅引用 CHANGELOG 链接，正文未给版本历史，扣至 1；维护责任仅指向 MAINTAINING.md，发布者未经验证，扣至 1。
输出可用性有具体提示词示例与交付/验收导向，给 2。但边际价值主要是治理理念与流程约束，缺少可量化对比或基准证据；成本收益方面 economy 模式与 token 上限描述存在，但无实测数据支撑，故各扣至 1。
claim_traceability 方面 README 大量断言（隔离安装验证、共存验证）仅指向 dsh/README.md 与脚本名，未在给定文件中展示结果，扣至 1；cross_source_corroboration 仅 CI 工作流与 package.json 脚本名可部分对应，缺少测试输出佐证，扣至 1；fact_inference_separation 较好，README 明确区分已支持与未认证（如其他宿主不得声称等价路由证据），给 2。
- 发布者身份未经验证，安装前应自行核对来源与签名。
- README 中关于隔离安装验证、共存验证等断言仅指向其他文档与脚本名，未在给定文件中提供结果证据。
- 依赖安全与数据流透明度仅有文字承诺，缺少审计、锁定或日志层面的佐证。
- 触发依赖 /odai 或自然语言命名，缺少可机械判定的触发规则，宿主兼容性有限。