dsh-software-company · DeepSeek Harness 软件开发团队插件
中文文档(即本文件,GitHub 首页默认展示)。English version: [README.en.md]
把 WorkBuddy software-company 专家团(1 主理人 + 4 成员)适配为 DeepSeek Harness(DSH)0.2.2-rc.3 可安装的纯配置 Bundle。安装后宿主会多出 5 个 Agent Preset:1 个主理人 + 4 个成员,主理人通过 4 个具名委派工具按 SOP 编排交付。
本包零 JS 入口:不提供运行时代码、不声明任何 dependencies / peerDependencies、没有构建脚本;能力全部来自宿主自带的 @deepseek-ai/dsh-* 包。所有角色提示词以 @deepseek-ai/dsh-persona 的 prefix 内联进各自的 preset,并同时以 agents/*.md 提供可读副本(两者由静态自检保证逐字一致)。
正式花名(以原
plugin.json为准):齐活林(Qi,交付总监 / 主理人)、许清楚(Xu,产品经理)、高见远(Gao,架构师)、寇豆码(Kou,工程师)、严过关(Yan,QA 工程师)。
兼容性矩阵
| 项目 | 值 |
|---|---|
| 目标宿主 | DeepSeek Harness(DSH) |
| 目标宿主版本 | 0.2.2-rc.3 |
| 官方 tag | dsh-v0.2.2-rc.3 |
| Node 要求 | >=24.9.0(engines.node) |
| 宿主门控 | engines.dsh: ">=0.2.2-rc.3" |
| 插件版本 | 0.3.1 |
| Bundle 类型 | 纯配置(patch 层:./cordis.patch.yml) |
| 适用 profile | web(桌面端 / headless 均自带 @deepseek-ai/dsh-* 包) |
| License | MIT |
rc.3 增量适配说明
本次从 0.1.0 / dsh-v0.2.2-rc.1 升级到 0.2.0 / dsh-v0.2.2-rc.3,改动如下:
- 版本门控对齐:
engines.dsh由>=0.2.2-rc.1提到>=0.2.2-rc.3,插件版本提到0.2.0,目标宿主 tag 对齐dsh-v0.2.2-rc.3。 - 主理人新增
ask_user_question:lead preset 挂上@deepseek-ai/dsh-tool-ask-user(无额外 config),需求不明确时用ask_user_question做结构化澄清。4 个成员 preset 刻意不挂该工具 —— 成员直接问用户会破坏「所有信息流经主理人中转」的铁律。 tool-subagent-control的interrupt显式化:5 个 preset 全部显式声明config.interrupt—— 主理人为true(可中止跑偏成员),成员为false(成员maxDepth: 1没有下级,该能力本不可用,与官方 standard 一致)。- 静态自检白名单对齐 rc.3:
scripts/verify.mjs的AUTHORITATIVE_PACKAGES更新为 rc.3 官方 standard preset 的完整包集合(含tool-ask-user、tool-office、plan-mode、command-goal、tool-goal、workflow-ptc、tool-workflow等),并新增tool-ask-user分布与interrupt分布的专项检查。 - 工具矩阵保持精简:白名单只是「允许集合」,
0.2.0时本 bundle 未引入任何 goal / plan / schedule / office 宿主可选能力。0.3.0按已批准矩阵补挂了command-goal/tool-goal(仅主理人)与tool-office(仅产品经理与工程师),编排类能力依然全部关闭(见下文「能力启用矩阵(0.3.0)」)。
0.3.1 增量说明
- CI 门禁:新增
.github/workflows/verify.yml,push/PR 时自动跑node scripts/verify.mjs,并对agents/、skills/、cordis.patch.yml做模板变量起始符({{)扫描(显式区分退出码:发现匹配或扫描失败均判失败)。e2e 冒烟 job 保持注释态(公开 CI 无 LLM 凭据)。 - 主理人兜底:lead persona 新增「失败与超时兜底(CRITICAL)」与「横向协商绕行(peer-consult via lead)」两节(completion notice 缺失时的等待 / 查状态 / 分级处置,重派时保留中断点),
agents/software-team-lead.md与 prefix 逐字一致。 - README 基线工具面说明:能力启用矩阵表后注明该表只列 0.3.0 新增包,并补充 5 个 preset 共享的基线工具面(
tool-web参数、tool-bash/tool-pwsh平台互斥等)。 - 跨平台命令指引:工程师与 QA 的 prompt 各加一句构建/测试命令的宿主 shell 书写指引(Windows 宿主仅 pwsh、Linux/macOS 宿主用 bash)。
.gitignore:新增忽略.tmp/(本地开发残留,其中宿主 dump 可能含字面{{,避免误入版本库)。
能力启用矩阵(0.3.0)
| preset | 新增包行 | config | 说明 |
|---|---|---|---|
software-company-lead(sc-preset-lead) |
@deepseek-ai/dsh-command-goal(command-goal)+ @deepseek-ai/dsh-tool-goal(tool-goal) |
均无 config(字段全部有默认值) | 主理人管理跨阶段交付目标 |
software-company-product-manager |
@deepseek-ai/dsh-tool-office(tool-office) |
无 config(activationSkills 走默认) |
可产出 Office 文档交付物 |
software-company-engineer |
@deepseek-ai/dsh-tool-office(tool-office) |
同上 | 同上 |
software-company-architect |
不挂任何新包 | — | 零扩展 |
software-company-qa-engineer |
不挂任何新包 | — | 验收报告默认走对话内交付,不默认开 office |
说明:上表只列 0.3.0 新增包。5 个 preset 还共享同一基线工具面:
tool-web(fetch: true、searchTimeoutMs: 60000,参数细节见「已知限制」#6)、tool-bash/tool-pwsh按宿主平台互斥启用(win32 用 pwsh、非 win32 用 bash,disabled用!!js平台表达式)、tool-fs/tool-fs-search/tool-jobs/tool-skill/tool-todo/tool-present、agent-instructions、time-context与 compaction 组等。
设计原则:编排类能力不开放给成员,产物类能力按角色需要挂载 —— plan-mode、tool-schedule、workflow-ptc、tool-workflow 刻意保持零启用,成员依旧不得委派下级、不得绕过主理人直达用户。
安装
CLI
dsh plugin --profile web add github:xylon-y/dsh-software-company
该命令会把本仓库加入所选 profile 的 dsh.profile.bundles。
桌面端
打开 Plugins → Add plugin,粘贴仓库 URL:
https://github.com/xylon-y/dsh-software-company
安装后
重启对应 profile(或重启桌面端),让 patch 层参与配置组装。建议随后用 dsh --dump-config 做一次组合配置自检(见下文)。
使用
新建会话时,在 Agent Preset 下拉中选择 「软件开发团队 · 交付总监(齐活林 Qi)」(software-company-lead);也可在设置里把它设为默认 preset。随后直接描述需求,主理人齐活林会先判定工作流类型(快速模式 / BugFix / 标准 SOP / 部分工作流),再分派给成员。
只有主理人 preset 持有 4 个委派工具。4 个成员 preset 只挂
@deepseek-ai/dsh-tool-subagent-control(提供send_message/interrupt_agent/list_agents),不能再委派下级代理,也无法互相直连。子代理完成通知(completion notice)会自动回到主理人,无需轮询或 sleep。
5 个 Agent Preset 与 4 个委派工具
| 角色 | 花名 | config.id |
order |
主理人委派工具 |
|---|---|---|---|---|
| 主理人 / 交付总监 | 齐活林(Qi) | software-company-lead |
10 | 持有下列全部 4 个 |
| 产品经理 | 许清楚(Xu) | software-company-product-manager |
11 | delegate_to_pm |
| 架构师 | 高见远(Gao) | software-company-architect |
12 | delegate_to_architect |
| 工程师 | 寇豆码(Kou) | software-company-engineer |
13 | delegate_to_engineer |
| QA 工程师 | 严过关(Yan) | software-company-qa-engineer |
14 | delegate_to_qa |
order 使用 10-14,避开官方 standard preset 的 1。每个委派工具都是 @deepseek-ai/dsh-tool-subagent 的一个独立实例:provider: spawn、maxDepth: 1、显式 agentPreset,toolName 全局唯一。这些实例包在 delegation 的 cordis:group 里,并保留 isolate: { workflowEngine: true }。
四种工作流
| 工作流 | 判定条件 | 阶段顺序 |
|---|---|---|
| ⚡ 快速模式 | 单页面应用 / 小游戏 / 工具脚本 / ≤ 10 个源文件 | 用户需求 → delegate_to_engineer(一次性写完全部代码)→ delegate_to_qa → 交付 |
| 🔧 BugFix | 用户报告明确 Bug、非新功能 | Bug 报告 → delegate_to_engineer(定位 + 修复)→ delegate_to_qa(仅回归) |
| 🏗️ 标准 SOP | 中大型 / 多模块 / 涉及前后端 / > 10 个源文件 | PRD → 系统设计 + 任务分解 → 编码 + 全局一致性审查 → 测试 + 智能路由 |
| 📋 部分工作流 | 仅需分析 | 只分派单个成员:仅 PRD / 架构评审 / 代码实现 / 仅测试 / 市场调研 |
质量关卡:工程师完成全部文件后做 IS_PASS 全局一致性审查(最多 2 轮);QA 每轮做智能路由判定 Engineer / QA / NoOne,最多 2 轮测试。其余铁律:顺序流转、信息传递含前序完整上下文、反馈回路、语言一致性、文档化、结构化输出、增量开发支持、成员结论为准而主理人只做编排。最终交付总结必含 TL;DR / 交付概览 / 文件清单 / 用户下一步建议。
可选 Skill 安装
主理人的完整 SOP 已内联在 persona prefix 中,默认即可工作。仓库自带的 skills/software-company-sop/SKILL.md 是可选的项目级增强速查卡(路由判定表、角色与委派映射、四种工作流阶段、质量关卡、交付规范、消息中转铁律)。
插件包内的 skills/ 不会被 DSH 自动发现。@deepseek-ai/dsh-skill-filesystem 只扫描 <project>/.dsh/skills、<project>/.agents/skills、customSkillDirs 与用户目录,且只扫一层 <name>/SKILL.md。因此需要手动复制:
mkdir -p <project>/.dsh/skills
cp -r skills/software-company-sop <project>/.dsh/skills/
复制后应存在 <project>/.dsh/skills/software-company-sop/SKILL.md,模型即可通过 skill 工具按需加载。不要用 !!js 之类手段去猜插件包路径(脆弱且可能被执行策略拦截)。
用户级 $DSH_HOME/skills 与项目级 .dsh/skills 等价有效:复制到用户级目录一次即对全局所有项目生效(当前部署即用用户级)。本 bundle 不提供安装脚本(与零 scripts 契约一致)。
验证
零第三方依赖,Node 原生即可运行:
node scripts/verify.mjs
会逐项输出 PASS/FAIL 并汇总;任一项失败则退出码为 1。覆盖:package.json 字段与版本门控、files 清单、cordis.patch.yml 结构(单个 - insert:、5 个 sc- 行、行 id / config.id 唯一、agentPreset / toolName 合法、成员无委派实例)、prefix 与 agents/*.md 逐字一致、prompt 插值安全、Skill frontmatter 与长度、两份 README 的安装命令等。
组合配置自检(建议真机执行)
dsh --dump-config
核对:5 个 software-company-* preset 出现在组合后的配置树中;每个 preset 的 plugins[0] 是 @deepseek-ai/dsh-persona;只有主理人 preset 含 4 个 tool-subagent 实例;没有任何宿主已有的顶层行 id 被覆盖。因为 patch 层的 config 是整段替换而非深合并,本 bundle 只 insert 全新的 sc- 前缀行。
已知限制(如实标注)
- 真机已验证:已在 DSH NEXT 桌面端(Electron,内核
0.2.2-rc.3)实测:5 个 preset 全部加载成功,主理人 preset 的 4 个delegate_to_*工具全部可用,4 名成员均被正确委派并各自正确自报身份(齐活林 / 许清楚 / 高见远 / 寇豆码 / 严过关)。仍建议在自有宿主上跑一次dsh --dump-config复核组合配置。compatibility.json中runtimeVerification已如实记录该结果。 - 纯配置 Bundle:不提供自定义运行时工具、UI 或 JS 入口;所有能力依赖宿主 profile 自带的
@deepseek-ai/dsh-*包。 - token 开销:完整 SOP 作为 persona
prefix注入系统提示,每轮对话都会携带,会增加每轮 token 消耗。 - 消息拓扑:DSH 的
send_message只支持直接父/子通信,成员之间不能互相直连 —— 这恰好满足原 SOP「所有跨成员信息流经主理人中转」的铁律,但也意味着无法做成员间横向协商。 - 不要覆盖官方
standardpreset:本 bundle 只insert全新的sc-前缀行,不改动agent-preset-registry/system-prompt/skill-filesystem/tool-skill/agent-loop等宿主顶层行;请勿手工把它改成replace。 - 已启用工具的参数与官方 standard 对齐(工具面是刻意收窄的子集):本包启用核心编码工具;
plan/schedule/workflow刻意未启用,goal仅主理人、office仅产品经理与工程师(见上文「能力启用矩阵(0.3.0)」)。对已启用的工具,参数与官方 standard 保持一致:shell 工具按宿主平台条件禁用 ——@deepseek-ai/dsh-tool-bash在 win32 禁用、@deepseek-ai/dsh-tool-pwsh在非 win32 禁用(disabled使用!!js表达式在 patch 层求值);tool-fs关闭applyPatch、tool-fs-search关闭sampleOverCapGlobResults、tool-todo开启allowParallelInProgress、tool-web开启fetch并设searchTimeoutMs: 60000、compaction-tool-result-pruner设thresholdChars: 8192/headChars: 4096/tailChars: 1024。 - prompt 变量插值:DSH 会对 persona
prefix做变量插值,未注册变量会导致 prompt 组装失败;本包所有prefix与agents/*.md正文均已确保不含模板变量起始符(两个连续的左花括号),自定义修改时请勿引入。 - Node 门控:
engines.node: ">=24.9.0"是 DSH 0.2.2-rc.3 的要求;scripts/verify.mjs本身只用 Node 原生 API,但请在满足门控的环境运行。
目录结构
dsh-software-company/
├── package.json # 纯配置 bundle 声明 + engines 门控 + dsh.bundle.patch
├── cordis.patch.yml # 单个 - insert: 内含 5 个 Agent Preset
├── agents/ # DSH 版角色提示词(可读源,prefix 由此逐字注入)
│ ├── software-team-lead.md
│ ├── software-product-manager.md
│ ├── software-architect.md
│ ├── software-engineer.md
│ └── software-qa-engineer.md
├── skills/software-company-sop/SKILL.md # 可选项目级增强
├── scripts/verify.mjs # 零依赖静态自检
├── README.md(中文,默认首页)/ README.en.md(English)
├── compatibility.json
├── LICENSE
└── .gitignore
License
MIT © 2026 xylon-y
No comments yet. Be the first to write one.