Cavan-Ou/hermes-dsh-collab

把 DeepSeek Harness 接进你的 Hermes 管线：派单、执行、验收全自动——质量门不信任自报。

你的 AI 助手能自己干一整天活，问题是：你敢放手吗？

这个 skill 让放手变得安全：Hermes 写派单 spec，DSH 执行，Hermes 验收——只有质量门真失败时才轮到你介入。从一条真实跑过的 14 天管线提炼（30 个 commit，7/7 阶段零返工交付）。

依赖： DSH 0.1.x（headless profile）+ 任意编排方 agent（用 Hermes 构建并实测）。

---

为什么需要它

Hermes 是你的个人助手，DSH 是能干活的执行器。缺的是两者之间的运行契约：一份合格的派单 spec 长什么样、哪个阶段用哪档模型、谁有资格 commit、验证到底怎么做。

大多数管线跳过这份契约，然后为返工买单。最近的工作（COPE）证明 planner/executor 分离有效——但前提是执行方的行为被约束。这个 skill 固化的就是这些约束，全部来自一条实测过的管线：

• 模型分层路由 —— 常规阶段 Flash（reasoning: max），多文件重构/长提炼 Pro，视觉 qwen。拿不准先 Flash 试一轮——返工就升级
• Spec 三铁律 —— Plan 先行 · 测试先行（TDD 红→绿）· 范围声明。缺一不派单
• Git 唯一写者 —— 只有编排方 commit。执行方永远不碰 git，历史保持线性可审计
• 质量门归编排方 —— 全量测试 + build + diff 对照范围 + 真浏览器走查。自报不算证据
• 写回靠启动目录 —— cd <项目> && dsh --profile headless "任务" 直接写回。不要 /tmp 镜像，不要 patch 交接
• 踩坑都有实锤 —— 每一条都是真实事故：patch 配置是整段替换（不是深合并）、qwen 不支持 reasoning: max、vision patch 不改主模型、旧后端进程会让"测试全绿"验到旧代码……

快速开始

# 方式一：dsh plugin 安装（bundle，推荐）
dsh plugin --profile headless add github:Cavan-Ou/hermes-dsh-collab

# 方式二：直接复制 skill 包（轻量，任意 profile）
git clone https://github.com/Cavan-Ou/hermes-dsh-collab
cp -r skills/hermes-dsh-collab "$DSH_HOME/skills/"   # 默认：~/.dsh/skills/

任选其一，下次 DSH 会话自动加载（bundle 注册 skill provider；复制方式由 skills 扫描器发现）。

三个验证：

1. 新会话的技能列表出现 hermes-dsh-collab
2. 说"帮我写一份派单任务书"——按场景自动触发
3. 问"执行者可以自己 git commit 吗？"——它回答不可以，并解释原因（唯一写者约定）

里面有什么

skills/hermes-dsh-collab/
├── SKILL.md                      # 判断指引：阻断项 → 判断表格 → What NOT to do
└── references/                   # 按需加载，保持主文件精简
    ├── spec-template.md          # 可复制的派单 spec 模板（三铁律 + 不 commit 条款）
    ├── model-routing.md          # 档位表 + patch 机制 + 三个 patch 坑
    ├── quality-gates.md          # 质量门四步命令 + 回炉/升级链
    └── pitfalls.md               # 10 条真实踩坑清单（症状 → 根因 → 对策）

写法对齐 DeepSeek 官方仓库自用 skill（见 deepseek-ai/deepseek-harness 的 .agents/skills）：引导式而非清单 · 指明真源而非复述 · 专门的 "What NOT to do" 节。

安装形态说明：两种方式都支持——bundle（dsh plugin add，官方分发路径，已在 DSH 0.1.0-rc.6 实测）与直接复制（$DSH_HOME/skills/，轻量免构建）。

实测结果

结果	证据
质量门自动抓系统性错误	一次长提炼（74 份设计文档，约 60 万 token）中，验证环节揪出 3 条方向完全相反的反判据 + 一个"全宇宙特征"（发丝线在 5 个流派 78–100% 高频）——这类错误人工检查要数小时且大概率漏掉
Flash 常规阶段零返工	3/3 阶段——TDD 红→绿，质量门全绿，真浏览器走查通过
skill 真的改变行为	真实会话：加载后 DSH 拒绝 commit 并复述唯一写者规则

人工只在升级链上介入：质量门失败，或同一阶段重试两次。其余全自动。

文档

• SKILL.md —— 判断指引本体（先读这个）
• REPORT.md —— 构建报告：设计决策、自测方法（隔离 DSH_HOME 验证）、遗留项

路线图： 按工作区隔离失败记录 · 路由表从观测卡活体刷新 · references 英文镜像

可移植性说明：skill 的"真源"指向工作区专属路径（如 ~/.dsh/profiles/headless/*.patch.yml）。规则本身可移植——把路径换成你的工作区即可。

贡献

这个 skill 靠真实使用长大。遇到清单里没有的坑？开 issue 带上事故现场（症状 → 根因 → 对策）。中英文 PR 都欢迎。

License

MIT

---

不是读文档写出来的，是跑真实管线跑出来的。