dsh-skills Skill:DeepSeek Harness 生态的并行调度与架构治理技能包
dsh-skills 是 GitHub 用户 xu-jin-cs 开发的 DeepSeek Harness 生态专属技能包,主打「并行分身调度」和「零 LLM 消耗的架构影响面分析」两大核心能力。当前在 trending-claude-skills 活跃追踪列表中,Star 增速明显。它解决的核心痛点是:当 Agent 需要处理多个无依赖子任务时,默认串行执行浪费算力;而传统架构分析要靠 LLM 全库扫描,token 消耗惊人。dsh-skills 用确定性计算替代 LLM 猜测,把工程治理做成了可插拔的 Skill。
功能与原则
dsh-skills 包含四个核心技能,全部为标准 SKILL.md 格式,零依赖、零安装脚本,复制到技能发现根目录即生效。
parallel-dispatch(并行调度总规则):当 Agent 检测到 ≥2 个无依赖子任务时,自动并行 spawn 子分身。决策矩阵覆盖两个维度——规模轴(S/M/L 引擎档)× 数量轴(2~5 subagent 扇出 vs ≥10 workflow 编排),并内置场景自动匹配表、母体合并校验时点和禁止清单,避免分身泛滥或死锁。
archmap(架构测绘 Agent):零参数调用,自动区分 full/lite 模式。给定需求文本,输出精确到文件/函数/路由级别的代码影响面;基于确定性 AST 解析而非 LLM 猜测,显著节约 tokens。含增量 sync 模式,用于 baseline 对齐和影响面报告刷新。
gate-switch(概率执行门禁):治 LLM「该做没做 / 缺斤短两 / 伪造声称」三类顽疾。将验收条件写成 spec JSON,引擎用 7 种检查原语(file_exists / json_field / glob_count / grep_count / mtime_after / script_exit 等)逐项机械核验,A 放行 B 阻断,判定权从模型移交脚本。与 parallel-dispatch 的 dispatch_switch 互补。
pm 工作流(13 节点研发调度骨架):从 pm_bootstrap → spm → dpm → [ui_designer ∥ test_lead_design] → fe → be → pm_quality_gate → test_lead_full → ops → qa → process_audit → retro,完整覆盖需求到复盘全流程。11 个角色技能(senior-pm / frontend-dev / backend-dev / test-lead 等)随包分发,可独立安装复用。
认可度
- GitHub Stars:0(刚发布,数据尚未大规模传播)
- 定位:DeepSeek Harness 生态的工程治理技能包,Trending 追踪器(linny006/trending-claude-skills)实时监控中
- 生态背景:DeepSeek Harness 本身在 2026 年 8 月 13 日上线,当天斩获 13k+ Star,一周内突破 66k Star,成为当月最热 Agent 框架
- 差异化:不是单纯增加 Star 的 Skill,而是为 DeepSeek Harness 补工程治理短板的实用工具包
链接
GitHub:https://github.com/xu-jin-cs/dsh-skills
原作者
xu-jin-cs(GitHub username),DeepSeek Harness 生态活跃贡献者,专注于工程化治理工具的设计与分发。从仓库结构和技能描述判断,具备扎实的 Agent 工程实践经验。
介绍
dsh-skills 的核心设计理念是「确定性计算优先,LLM 只做兜底」。
parallel-dispatch 是这个包的明星技能。传统 Agent 在处理多任务时,要么单线程逐一完成(浪费并行优势),要么盲目全部并行(资源爆炸)。parallel-dispatch 引入了一个双维决策矩阵——规模轴确定每个子任务该用多重的引擎,数量轴确定总并行度——再配合禁止清单和母体合并校验,在激进并行和资源安全之间找到平衡点。安装后只需把技能目录放入 ~/.dsh/skills(DSH 原生路径)或 ~/.claude/skills(Claude Code 路径),DSH watcher 自动热加载,无需重启。
archmap 解决的是架构分析 token 消耗问题。传统做法是让 LLM 读取整个代码库再分析,成本高且结果不稳定。archmap 改用确定性 AST 解析,直接定位受影响的文件/函数/路由,输出行级 diff 影响面,不消耗模型推理 token。增量模式下可与 baseline 对齐,生成 01~09 级别的变化报告。
gate-switch 把 LLM 的「自我评估」变成「可验证的机械检查」。7 种检查原语覆盖文件存在性、JSON 字段、glob 匹配数、grep 结果数、时间戳比较和脚本退出码,足够写出一个 spec 来验证大多数工程交付标准。判定结果只有 A(通过)和 B(阻断),没有「我觉得可以」。
pm 工作流 则把整个研发流程标准化成 13 节点状态机,每个节点有明确的入口条件、出口交付物和角色归属,从根本上消除「做到一半不知道下一步是什么」的 Agent 迷途。
特点
- 零依赖、零安装脚本:纯文件形态,放入技能发现根目录即生效,DSH watcher 自动热加载
- 多 Agent 生态兼容:DeepSeek Harness / Claude Code / Kimi Code / Codex 一套格式全部通用
- 确定性执行:archmap 的 AST 分析和 gate-switch 的机械核验都不依赖 LLM,结果可复现
- 热加载:DSH 环境下无需重启,技能更新即时生效
- 可独立复用:11 个 pm 角色技能全部剥离了私有依赖,可单独安装到任何项目
- 安装脚本简洁:
curl ... | bash -s -- install <skill>一行搞定全部 - MIT License:可商用,DeepSeek Harness 生态开源协议
使用方法
安装全部技能(推荐):
curl -fsSL https://raw.githubusercontent.com/xu-jin-cs/dsh-skills/main/scripts/dsh-skill.sh | bash -s -- install --all --with-deps
安装指定技能(如 archmap):
curl -fsSL https://raw.githubusercontent.com/xu-jin-cs/dsh-skills/main/scripts/dsh-skill.sh | bash -s -- install archmap
已有仓库手动安装:
git clone https://github.com/xu-jin-cs/dsh-skills.git
cd dsh-skills
./install.sh archmap # 安装指定技能
触发 parallel-dispatch:将技能放入 ~/.dsh/skills(DSH)或 ~/.claude/skills(Claude Code),Agent 在处理多子任务场景时自动激活并行调度逻辑。
触发 archmap 影响面分析:
# full 模式(全面影响面)
python3 archmap/scripts/analyze.py --mode full "用户登录模块重构"
# lite 模式(轻量快速)
python3 archmap/scripts/analyze.py --mode lite "修复支付回调 bug"
# 增量 sync(与 baseline 对齐)
python3 archmap/scripts/analyze.py --mode sync
触发 gate-switch 验收:
# 编写 spec JSON
cat > myspec.json << 'EOF'
{
"verdict": "验收通过",
"checks": [
{"type": "file_exists", "path": "dist/index.js"},
{"type": "grep_count", "pattern": "export ", "file": "src/index.ts", "min": 3},
{"type": "script_exit", "cmd": "npm test", "expected": 0}
]
}
EOF
# 运行门禁引擎
python3 gate-switch/engine.py --spec myspec.json
使用场景与人群
适用场景:
– DeepSeek Harness / Claude Code 多任务并行处理的调度优化
– 大型代码库的架构影响面分析(尤其是 CI 流水线需要精准变更范围)
– Agent 输出质量的机械验收(不需要 LLM 主观判断)
– 中大型研发团队的多角色 PM 工作流标准化
目标用户:
– DeepSeek Harness 深度用户,需要工程治理能力
– 使用 Claude Code / Codex 处理复杂多任务项目的开发者
– 需要为 Agent 交付物设置可验证质量门槛的技术 lead
– 对 Agent 输出稳定性和可审计性有要求的企业团队
输入与输出案例
案例 1:parallel-dispatch 并行调度
输入(Agent 检测到无依赖子任务):
用户要求:同时完成 (1) 用户登录模块重写 (2) 支付回调模块重写 (3) 订单状态机重构
输出(Agent 内部决策):
[parallel-dispatch] 检测到 3 个无依赖子任务
规模轴:S 档引擎(简单重构)
数量轴:3 subagent 扇出
→ Spawn 3 subagent 并行执行
→ 母体等待全部完成 → 合并结果 → 输出最终报告
案例 2:archmap 架构影响面分析
输入:
用户输入:「重构用户权限系统,将 RBAC 改为 ABAC」
输出:
影响面分析结果(archmap, full mode)
━━━━━━━━━━━━━━━━━━━━━━━━━━━━
变更类型: 架构迁移(RBAC → ABAC)
受影响文件(12 个):
- src/auth/permission.ts [直接]
- src/auth/rbac/* [删除]
- src/auth/abac/* [新增]
- src/middleware/auth.ts [间接: 函数签名变更]
- src/models/User.ts [间接: 权限字段结构变更]
...(共 12 个)
影响函数(8 个):
- checkPermission() [需重写]
- getUserRoles() [删除]
- evaluatePolicy() [新增]
影响路由(3 个):
- POST /auth/login [中间件签名变更]
- GET /user/permissions [返回结构变更]
- POST /auth/role-assign [逻辑废弃]
Token 节省估算: ~12,000 tokens(确定性 AST vs 全库 LLM 扫描)
案例 3:gate-switch 机械验收
输入(spec JSON):
{
"verdict": "功能交付验收",
"checks": [
{"type": "file_exists", "path": "dist/bundle.js"},
{"type": "grep_count", "pattern": "export", "file": "src/index.ts", "min": 5},
{"type": "script_exit", "cmd": "npm run lint", "expected": 0},
{"type": "mtime_after", "file": "dist/bundle.js", "ref": "src/index.ts"}
]
}
输出:
gate-switch 验收结果
━━━━━━━━━━━━━━━━━━━━━━━━━━
✅ file_exists: dist/bundle.js 存在
✅ grep_count: src/index.ts 包含 7 个 export(≥ 5)
✅ script_exit: npm run lint 返回 0
✅ mtime_after: dist/bundle.js 更新于 src/index.ts 之后
结论: A(放行)—— 功能交付验收通过
评论区
登录后可评论。