tokentopo-ai/dsh-octo

dsh-octo

英语 | 简体中文

先决条件 ·
安装 ·
功能简介 ·
工作原理 ·
文档 ·
许可证

Deepseek Harness（dsh）通过其内置的子代理后端，原生支持以无头方式调用 Claude Code 和 Codex
作为子代理，而这些子代理可以复用本地账户的登录状态以及账户自带的编程套餐。例如，如果你拥有
Claude Code Max 套餐，就可以让 dsh 调用 Fable-5 作为子代理。

受此启发，我专门为 dsh 设计了这个技能，秉持以下理念：

- 尽可能使用内置能力，以实现对异构子代理最无缝的调用。
- 让 dsh 意识到它可以调用子代理，从而将多个代理聚合为更强大的智能。
- 为不同阶段——如规划、编码和验收——设计专门的多代理工作流，以实现高质量协作。

先决条件

- dsh 0.1.0-rc.6。
- 为主 dsh 模型配置了 deepseek-official 提供方。
- dsh plugin 可用的 Node.js、npm 和 pnpm 环境。
- 已在本地安装并登录 Claude Code 和 Codex，且相应账户拥有有效的编程套餐订阅。

安装

dsh-octo 目前面向 dsh 0.1.0-rc.6。请从本地 tarball 安装，以便 dsh 能够解析该 bundle
及其所有依赖：

git clone https://github.com/tokentopo-ai/dsh-octo.git
cd dsh-octo
npm pack
dsh plugin --profile web add ./dsh-octo-0.1.0.tgz

将 web 替换为你使用的 profile，然后重启它。

安装完成后，像往常一样使用 dsh：用普通对话描述你的任务即可。无需触发词、子代理选择或分阶段
命令。该技能仅在有用时才会启动多代理协作。

功能简介

dsh-octo 是一份纯提示词编排契约，而非编排引擎：它不附带工作流运行时，也不依赖 ultracode
或 dsh Dynamic Workflow 能力。该 bundle 仅安装依赖、注册技能并启用委派工具；所有路由和阶段
决策都由主代理在遵循技能书面指令的过程中做出。

它只会为真正需要多阶段协作的任务激活自身：

- 激活——需要规划 → 编码 → 审查流水线（可选实验）的任务，或能从比较多个方案或独立审查
环节中获益的任务。
- 不介入——单点修复、直接问答，以及不需要设计决策的小改动。这些任务继续走主代理的常规
路径，没有任何额外开销。
当它确实激活时，主智能体会将任务委派给一个固定的官方 dsh 子智能体后端池，每个阶段一个：

| 智能体 | 组成 | 委派工具 |
| --- | --- | --- |
| fable | Claude Code + Fable (xhigh) | subagent_claude_code |
| gpt-5.6-sol | Codex + gpt-5.6-sol (xhigh) | subagent_codex |
| deepseek-v4-pro | DSH 子进程 + deepseek-v4-pro | subagent_deepseek_v4_pro |
| deepseek-v4-flash | DSH 子进程 + deepseek-v4-flash | subagent_deepseek_v4_flash |

一次典型的运行会经历以下流程：

1. 规划 — fable 起草一份初始计划；四个 deepseek-v4-pro 子智能体从不同角度（架构、实现路径、风险/测试、资源）并行地再次起草；deepseek-v4-flash 将全部五份综合成最终计划。
2. 编码 — 对于 Git 项目，四个 deepseek-v4-pro 子智能体在隔离的 git worktree 中并行实现该计划；gpt-5.6-sol 读取全部四份实现和差异，然后将它们合并为主工作树中的最终变更。
3. 审查 — gpt-5.6-sol 对照原始任务（而不仅仅是对照计划）检查实现，运行测试，修复发现的任何缺陷，并在签署确认前用可执行命令验证每一项“已修复/已更改”的声明。
4. 实验（仅在需要时）— 主智能体自行运行实验，并将结果交给 fable 进行分析。

智能体之间的每一次交接都会写入 artifacts/（input/、plan/、impl/、review/、experiments/）下的文件，而不是通过共享的对话上下文传递，因为异构智能体之间并不共享上下文。如果某个子智能体不可用、超时或被拒绝，主智能体会自行接管该步骤，而不是阻塞任务，并且交接记录会记录这一点，以便事后协作过程仍可审查。

工作原理

dsh-octo 作为静态 Cordis 包安装：一个打包的技能提供者，加上官方 codex 和 claude-code 产品提供者及其四个 subagent_* 工具，直接添加到所选的 dsh 配置文件中。从 tarball 安装（而不是通过 dsh plugin add . 或普通的 Git checkout）在这里很重要——正是它使包的 files 允许列表保持生效，因此只有 index.js、cordis.patch.yml、SKILL.md、assets/、docs/ 和各个 README 会作为技能的资源基础暴露出来，而本仓库的任何私有开发材料（artifacts/、AGENTS.md、local_docs/）都不会泄漏进去。完整的安装/迁移/回滚流程请参见部署。

认证信息绝不会被复制到本项目：Claude Code 和 Codex 继续使用它们各自的本地登录状态和编码套餐权益，dsh-octo 只调用已经拥有该认证的官方后端。

文档

以下文档随包一起发布，涵盖安装、委派契约以及本 README 之外的操作细节：
- 部署 — 安装捆绑包、清理旧配置、验证与回滚。
- Agent 调用手册 — 委托工具契约、提示词结构、并行性与重试策略。
- 产物交接 — 目录布局、命名，以及 agent 之间的最小读取/工作树边界。
- 配置与密钥 — 凭据来源、模型路由，以及 CLI 回退的边界。
- 验收清单 — 安装、工作流、安全与清理检查。

许可证

本项目目前以 UNLICENSED 分发；未授予任何开源许可证。