Dsh Pilot — Git skill for Claude Code

dsh-pilot

**Contract-driven master/subagent dispatch for DeepSeek Harness (DSH).** The master (expensive model) drafts a *contract*, cheap subagents execute it, and the plugin adjudicates **deterministically** — acceptance-command exit codes, git-diff whitelist, receipt cross-check — so the master only reads a compact verdict.

一句话定位：**agent-teams 给你一支团队，dsh-pilot 给你一份合同。**

[](LICENSE)

**状态：M1.6 完成，全链路可用** —— 契约派发 → 白名单守卫 → 门禁执行 → 裁决回传，62/62 自动化测试通过，并经真实子代理派发会话验收（PASS）。设计定稿、里程碑与真实验收记录见 [DESIGN.md](./DESIGN.md)，开源生态对照与差异化定位见其 §11。

Why

廉价模型（如 DeepSeek v4.1 flash）写码又快又便宜，但幻觉重、不擅长规划与理解工程状况。dsh-pilot 把"规划 + 仲裁"留给贵模型，把"执行"交给廉价子代理，中间用**代码裁决**替代 LLM 互评：

• 契约 schema 刻意没有 code 字段 —— 主代理物理上递不了代码；
• 门禁 exit code 由插件亲自执行验收命令取得，不信回执自报；
• git status 任务前后快照差集 vs 回执 files_changed 交叉核验，虚报即 FAIL 并把真实 diff 喂回重试；
• 白名单守卫：子代理对 allowed_files 之外的写入被直接拒绝（tools.guard，同步、fail-open）；
• 失败重试只喂确定性内容（stderr 尾部、越界清单），耗尽 → ESCALATED 上交人类。

How it works

 主代理（旗舰模型）                    dsh-pilot 插件（Host，纯代码裁决）
 ─────────────────                    ──────────────────────────────
 理解需求 · 摸清工程状况                ① 组装子代理 prompt = 契约 + 内联上下文
 起草契约 · 不亲手写代码     ──契约──▶   ② subagents.start(outputSchema, toolFilter)
                                      ③ 文件白名单守卫（tools.guard）
        ▲                             ④ 门禁：shell 跑 acceptance_cmd → 真实 exit code
        └────── verdict ◀──────────   ⑤ 核验：git diff vs 白名单 & 回执真实性
        （紧凑 JSON，<200 token）       ⑥ 失败：确定性反馈重试（≤max_retries）

契约示例（`pilot_dispatch` 入参，schema 强校验）：

{
  "goal": "一句话目标",
  "detail": "需求细节、接口签名约定、边界条件",
  "context": [
    { "path": "src/auth.ts", "note": "TokenService 在此；签发签名 sign(uid: string): string" }
  ],
  "allowed_files": ["src/auth.ts", "tests/auth.test.ts"],
  "acceptance_cmd": "pnpm vitest run tests/auth.test.ts",
  "tier": "standard",
  "max_retries": 2
}

裁决示例（插件 → 主代理，主代理**只看这个**）：

{
  "verdict":