{"id":"f710f9f4-8db7-42be-b64c-6f130773d5b3","slug":"dsh-claude-octopus","kind":"skill","name":"dsh-claude-octopus","summary":"multi-agent 编排（移植自 claude-octopus）","owner":"GongYuanCaiJi","repoUrl":"https://github.com/GongYuanCaiJi/dsh-claude-octopus","license":"MIT","licenseTier":"permissive","trust":"community","stars":0,"match":null,"fewStars":true,"format":"skill","createdAt":"2026-08-15T13:24:03.000Z","addedAt":"2026-10-22T03:27:57.719Z","logoUrl":"https://avatars.githubusercontent.com/u/129952120?v=4","linkOnly":false,"collection":null,"skillPath":null,"categories":["writing"],"tags":["deepseek-harness","dsh","dsh-plugin"],"runtime":"binary","local":true,"cloudCapable":false,"cloudCapability":"unknown","cloudReadyOnPlatform":false,"needsApiKey":false,"reviewed":false,"syncedAt":"2026-10-22T19:55:12.935Z","sample":false,"url":"https://conduits.dev/tools/dsh-claude-octopus","language":"Shell","transports":["stdio"],"install":{},"requirements":{"env":[],"upstreamMayCharge":false},"tools":null,"readme":"# 🐙 dsh-claude-octopus\n\n简体中文 | [English](#english)\n\n[![License](https://img.shields.io/badge/license-MIT-blue.svg)](./LICENSE)\n[![DSH](https://img.shields.io/badge/DSH-DeepSeek%20Harness-blue.svg)](https://github.com/deepseek-ai/deepseek-harness)\n[![Version](https://img.shields.io/badge/Version-9.64.0-blue)](https://github.com/nyldn/claude-octopus)\n[![上游](https://img.shields.io/badge/移植自-claude--octopus-orange.svg)](https://github.com/nyldn/claude-octopus)\n\n> **一句话：一个 `/octo` 命令，让多个 AI 模型（Codex、Antigravity、Copilot、Qwen、Ollama、OpenRouter、Grok 等）一起研究、开发、评审、辩论，达成共识再交付。**\n\n移植自 [`nyldn/claude-octopus`](https://github.com/nyldn/claude-octopus)（MIT，v9.64.0），\n上游的编排引擎（`scripts/orchestrate.sh` 与全部 skills / commands / agents / hooks）逐字保留，\n只适配 [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) 的插件接缝。\n\n## ✨ 功能\n\n- 🐙 **多模型编排** —— Codex / Antigravity / Copilot / Qwen / Ollama / Perplexity / OpenRouter / OrcaRouter / OpenCode / Grok 十种外部 provider，外加宿主本身\n- 🗳️ **共识门禁** —— 多模型意见分歧时用 75% 共识阈值挡在交付前\n- 🧠 **跨会话记忆** —— 整合 claude-mem / agentmemory，决策与研究跨 session 存活\n- ⚡ **Dark Factory** —— 给一份 spec，自动跑完 research → define → develop → deliver 全流程\n- 🔄 **四阶段方法论** —— Discover → Define → Develop → Deliver，阶段之间有质量闸\n- 👥 **32 个专业 persona + 54 条命令 + 63 个 skill** —— 显式工作流才激活，普通请求不受影响\n- 🔌 **dsh 原生接缝** —— `/octo` 命令走 `ctx.shell`；多 agent 派发走 dsh 内建的 `ctx.subagents`（注册 `octopus` provider）\n\n> 💬 `/octo debate`（AI Debate Hub）集成自 [wolverin0/claude-skills](https://github.com/wolverin0/claude-skills)（MIT），与上游一致保留署名。\n\n## 📸 效果\n\n```text\n> /octo research \"GraphQL vs REST 的设计权衡\"\n\n🐙 Octopus Research\n  probe codex         → 并行探索（多 provider）\n  probe agy           → 每个 provider 一个独立视角\n  probe claude        → ...\n  共识门禁 75%        → 分歧点显式列出\n  → 结构化研究报告（executive summary / themes / takeaways / sources）\n```\n\n## 📦 安装\n\n```bash\ndsh plugin --profile <你的 profile> add github:GongYuanCaiJi/dsh-claude-octopus\n```\n\n安装时 `prepare` 会自动构建 `dist/`。若 pnpm 拦下构建步骤，把本包加进 profile 的\n`pnpm-workspace.yaml` 的 `allowBuilds`。\n\n从本地目录安装（需要先自行构建）：\n\n```bash\ngit clone https://github.com/GongYuanCaiJi/dsh-claude-octopus.git\ncd dsh-claude-octopus && npm install        # 触发 prepare，产出 dist/\ndsh plugin --profile <你的 profile> add ../dsh-claude-octopus\n```\n\n> 本包尚未发布到 npm，所以不提供裸名安装。\n\n> 已有访问权限时，四种 provider 不额外花钱：🧭 Antigravity CLI（`agy`）、Codex、Copilot\n> 走既有订阅或本地认证，Ollama 本地免费跑。零外部 provider 也能用 —— 宿主本身就是一个座位。\n\n## 🚀 用法\n\n```text\n/octo help                        # 全部子命令\n/octo research \"topic\"            # 多 provider 并行研究\n/octo develop \"task\"              # 带验证的实现\n/octo council --goal decision \"?\" # 3/5/7 persona 结构化合议\n/octo debate \"question\"           # 多模型辩论\n/octo embrace \"spec\"              # 完整四阶段工作流\n/octo doctor                      # 环境诊断\n```\n\n外部 provider CLI（codex、agy、qwen …）按需安装，`/octo doctor` 会告诉你缺什么。\n零外部 provider 也能用 —— 宿主本身就是一个座位。\n\n<details>\n<summary>移植说明（对上游 <code>nyldn/claude-octopus@5d7ac6b6</code>）</summary>\n\n**逐字保留**：`scripts/`、`commands/`、`skills/`、`agents/`、`hooks/`、`config/`、\n`docs/`、`mcp-server/`、`openclaw/` 等 1169 个上游文件逐字未改（上游共 1174 个；\n`README.md`、`package.json`、`LICENSE`、`.gitignore` 为移植自有版本，\n`tests/unit/test-github-work-queue-hook.sh` 为已申明的适配），`cmp` 可验\n（[THIRD_PARTY_NOTICES.md](./THIRD_PARTY_NOTICES.md) 钉住了上游 commit 与逐字文件 SHA-256）。\n\n**新增的只有 dsh 接缝**（上游没有对应物）：\n- `src/shell.ts` —— `ctx.shell` 转接层，显式处置 dsh 的 truncated / timedOut / sandbox.denied / invocation.signal 四个信号\n- `src/commands.ts` —— `/octo <subcommand>` 命令，转发到 `scripts/orchestrate.sh`\n- `src/subagents.ts` —— 向 `ctx.subagents` 注册 `octopus` provider，把 dsh 内建的 subagent 派发接到上游 `probe-single` 引擎\n- `package.json` / `cordis.patch.yml` —— dsh 插件装载\n\n**已知限制**：上游文案是英文 —— 那是上游原文，逐字保留未做翻译。\n</details>\n\n## 🛠 开发\n\n```bash\nnpm install      # 触发 prepare，产出 dist/\nnpm test         # 构建 + adapter 单元测试 + 上游完整测试套件（smoke + unit）\n```\n\n上游测试套件里包含在临时 git 仓库中直接提交 `main` 的用例；若你的机器有\n「禁止直推 main」类 git hook，`npm test` 已用 `GIT_CONFIG_COUNT` 环境变量把\n`safetyfuse.allowStable` 只作用在测试进程内，不碰任何仓库配置。\n\n## 📄 License\n\nMIT。上游 [`nyldn/claude-octopus`](https://github.com/nyldn/claude-octopus)\n`Copyright (c) 2026 nyldn`，本移植 `Copyright (c) 2026 GongYuanCaiJi (dsh port)`。\n见 [LICENSE](./LICENSE)。\n\n感谢 [nyldn](https://github.com/nyldn) 的原作 —— 如果这个插件对你有用，\n**也请去给[上游仓库](https://github.com/nyldn/claude-octopus)点个 star**。\n\n---\n\n<a id=\"english\"></a>\n\n# Claude Octopus (dsh port)\n\n[![License](https://img.shields.io/badge/license-MIT-blue.svg)](./LICENSE)\n[![DSH](https://img.shields.io/badge/DSH-DeepSeek%20Harness-blue.svg)](https://github.com/deepseek-ai/deepseek-harness)\n[![Version](https://img.shields.io/badge/Version-9.64.0-blue)](https://github.com/nyldn/claude-octopus)\n[![Claude Code](https://img.shields.io/badge/Claude_Code-v2.1.14+_required-blueviolet)](https://code.claude.com/docs/en/overview)\n\nEvery AI model has blind spots. Claude Octopus supports ten external provider integrations — Codex, Antigravity CLI, Copilot, Qwen, Ollama, Perplexity, OpenRouter, OrcaRouter, OpenCode, and Grok — alongside the built-in Claude Code host, with consensus gates that flag disagreements before you ship.\n\nClaude Code **v2.1.14+** is the minimum supported runtime; the plugin tracks 182 Claude Code capability flags through Claude Code v2.1.219.\n\n> **One line: one `/octo` command, and multiple AI models (Codex, Antigravity, Copilot, Qwen, Ollama, OpenRouter, Grok, …) research, build, review and debate together — with a consensus gate before delivery.**\n\nA port of [`nyldn/claude-octopus`](https://github.com/nyldn/claude-octopus) (MIT, v9.64.0) to\n[DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness). The upstream orchestration\nengine (`scripts/orchestrate.sh` and every skill/command/agent/hook) is kept byte-identical;\nonly the dsh plugin seams are adapted.\n\n## ✨ Features\n\n- 🐙 **Multi-model orchestration** — Codex / Antigravity / Copilot / Qwen / Ollama / Perplexity / OpenRouter / OrcaRouter / OpenCode / Grok plus the host seat\n- 🗳️ **Consensus gates** — a 75% consensus threshold flags disagreements before they ship\n- 🧠 **Cross-session memory** — integrates [claude-mem](https://github.com/thedotmack/claude-mem) and [agentmemory](https://github.com/rohitg00/agentmemory)\n- ⚡ **Dark Factory** — spec in, autonomous research → define → develop → deliver\n- 🔄 **Four-phase methodology** — Discover → Define → Develop → Deliver with quality gates\n- 👥 **32 personas, 54 commands, 63 skills** — explicit workflows only; ordinary requests stay untouched\n- 🔌 **Native dsh seams** — `/octo` runs through `ctx.shell`; multi-agent dispatch registers an `octopus` provider into dsh's built-in `ctx.subagents`\n\n> 💬 `/octo debate` (AI Debate Hub) integrates [wolverin0/claude-skills](https://github.com/wolverin0/claude-skills) (MIT), attribution kept identical to upstream.\n\n## 📸 Demo\n\n```text\n> /octo research \"GraphQL vs REST design trade-offs\"\n\n🐙 Octopus Research\n  probe codex         → parallel exploration (multiple providers)\n  probe agy           → one independent perspective per provider\n  probe claude        → ...\n  consensus gate 75%  → disagreements listed explicitly\n  → structured research report (summary / themes / takeaways / sources)\n```\n\n## What's New\n\n<!-- BEGIN CURRENT RELEASE -->\n> 🆕 **v9.64.0 — Keep Octopus dormant until explicitly invoked.**\n>\n> **Default roster:** Claude Opus 5 leads architecture, planning, security reasoning, and final judgment; GPT-5.6 Sol is the independent implementation/review peer; Claude Sonnet 5 is the standard Claude seat; Fable 5 remains an opt-in judgment escalation. Existing model pins and provider configuration still win. See [the routing strategy](docs/MODEL-ROUTING-STRATEGY.md).\n<!-- END CURRENT RELEASE -->\n\n| Version | Best Features |\n|---------|--------------|\n| **v9.64.0** (new) | Keep Octopus dormant until explicitly invoked. |\n| **v9.50** | Claude Code 2026 compatibility layer — routines manifest, SubagentStop gate, `/octo:usage` cost attribution, Claude Agent SDK seat. |\n| **v9** | Up to 10 external provider integrations, structured provider debates, configurable multi-LLM councils. |\n\n[Full changelog →](CHANGELOG.md)\n\n<details>\n<summary>Upgrading to 9.5x</summary>\n\n<!-- BEGIN CURRENT MODEL DEFAULTS -->\n- Current fresh configurations use **GPT-5.6 Sol** for Codex implementation/review, **Claude Opus 5** for premium Claude work, and **Claude Sonnet 5** for the standard Claude seat. Existing environment, session, and `providers.json` pins remain unchanged; `OCTOPUS_LEGACY_ROLES=1` restores the pre-frontier role mapping.\n<!-- END CURRENT MODEL DEFAULTS -->\n- Premium Claude role routing (architect, strategist, security-reviewer to Opus) landed in v9.29; restore the older mapping with `OCTOPUS_LEGACY_ROLES=1`.\n\n</details>\n\n## Claude Code Web and Remote Sessions\n\nWhen an explicit Octopus workflow is running in a hosted, web, or remote-control\nenvironment, set `OCTOPUS_REMOTE_SESSION=true` in that environment. Once a\nworkflow starts, `orchestrate.sh` also recognizes `CLAUDE_CODE_REMOTE=true` or\n`CLAUDE_CODE_WEB=true` and applies unattended-safe runtime defaults: autonomy is\nset to `autonomous`, provider smoke tests are skipped, and the statusline uses a\nlightweight remote-safe display.\n\n## Quickstart\n\n```bash\ndsh plugin --profile <your-profile> add github:GongYuanCaiJi/dsh-claude-octopus\n# then, inside a dsh session:\n/octo research \"topic\"\n```\n\nFour providers cost nothing extra when you already have access: 🧭 Antigravity CLI (`agy`),\nCodex, and Copilot use existing subscriptions or local auth; Ollama runs locally for free.\nZero external providers works too — the host is a seat.\n\n## 54 Commands That Matter Most\n\nThe full surface is `scripts/orchestrate.sh` (all subcommands under `/octo help`). The\nworkflows that matter most:\n\n```text\n/octo research \"topic\"            # multi-provider parallel research\n/octo develop \"task\"              # implementation with validation\n/octo embrace \"spec\"              # full four-phase workflow\n/octo council --goal decision \"?\" # 3/5/7-persona structured deliberation\n/octo debate \"question\"           # multi-model debate\n/octo doctor                      # environment diagnostics\n```\n\n## How It Works\n\nOctopus stays dormant until you explicitly run `/octo:*`. Each command dispatches through\nthe upstream `scripts/orchestrate.sh` engine, which probes the configured provider CLIs\nwith role-specific personas, applies quality gates between the Discover → Define →\nDevelop → Deliver phases, and synthesizes a consensus result. In dsh, the single-agent\nprobe is exposed as the `octopus` provider in `ctx.subagents`.\n\n| Provider | Integration |\n|----------|-------------|\n| Codex | `codex` CLI |\n| Antigravity | `agy` CLI |\n| Copilot | GitHub Copilot CLI |\n| Qwen | Qwen Code CLI |\n| Ollama | local |\n| Perplexity | API key |\n| OpenRouter | API key |\n| OrcaRouter | API key |\n| OpenCode | OpenCode CLI |\n| Grok | xAI API key |\n\n## Cost & Provider Pricing\n\nFour providers cost nothing extra when you already have access: 🧭 Antigravity CLI (`agy`),\nCodex, and Copilot use existing subscriptions or local auth; Ollama runs locally for free.\nQwen now requires API-key or Coding-Plan auth.\n\n- [OpenAI model pricing](https://developers.openai.com/api/docs/models/gpt-5.6-sol) — GPT-5.6 Sol on Codex implementation/review seats\n- [Perplexity pricing](https://docs.perplexity.ai/docs/getting-started/pricing) — per-request fee applies\n- Antigravity seats bill nothing extra beyond your existing plan\n- Long-context and provider-specific rate rules apply per provider; `/octo:cost` reports usage attribution\n\n## Documentation\n\n- [`docs/`](./docs/) — full command reference, architecture, and workflows (upstream, verbatim)\n- [`CLAUDE.md`](./CLAUDE.md) — the plugin's own development guide (upstream, verbatim)\n- [Upstream docs](https://github.com/nyldn/claude-octopus/tree/main/docs)\n\n## 📦 Install\n\n```bash\ndsh plugin --profile <your-profile> add github:GongYuanCaiJi/dsh-claude-octopus\n```\n\nThe `prepare` script builds `dist/` during installation. If pnpm blocks the build\nstep, add this package to `allowBuilds` in the profile's `pnpm-workspace.yaml`.\n\nFrom a local checkout (build it first):\n\n```bash\ngit clone https://github.com/GongYuanCaiJi/dsh-claude-octopus.git\ncd dsh-claude-octopus && npm install        # runs prepare, produces dist/\ndsh plugin --profile <your-profile> add ../dsh-claude-octopus\n```\n\n> Not published to npm yet, so no bare-name install.\n\n## 🚀 Usage\n\n```text\n/octo help                        # all subcommands\n/octo research \"topic\"            # multi-provider parallel research\n/octo develop \"task\"              # implementation with validation\n/octo council --goal decision \"?\" # 3/5/7-persona structured deliberation\n/octo debate \"question\"           # multi-model debate\n/octo embrace \"spec\"              # full four-phase workflow\n/octo doctor                      # environment diagnostics\n```\n\nInstall external provider CLIs (codex, agy, qwen …) as needed; `/octo doctor` shows\nwhat's missing.\n\n<details>\n<summary>Port notes (vs upstream <code>nyldn/claude-octopus@5d7ac6b6</code>)</summary>\n\n**Kept verbatim**: 1169 of the upstream tree's 1174 files — `scripts/`, `commands/`,\n`skills/`, `agents/`, `hooks/`, `config/`, `docs/`, `mcp-server/`, `openclaw/` —\nbyte-identical (`README.md`/`package.json`/`LICENSE`/`.gitignore` are the port's own\nreplacements; `tests/unit/test-github-work-queue-hook.sh` is a documented adaptation),\nverifiable with `cmp` ([THIRD_PARTY_NOTICES.md](./THIRD_PARTY_NOTICES.md) pins the\nupstream commit and per-file SHA-256).\n\n**Added (no upstream counterpart)**: the dsh seam layer —\n`src/shell.ts` (`ctx.shell` adapter with explicit truncated/timedOut/sandbox.denied/\ninvocation.signal handling), `src/commands.ts` (`/octo` → `scripts/orchestrate.sh`),\n`src/subagents.ts` (registers the `octopus` provider into `ctx.subagents`, wiring\ndsh's built-in subagent dispatch to the upstream `probe-single` engine), and the\n`package.json` / `cordis.patch.yml` plugin mounting.\n\n**Known limitation**: upstream copy is English — it is the upstream original, kept\nuntranslated.\n</details>\n\n## 🛠 Development\n\n```bash\nnpm install      # runs prepare, produces dist/\nnpm test         # build + adapter unit tests + full upstream suite (smoke + unit)\n```\n\nThe upstream suite includes cases that commit directly to `main` inside disposable\ntemp repos; if your machine has a \"no direct main commits\" git hook, `npm test`\nscopes `safetyfuse.allowStable` to the test process via `GIT_CONFIG_COUNT` without\ntouching any repository config.\n\n## Attribution\n\n- Upstream: [`nyldn/claude-octopus`](https://github.com/nyldn/claude-octopus) (MIT) — this is a port\n- Debate skill: [wolverin0/claude-skills](https://github.com/wolverin0/claude-skills) (MIT)\n- Memory integrations: [claude-mem](https://github.com/thedotmack/claude-mem), [agentmemory](https://github.com/rohitg00/agentmemory)\n\n## Contributing\n\nUpstream development happens at [`nyldn/claude-octopus`](https://github.com/nyldn/claude-octopus)\n(see its [`CONTRIBUTING.md`](https://github.com/nyldn/claude-octopus/blob/main/docs/CONTRIBUTING.md)).\nPort-specific changes are the dsh seam layer in [`src/`](./src/) and\n[`test/`](./test/).\n\n## 📄 License\n\nMIT. Upstream [`nyldn/claude-octopus`](https://github.com/nyldn/claude-octopus)\n`Copyright (c) 2026 nyldn`; this port `Copyright (c) 2026 GongYuanCaiJi (dsh port)`.\nSee [LICENSE](./LICENSE).\n\nThanks to [nyldn](https://github.com/nyldn) — if this plugin is useful to you,\n**please also star the [upstream repository](https://github.com/nyldn/claude-octopus)**.\n"}