dsh-skill-authoring：DSH 技能编写与校验插件

前言¶

DSH（DeepSeek Harness）的理念是「一切皆插件」。编写和维护技能是构建智能体的核心工作流。在编写过程中，frontmatter 规范、技能触发面、篇幅控制以及行为验证是常见痛点。dsh-skill-authoring 插件通过将一套规范技能打包进 DSH 插件体系，解决了技能编写、审查与验证的问题。

插件简介¶

这是一个 DSH 插件。安装时，它把包内的 skills/ 注册为一个技能根。这意味着这份技能会随插件进入 agent 的技能目录。

核心能力¶

该插件提供的技能覆盖以下几个维度：

1. frontmatter 规范
   定义必填 / 可选字段、布尔字段的合法写法，以及「一个字符写错就让技能静默消失」的机制。

2. 技能根与优先级
   说明 rank 100–600 的扫描顺序、同名技能怎么靠项目级根覆盖用户级根，以及变更检测管到哪一层。

3. description 写触发面
   解释为什么只有它进模型视野，触发线索该怎么堆，边界与兜底怎么写。

4. 篇幅与拆分
   指导将技能控制在 300–500 行的目标区间，明确什么时候该拆 references/，什么情况不该为数字硬拆。

5. 静态校验
   提供 scripts/check-skill.js 脚本，一次检查 frontmatter、必填字段、文件引用、站内锚点、§N 交叉引用和篇幅。脚本可传技能目录或技能根目录，支持 --json。

6. 行为验证
   展示如何做带技能与不带技能做同一件事的 A/B 对照，对比产物而不是对比自我报告，以及派子 agent 时该写死的纪律。

安装与启用¶

在 DSH 环境中执行以下命令安装插件。安装后，包内的 skills/ 目录会被注册为技能根。

dsh plugin --profile web add dsh-skill-authoring

典型用法¶

静态校验脚本是零依赖的 Node 脚本，可以脱离 DSH 直接运行。

node skills/dsh-skill-authoring/scripts/check-skill.js <技能目录>

注意事项¶

• 该插件以当前 DSH 进程的权限运行，安装前应检查源码与许可证。
• scripts/package.json 中指定了 type 为 commonjs，用于兼容 module 包环境，确保脚本在包内能正常执行。