@dsh-external/dsh-dev-team-manager

Readme

# dev-team for DeepSeek Harness（dsh-dev-team-manager）

`@dsh-external/dsh-dev-team-manager` 是 **dev-team 多智能体技能包**的 DeepSeek Harness（dsh）一体化发行：单仓库、单插件包、一条命令安装。包内捆绑 **43 个技能 + 11 个专家代理提示词**，插件启动时自动部署并运行时注册，同时提供一个可视化管理面板（双语、调用短语复制）。

## 一条命令安装

```bash
dsh plugin --profile web add github:<owner>/dev-team-dsh
# 或本地目录：
dsh plugin --profile web add D:\path\to\dsh-dev-team-manager
```

安装后重启 dsh（或等 HMR），插件会：

1. **自动部署技能**：把捆绑的 `skills/`（43 个）复制到 `~/.dsh/skills`、`agents/`（11 个）复制到 `~/.dsh/dev-team/agents`。幂等：内容相同跳过、不同覆盖（即升级路径），并在 `~/.dsh/dev-team/.dev-team-bundle.json` 写版本戳；
2. **运行时注册**：43 个技能当次启动即可用，无需手动复制；
3. **挂管理面板**：Web UI 左缘竖排「Dev Team」标签 → 滑出面板。

卸载：

```bash
dsh plugin --profile web remove @dsh-external/dsh-dev-team-manager
```

> 卸载插件不会删除已落地的 `~/.dsh/skills` 与 `~/.dsh/dev-team/agents` 文件；如需彻底清理请手动删除对应目录。

## dev-team 是什么

编排一组专职 AI 代理完成全周期软件开发——从需求到测试通过、评审过的代码。协调器（`/dev-team`）把任务切成垂直切片，以隔离上下文派发 11 个专家代理，并执行内联质量关卡：Phase 0 分诊为每个任务指派流水线档位（Micro / Standard / Full，默认从简）；Full 档位下每份 PRD 与执行计划先经对抗辩论再进 `doc-reviewer` 评审；代码必过 `code-reviewer`。

每个代理报告必须带 `Evidence` 字段（证明工作的最新命令输出，空口「DONE」不被信任）；测试代理先写失败的验收测试（Mode A）、实现后验证转绿（Mode B）；实现代理禁止改测试文件。协调器在 `docs/progress.md` 跟踪状态。

## 管理面板

- 左缘竖排「Dev Team」标签，点击滑出面板（遮罩 / Escape / 再点标签收起）；
- 顶部状态行：技能 / 代理提示词 / 源仓库安装状态 + 包版本号；
- 分组清单：协调器（5）、快捷指令（10 个 `ask-*`）、专家代理（11，带 color 圆点）、可折叠的栈与质量技能（28）；
- **中文 | EN 双语切换**（描述有完整中文翻译，选择持久化到 localStorage）；
- 点击任意条目复制调用短语：协调器 `Use dev-team to `、快捷指令 `/ask-xxx `、代理 `Use dev-team <name> to `。

> **Token 消耗提醒**：dev-team 是多代理编排，一个 Full 档位任务会串行调用多个专家代理并携带各自上下文，token 消耗显著高于单代理对话。日常小改动建议用 `/ask-*` 快捷指令直派单个代理，把完整编排留给真正需要多阶段协作的任务。

## 配置

所有配置项都有默认值；在自己的 profile patch（如 `C:\Users\<用户>\.dsh\profiles\web\cordis.patch.yml`）里按插件 id `dev-team-manager` 覆盖：

| 配置项 | 默认值 | 说明 |
| --- | --- | --- |
| `skillsDir` | `~/.dsh/skills` | 技能部署目标目录（自安装写入此处） |
| `promptsDir` | `~/.dsh/dev-team/agents` | 专家代理提示词部署目标目录 |
| `pluginRepoDir` | `D:\ruanjian\dsh-plugins\dev-team` | 源仓库展示路径（仅状态展示） |
| `topOffsetPx` | `52` | 面板/标签距视口顶部偏移，避开桌面版 frameless 标题栏；纯 Web 部署可设为 `0` |

示例：

```yaml
- id: dev-team-manager
  name: '@dsh-external/dsh-dev-team-manager'
  config:
    topOffsetPx: 0
```

## 构建

```bash
npm install
npm run build
```

构建分三步：`tsc -p tsconfig.json`（host，ESM → `lib/`）、`tsc -p tsconfig.client.json`（client，CommonJS → `.client-build/`）、`node scripts/build-client.mjs`（包装为 `window.__ModuleLoader__.load({id, factory})` 协议的 `lib/client.js`）。host 与 client 必须是两个独立 tsc program（Context 声明合并冲突）。

## 目录说明

- `src/ lib/ scripts/`：插件代码（host + client + 构建脚本）
- `skills/ agents/`：捆绑的 dev-team 技能与专家代理提示词（上游 [biggora/dev-team](https://github.com/biggora/dev-team) 的 dsh 适配版）
- `DSH.md AGENTS.md CLAUDE.md GEMINI.md docs/ specs/ templates/ autoresearch/ evals/ skills-lock.json`：上游文档与 provenance，原样保留
- `.claude-plugin/ .codex-plugin/ .copilot-plugin/ .agents/`：其他平台的插件清单（跨平台 Agent Skills 标准）

## 许可

MIT。上游技能包 Copyright (c) 2024 Aleksejs Gordejevs；dsh 适配与插件本体见 `LICENSE`。