dsh-skill-authoring

DSH 的技能机制里藏着不少反直觉的细节：frontmatter 多敲一个空格，技能就静默消失；rank 100 到 600 的扫描顺序决定了同名技能谁压谁；description 是唯一进模型视野的字段，写法的轻重直接决定触发是否命中。dsh-skill-authoring 把这套散落的规则收拢成一份可安装的技能，让 agent 在编写、审查和重构技能时有一本随时可查的手册，而不是靠踩坑积累经验。

技能内容覆盖了从静态到行为的完整链路。静态侧包括 frontmatter 必填与可选字段的合法写法、技能根优先级与变更检测的作用边界、description 触发线索的堆叠策略与兜底表达、300 到 500 行篇幅区间的判断标准以及 references/ 拆分的时机；配套一个零依赖的 Node 校验脚本，一次跑完 frontmatter、必填字段、文件引用、站内锚点、交叉引用和篇幅六项检查，支持 JSON 输出方便接入 CI。行为侧则给出带技能与不带技能的 A/B 对照方法，强调对比实际产物而非自我报告，并规定了派子 agent 时应当写死的纪律。

适合正在 DSH 中编写或维护技能的开发者，以及希望系统化理解 agent 技能装载机制、减少静默失效和触发遗漏的团队。