领主与仆从编排 ttxl314/dsh-skill-lord-serf

@ttxl314/dsh-skill-lord-serf

将 ttxl314/lord-serf-agent-protocol-SKILL（协议 0.5）移植为 DeepSeek Harness（DSH）插件：提供 lord 与 serf 两个技能，让 DSH 既可以当 Lord（编排者），也可以当 Serf（执行者）。

协议是什么

以文件为载体的多 Agent 编排协议，生命周期：

plan → package → dispatch → execute → submit → review → decide

- Lord：规划、任务包（task package）、派发 Serf、权威任务状态（authoritative state source）、评审决策、最终验收。
- Serf：执行一个 Lord 下发的任务包、自我校验实际产出、提交一份报告（REVIEW / BLOCKED / CHANGE_REQUEST）。
- 聊天只是通知；项目状态、需求、证据、决策全部落盘为文件（TASKS.md、TASKS/、REVIEWS/、BLOCKERS/、CHANGE_REQUESTS/）。

仓库结构

dsh-skill-lord-serf/
├── package.json # dsh.bundle 清单；无运行时依赖，仅 peer ├── cordis.patch.yml # 组合包层：注册 lord-serf 插件行 ├── lib/index.js # cordis 插件：ctx.skills 文件支撑 Provider ├── test/self-test.mjs # 自测套件 └── skills/ ├── lord/ │ ├── SKILL.md # 含 DSH 适配（DSH Bindings 映射表） │ ├── assets/schemas/ # 任务包 / 微任务 / 派发指令 schema │ ├── assets/templates/ # 任务包 / 派发指令 / 项目文件模板 │ └── references/ # 伸缩、评审、变更控制、恢复、适配器等 └── serf/ ├── SKILL.md ├── assets/schemas/ # 提交信封 / 评审报告 schema ├── assets/templates/ # REVIEW / BLOCKED / CHANGE_REQUEST 模板 └── references/ # 任务包接收、子代理扇出、自校验、提交报告等

skills/<name>/SKILL.md 同时带 DSH 技能 frontmatter（name + description），同一份文件可以双用：

1. 插件方式：lib/index.js 在启动时通过 ctx.skills.registerProvider 注册一个文件支撑 Provider（rank 250），把两个技能以 resourceBase: { kind: 'directory', path: <技能目录> } 暴露到全局层，所有会话可用；get() 每次按需重读正文，编辑即时生效。
2. 文件方式：把 skills/lord、skills/serf 复制（或链接）到 <项目>/.dsh/skills/ 或 ~/.dsh/skills/，由 dsh-skill-filesystem 直接发现，无需重启。

与 DSH 机制的映射

| 协议概念 | DSH 机制 |
| Serf 执行体 | subagent 工具（每个任务包派一个子代理）或独立 DSH 会话 |
| Serf 的子工作扇出 | subagent 工具在任务边界内做不相交子步骤；见 skills/serf/references/dsh-subagents.md |
| $serf 调用 | /serf 用户手势，或子代理内 skill(name='serf') 加载 |
| $lord review <path> / $lord resolve <path> | /lord 手势 + 报告路径；子代理 Serf 的最终消息直接回到 Lord |
| 状态源 / 任务包 / 报告 | 共享工作区内的普通文件，用 DSH 文件工具读写 |
| 长时间编排 | DSH goal 工具保持目标跨轮次推进 |

安装

A. 组合包方式（全局可用）

从 GitHub 安装（本包直接交付预构建 ESM，无 build 步骤、无需授权 prepare 脚本；建议锁定 commit）：

dsh plugin --profile <name> add github:ttxl314/dsh-skill-lord-serf#<commit-sha>

或从本地检出链接安装：

dsh plugin --profile <name> add ./dsh-skill-lord-serf

dsh plugin 会把包加进 profile 的依赖与 dsh.profile.bundles，其 cordis.patch.yml 层负责注册插件行。重启 web 服务后生效；条目会出现在 GUI 的 Settings → Plugins 清单中。

B. 文件方式（无需重启，项目级）

New-Item -ItemType Junction -Path .dsh\skills\lord -Target <本包>\skills\lord New-Item -ItemType Junction -Path .dsh\skills\serf -Target <本包>\skills\serf

技能目录监视器会即时发现，当前会话的技能目录自动刷新。

使用

- Lord 会话：说"用 Lord 协议编排这个项目"或输入 /lord，按工作流产出任务包、派发指令并维护 TASKS.md。
- 派发 Serf：Lord 用 subagent 工具派发，子代理提示词 = assets/templates/dispatch-instruction.md 的生成结果，并要求子代理先 skill(name='serf') 再执行任务包。
- Serf 会话：输入 /serf 或直接给任务包路径；可在边界内用 subagent 扇出子工作（references/dsh-subagents.md）；执行后按模板写报告，最终消息给出报告路径。

自测试

node test\self-test.mjs

套件覆盖 26 项检查：Provider 契约（apply/list/get/invalidate）、SKILL.md frontmatter 解析、Codex 残留标记扫描、技能正文引用路径存在性、6 个 JSON Schema 可编译（draft 2020-12）、代表性协议载荷正反向校验（含 v0.3 字段拒绝）、模板与 schema 常量一致。依赖 ajv、ajv-formats、yaml，从本机 DSH profile（$DSH_HOME）的 node_modules 解析。

另支持端到端演练：Lord 建任务包（schema 校验后派发）→ subagent 子代理加载 serf 技能执行 → 报告过 micro-review-report/submission-envelope schema → Lord 核对实际产出后更新权威状态。

依赖

- @deepseek-ai/cordis ^4.0.1（peer）
- @deepseek-ai/dsh-skill ^0.1.0-rc.6（peer，由 @deepseek-ai/dsh-base 组合包提供）

与上游的差异

- 所有 $lord/$serf（Codex 命令）→ /lord//serf（DSH 技能手势）。
- dispatch-instruction 的 worker_invocation 常量为 /serf；Invocation 一节改为 DSH subagent 派发说明；执行要求新增子代理扇出条款。
- 新增 serf/references/dsh-subagents.md（DSH 专属的 Serf 子工作扇出规则）与 coding 适配器的 "Execution Capabilities (DSH)" 小节。
- 删除了 Codex 专属的 agents/openai.yaml。
- 协议本体（字段名、任务档位 micro/standard/full、状态词表、报告路径、非谈判条款）与上游 0.5 完全一致，任务包/报告可跨平台互认。

许可证

基于 ttxl314/lord-serf-agent-protocol-SKILL（MIT），本移植同样以 MIT 发布。