# oh-my-dsh

[![npm version](https://img.shields.io/npm/v/@hawk2048/oh-my-dsh?color=cb3837)](https://www.npmjs.com/package/@hawk2048/oh-my-dsh)
[![GitHub stars](https://img.shields.io/github/stars/hawk2048/oh-my-dsh?style=flat&color=yellow)](https://github.com/hawk2048/oh-my-dsh/stargazers)
[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT)
[![dsh-plugin](https://img.shields.io/badge/dsh-plugin-orange)](https://github.com/topics/dsh-plugin)

**面向 DeepSeek Harness (DSH) 的多智能体编排层** —— 把 [oh-my-claudecode](https://github.com/Yeachan-Heo/oh-my-claudecode) 的编排模式，映射到 DSH 原生原语（`workflow` / `subagent` / `ralph` / `goal`）之上。

> 两种触发方式：**自然语言**（30 个随 preset 打包的编排 skill，代理自动加载）+ **斜杠命令**（13 条，敲 `/omd` 即弹出候选）。启动一次会话，编排能力就位。

[English](README.md) | 中文

## 快速开始

一条命令装好全部 30 个 skill + 13 条 `/omd-*` 命令（等价 OMC 的插件市场安装）：

```sh
dsh plugin --profile web add github:hawk2048/oh-my-dsh
```

或从 npm 安装（等价 OMC 的 npm i -g）：

```sh
dsh plugin --profile web add @hawk2048/oh-my-dsh
```

装完重启 profile，敲 `/omd` 弹出命令候选；或直接用自然语言（「先规划一下」「autopilot 搭个 API」）触发对应 skill。

## 要求

- [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness)（`dsh` CLI）
- [pnpm](https://pnpm.io)（`dsh plugin` 底层转发给 pnpm）

## 为什么用 oh-my-dsh

- **零配置**——一条 `dsh plugin add` 装好全部；bundle 自注册，无需安装向导。
- **Team 优先编排**——Team 是标准分阶段流水线（`team-plan → team-prd → team-exec → team-verify → team-fix`），构建在 DSH 原生 `workflow` 上。
- **自然语言交互**——说清需求即可，30 个 `omd-*` skill 自动加载，无需记命令。
- **自动并行**——复杂任务扇出到并行 `subagent`。
- **持久执行**——Ralph / Autopilot / Ultragoal 不达验证完成不罢休（原生 `ralph` 循环 + `goal` 跨轮目标）。
- **零运行时开销**——不引入新宿主工具或运行时，只是 DSH 原生原语之上的 skill，保留 DSH 自己的模型路由与沙箱。
- **从经验中学习**——`omd-skillify` 提取可复用 skill；`omd-remember` 跨会话持久记忆。
- **实时可见**——内联 HUD 渲染实时 `dsh-ui` 进度仪表盘。

## 与 oh-my-claudecode 的对应关系

对齐 OMC **v5.3.0** 的命令面（核心流水线 `plan → execute → review → verify` + 保留模式）：

| OMC 工作流 | oh-my-dsh skill | DSH 原生载体 |
|-----------|-----------------|--------------|
| Plan（规划） | [`omd-plan`](skills/omd-plan/SKILL.md) | 只读探索 + `subagent` 并行调研 |
| Execute（执行） | [`omd-execute`](skills/omd-execute/SKILL.md) | `subagent` 并行 + `todo_write` |
| Review（评审） | [`omd-review`](skills/omd-review/SKILL.md) | `subagent_fork` 独立评审 |
| Verify（验证） | [`omd-verify`](skills/omd-verify/SKILL.md) | `pwsh`/`bash` 测试 + `subagent` 复核 |
| Team（分阶段流水线） | [`omd-team`](skills/omd-team/SKILL.md) | `workflow` + `subagent` |
| Autopilot（自动驾驶） | [`omd-autopilot`](skills/omd-autopilot/SKILL.md) | `goal` + `todo` + `subagent` |
| Ralph（持久验证循环） | [`omd-ralph`](skills/omd-ralph/SKILL.md) | `ralph` + `goal` 验证循环 |
| Deep Interview（需求澄清） | [`omd-deep-interview`](skills/omd-deep-interview/SKILL.md) | `ask_user_question` |
| Ralplan（共识规划） | [`omd-ralplan`](skills/omd-ralplan/SKILL.md) | 并行 `subagent` 草案 + 仲裁收敛 |
| Research（有据调研） | [`omd-research`](skills/omd-research/SKILL.md) | `web_search`/`web_fetch` + 并行 `subagent` |
| Autoresearch（评估驱动改进） | [`omd-autoresearch`](skills/omd-autoresearch/SKILL.md) | `goal` + 评估子代理循环 + 写作检查脚本（`references/report_lint.py`） |
| Ultragoal（持久多目标） | [`omd-ultragoal`](skills/omd-ultragoal/SKILL.md) | `goal` + `todo_write` + checkpoint 工件 |
| HUD（状态栏） | [`omd-hud`](skills/omd-hud/SKILL.md) | `dsh-ui` 内联仪表盘（genui） |

**提示词触发 + 工具 skill**（自然语言触发，无独立斜杠命令）：

| OMC 触发 | oh-my-dsh skill | DSH 原生载体 |
|----------|-----------------|--------------|
| tdd（测试驱动） | [`omd-tdd`](skills/omd-tdd/SKILL.md) | `pwsh`/`bash` 测试 + red-green-refactor |
| deepsearch（代码检索） | [`omd-deepsearch`](skills/omd-deepsearch/SKILL.md) | `grep`/`glob`/`read` 本地定位 |
| deep-analyze（深度分析） | [`omd-deep-analyze`](skills/omd-deep-analyze/SKILL.md) | 并行 `subagent` 多视角 |
| ultrathink（深度推理） | [`omd-ultrathink`](skills/omd-ultrathink/SKILL.md) | 纯推理（先不动工具） |
| ai-slop-cleaner（去废话） | [`omd-ai-slop-cleaner`](skills/omd-ai-slop-cleaner/SKILL.md) | `review`/`edit` 精简 |
| omc-doctor（自检） | [`omd-doctor`](skills/omd-doctor/SKILL.md) | 安装/挂载诊断 |
| debug（调试） | [`omd-debug`](skills/omd-debug/SKILL.md) | 复现→定位→最小修复→回归 |
| release（发布） | [`omd-release`](skills/omd-release/SKILL.md) | git + 测试 + changelog + tag |
| remember（跨会话记忆） | [`omd-remember`](skills/omd-remember/SKILL.md) | 工作区记忆文件 |
| cancel（取消模式） | [`omd-cancel`](skills/omd-cancel/SKILL.md) | goal pause + interrupt_agent + job_kill |
| minimal-code-discipline（最小改动） | [`omd-minimal-code-discipline`](skills/omd-minimal-code-discipline/SKILL.md) | YAGNI 阶梯 |
| external-context（外部上下文） | [`omd-external-context`](skills/omd-external-context/SKILL.md) | `web_fetch`/`read` |
| visual-verdict（视觉 QA） | [`omd-visual-verdict`](skills/omd-visual-verdict/SKILL.md) | `read_image` 对比 |
| skillify（提取 skill） | [`omd-skillify`](skills/omd-skillify/SKILL.md) | 写 `SKILL.md` |
| wiki（知识库） | [`omd-wiki`](skills/omd-wiki/SKILL.md) | 工作区 markdown |
| omc-help（使用指南） | [`omd-help`](skills/omd-help/SKILL.md) | 实时列 skill/命令索引 |

**本插件新增（OMC 无对应）**：

| 能力 | oh-my-dsh skill | DSH 原生载体 |
|------|-----------------|--------------|
| 金字塔结构化表达（结论先行 + MECE） | [`omd-pyramid`](skills/omd-pyramid/SKILL.md) | 纯表达纪律 + `dsh-ui` 层级映射（genui） |

> **`ultrawork` 已退役**：OMC 在 5.0.0 删除了 `ultrawork`（以及 `ultraqa`/`swarm`/`pipeline` 等），oh-my-dsh 同步移除；其"最大并行扇出"能力已并入 `execute`/`team`/`ralph` 的内部并行纪律。

关键差异：OMC 的 HUD 是 CLI 状态栏，而 oh-my-dsh 的 HUD 是**内联在回答正文里的 `dsh-ui` 仪表盘**（stat/progress/timeline/table），因为 DSH 的 Web GUI 本身就在渲染结构化 UI。

## 目录结构

```
oh-my-dsh/
├── package.json              # dsh.bundle manifest（组合包安装入口）
├── cordis.patch.yml          # 组合包 patch 层（全局命令 + 全局 skill 挂载）
├── index.js                  # 组合包模块入口
├── agent.cordis.yml          # agent preset 组合文件（= standard + persona + skill + 命令）
├── preset.yml                # preset 显示元数据
├── install.ps1 / install.sh  # preset 手动安装脚本
├── LICENSE
├── commands/
│   └── omd-commands.mjs    # 斜杠命令生产者（ESM 插件）
├── skills/
│   ├── omd-plan/SKILL.md
│   ├── omd-execute/SKILL.md
│   ├── omd-review/SKILL.md
│   ├── omd-verify/SKILL.md
│   ├── omd-team/SKILL.md
│   ├── omd-autopilot/SKILL.md
│   ├── omd-ralph/SKILL.md
│   ├── omd-deep-interview/SKILL.md
│   ├── omd-ralplan/SKILL.md
│   ├── omd-research/SKILL.md
│   ├── omd-autoresearch/SKILL.md
│   ├── omd-ultragoal/SKILL.md
│   ├── omd-pyramid/SKILL.md
│   ├── omd-tdd/SKILL.md
│   ├── omd-deepsearch/SKILL.md
│   ├── omd-deep-analyze/SKILL.md
│   ├── omd-ultrathink/SKILL.md
│   ├── omd-ai-slop-cleaner/SKILL.md
│   ├── omd-doctor/SKILL.md
│   ├── omd-debug/SKILL.md
│   ├── omd-release/SKILL.md
│   ├── omd-remember/SKILL.md
│   ├── omd-cancel/SKILL.md
│   ├── omd-minimal-code-discipline/SKILL.md
│   ├── omd-external-context/SKILL.md
│   ├── omd-visual-verdict/SKILL.md
│   ├── omd-skillify/SKILL.md
│   ├── omd-wiki/SKILL.md
│   ├── omd-help/SKILL.md
│   └── omd-hud/SKILL.md
└── docs/
    ├── ARCHITECTURE.md
    └── RELEASE.md
```

## 安装 / 使用

两种安装方式，**任选其一即可**（bundle 装全局、preset 按会话选）。

**方式 A：组合包 bundle（主要，等价 OMC 的插件市场安装）** —— 全局装好 13 条 `/omd-*` 命令与 30 个 skill，profile 里所有会话可见：

```sh
# git 源码安装（纯 JS/Markdown，零构建，无需 allowBuilds 授权；用 @<tag> 可锁定版本）
dsh plugin --profile web add github:hawk2048/oh-my-dsh

# 或从 npm 安装（等价 OMC 的 npm i -g）
dsh plugin --profile web add @hawk2048/oh-my-dsh
```

装完重启 profile 即可。用户全程只敲一条命令，由 pnpm 拉取，**不手动下载压缩包**。

**方式 B：agent preset（可选，按会话选择）** —— 含 persona 与编排工具集的全量会话：

```sh
# Windows
.\install.ps1
# macOS / Linux
./install.sh
```

安装器**非破坏性**：不删除 preset 目录，你本地加的 skill 会保留，被覆盖的本地改动会先备份成 `<name>.bak-<时间戳>`。重复运行安全可逆。

然后在 DSH 里**新建会话时选择 "oh-my-dsh 编排"** preset（或把它设为 `agent-presets.default`）。详见 [docs/RELEASE.md](docs/RELEASE.md)。

## 怎么用（会话内）

两种方式，效果一样：

**方式一：自然语言**（代理自动加载对应 skill）

- `先规划一下怎么实现 X` → `omd-plan`
- `按计划实现` → `omd-execute`
- `评审一下刚才的改动` → `omd-review`
- `验证一下，测试要全绿` → `omd-verify`
- `用 team 做一个任务管理应用` → `omd-team`
- `autopilot：搭一个 REST API` → `omd-autopilot`
- `ralph 重构认证，必须测试全绿` → `omd-ralph`
- `先深度访谈，我想做个 xx` → `omd-deep-interview`
- `ralplan：多角度论证一下这个架构选型` → `omd-ralplan`
- `调研一下 X 的最佳实践，要带来源` → `omd-research`
- `autoresearch：把这份报告打磨到达标` → `omd-autoresearch`
- `ultragoal：这个长期目标拆成子目标推进` → `omd-ultragoal`
- `把这段整理成金字塔结构 / 结论先行 / MECE` → `omd-pyramid`
- `tdd：先写失败测试再实现` → `omd-tdd`
- `deepsearch：定位谁调用了这个函数` → `omd-deepsearch`
- `deep-analyze：深度分析一下这块架构` → `omd-deep-analyze`
- `ultrathink：想清楚再动手` → `omd-ultrathink`
- `去 AI 废话，精简这段` → `omd-ai-slop-cleaner`
- `自检一下 oh-my-dsh 装好没` → `omd-doctor`
- `debug：排查这个报错` → `omd-debug`
- `发布 v1.2，写 changelog` → `omd-release`
- `记住这个决定，下个会话还要用` → `omd-remember`
- `停掉正在跑的 autopilot` → `omd-cancel`
- `最小改动，别过度设计` → `omd-minimal-code-discipline`
- `看下这个 issue/链接` → `omd-external-context`
- `对比这两张截图` → `omd-visual-verdict`
- `把这段流程沉淀成 skill` → `omd-skillify`
- `记到知识库/更新文档` → `omd-wiki`
- `omd 能做什么 / 有哪些命令` → `omd-help`

**方式二：斜杠命令**（在输入框敲 `/omd` 弹出候选）

| 命令 | 等价 skill |
|------|-----------|
| `/omd-plan <任务>` | `omd-plan` |
| `/omd-execute <任务>` | `omd-execute` |
| `/omd-review <任务>` | `omd-review` |
| `/omd-verify <任务>` | `omd-verify` |
| `/omd-team <任务>` | `omd-team` |
| `/omd-autopilot <目标>` | `omd-autopilot` |
| `/omd-ralph <目标>` | `omd-ralph` |
| `/omd-deep-interview <主题>` | `omd-deep-interview` |
| `/omd-ralplan <描述>` | `omd-ralplan` |
| `/omd-research <问题>` | `omd-research` |
| `/omd-autoresearch <任务>` | `omd-autoresearch` |
| `/omd-ultragoal <目标>` | `omd-ultragoal` |
| `/omd-pyramid <内容>` | `omd-pyramid` |

代理会加载对应的 skill，按该模式编排，并用 HUD 实时汇报进度。

## 为什么是 skill + bundle/preset，而不是新工具

DSH 的原生多智能体原语（`workflow` 的流水线/并行、`subagent` 的扇出、`ralph` 的 fresh-agent 循环、`goal` 的跨轮目标）**已经覆盖了 OMC 的编排语义**。oh-my-dsh 因此不引入新的宿主工具或运行时，而是把「什么时候用哪个原语、怎么编排、怎么收尾」沉淀成可复用的 skill。

分发也复用 DSH 原生机制：`cordis.patch.yml` + `package.json` 的 `dsh.bundle` manifest 让 `dsh plugin add` 装成**组合包**（全局命令 + 全局 skill），`agent.cordis.yml` 让它作为**agent preset** 按会话挂载（persona + 命令 + skill）。斜杠命令的 `commands/omd-commands.mjs` 是一个 ESM 插件，注入 DSH 自带的 `commands` 服务注册命令——零运行时风险，升级 DSH 不受影响。

## 扩展

- **加模式**：在 `skills/` 下新增 `omd-xxx/SKILL.md`（YAML frontmatter 写 `name` + `description`）。
- **加命令**：在 `commands/omd-commands.mjs` 的 `MODES` 数组里追加一条。
- **改 persona**：编辑 `agent.cordis.yml` 顶部的 `persona` 行。保留该行 schema 要求的 `prefix:` 键，并且只引用已注册的提示变量——目前是 `{{provider}}` / `{{model}}`。工作目录现在作为独立的 runtime-context 段注入，写 `{{cwd}}` 会让该预设的每一轮 prompt 组装失败（回归守卫：`tests/preset-contract.test.mjs`）。
- **把 skill 做成全局**：走 bundle（`dsh plugin add`），见上文方式 A；或把 `skills/*` 复制到 `${DSH_HOME}/skills/`。

## 许可

MIT。灵感来自 [oh-my-claudecode](https://github.com/Yeachan-Heo/oh-my-claudecode)。