tq04qom/dsh-multirole

dsh-multirole

DSH（DeepSeek Harness） 的多角色协作插件。

DSH 多角色协作模式插件。

简介 / Overview

中文：四层角色架构（人/顾问/总控/执行者）+ 任务单制度 + 写入域互斥 + 授权模式 + 裁决日志，让大模型协作开发可控、可复用。

English：四层角色架构（人/顾问/总控/执行者），配合任务单、写入域隔离、授权模式和审计日志——让大模型团队开发可控且可复用。

核心机制 / Core Mechanisms

| 机制 | 中文 | English |
|---|---|---|
| 角色架构 | 人（总裁决）/ 顾问（总设计）/ 总控（调度验收）/ 执行者（批量执行） | 人（裁决者）/ 顾问（设计者）/ 总控（调度与验收）/ 执行者（批量） |
| 任务单制度 | 一切派发落盘为自包含任务单，跨会话唯一事实源 | 每次派发都落盘为自包含任务文件——唯一事实源 |
| 写入域互斥 | 并行任务写入域两两不相交 | 并行任务的写入域两两不相交 |
| 授权模式 | 标准模式（报人签字）/ 全授权模式（授权书 + 顾问裁决 + 预算闸口） | 标准模式（人工签字）/ 全权委托（授权书 + 顾问裁决 + 预算熔断） |
| 验收闭环 | 总控亲验 + 裁决包报人，人只做一分钟判断 | 总控验收 + 裁决包提交给人——每个决策只需一分钟 |
| 发布闸口 | 版本合规 + CHANGELOG + 人点头 | 版本合规 + CHANGELOG + 人工批准 |

安装 / Install

git clone https://github.com/tq04qom/dsh-multirole.git
cd dsh-multirole
bash scripts/install.sh

装完重启 DSH，新建会话时 preset 选择器选「多角色协作模式」。

安装后，重启 DSH，并在创建新会话时从 preset 选择器中选择「多角色协作模式」。

沙箱安装（开发验证）/ Sandbox Install

bash scripts/install.sh --target dev

装入 multirole-dev，preset name 显示为「多角色协作模式（开发版）」，无闸口、不覆盖正式版。

快速上手 / Quick Start

新建 DSH 会话，选「多角色协作模式」preset，然后粘贴以下话术：

创建一个新的 DSH 会话，选择「多角色协作模式」preset，然后粘贴：

你是本项目的总控。项目根：。
开工动作：
1. 用 skill 工具加载 orchestration，通读流转协议。
2. 在项目根创建 任务单\ 和 logs\ 目录。
3. 把 \.agent-presets\multirole\skills\orchestration\ 下的
任务单模板.md、授权书模板.md、裁决日志模板.md 复制到 任务单\ 目录备用。
4. pwd 自证工作目录，ls 自证全部落位。
完成后报告目录结构，然后停等我的第一个目标。
授权模式：标准（一切方向性决策与验收终审报我）。

更多话术见 dsh-multirole/agent-presets/multirole/skills/orchestration/开工话术库.md。

版本 / Version

当前版本：0.1.6（见 dsh-multirole/package.json）

版本规范：MAJOR.MINOR.PATCH[-dev]，权威源 = package.json 的 version 字段。

目录结构 / Structure

dsh-multirole/
├── agent-presets/multirole/
│   ├── preset.yml              # preset 声明
│   ├── agent.cordis.yml        # 工具组合 + 角色 persona + 模型路由
│   └── skills/orchestration/   # 流转协议 + 模板（7 件）
│       ├── SKILL.md            #   宪法（协议本体）
│       ├── 任务单模板.md
│       ├── 授权书模板.md
│       ├── 裁决日志模板.md
│       ├── 验收清单.md
│       ├── 裁决包模板.md
│       └── 开工话术库.md
├── package.json                # 版本权威源
├── cordis.patch.yml            # bundle 注册层
└── scripts/
└── install.sh              # 安装/发布/回滚脚本

协议要点 / Protocol Highlights

- 第 0 条铁律：人只干人必须干的事，其他一切都由机完成
- 第 1 条铁律：召集顾问时必须保证信息充分（列出所有关键输入文件路径）
- 任务单自包含：跨会话失忆时任务单是唯一事实源
- 并行铁律：写入域两两不相交
- 验收必须亲验：禁止凭执行者自述通过

贡献 / 贡献

欢迎通过 Issue 或 Pull Request 参与。

- Bug 报告：新开 Issue，附复现步骤与环境信息（DSH 版本、操作系统）
- 功能建议：新开 Issue，先讨论再实现
- 代码贡献：Fork → 修改 → Pull Request（main 分支受保护，强制 PR + 审批）

贡献红线 / 贡献准则

- 模型路由保持占位符：agent.cordis.yml 中的 provider/model 一律用  / ，禁止提交个人模型配置
- orchestration skill 不拆分：不要新增独立 skill（verification / prompt-archiving 等），新规则作为 SKILL.md 的资源文件落入同一目录
- 协议条款变更须说明依据：修改 SKILL.md 的规则性语句时，PR 描述中必须写明依据（事故记录 / 设计意见书 / 用户裁决）
- 中文文件编码 UTF-8：所有 .md 文件保持 UTF-8 编码，不要用 ANSI
- 不提交个人路径：代码和文档中的路径一律用占位符（、 等）

许可证

MIT