dsh-plugin-lint
Installation
SKILL.md
DSH Plugin Lint
审查一个 DSH 插件是否:声明与工件一致、对 harness 的引用真实存在、契约坑已规避、文档已同步、验收证据可绑定候选。
开发与范式依据:references/dsh-plugin-development-standards.md(插件形态、分发、工具/事件/slot、client 工件契约、harness 参考文件索引)。
本技能不代替实现者。创建插件时先做设计预检,实现后回来做正式验收——审查器与生产者不混同责任。
配套文件:
config/harness-path.example.yaml→ 复制为config/harness-path.local.yaml填本地 harness 仓库路径与基线版本(§2 溯源用)templates/plugin-quality-report.md→ 正式审查的报告模板(结论带 NOT_VERIFIED 语义)
工作原则
- 先机械后语义:脚本能查的(声明/工件)不浪费人工。
- 对 harness 的每个 API/事件/slot 引用必须溯源到源码路径——不采信文档记忆,DSH 处于 rc 阶段,文档会超前或滞后于代码(实测案例:SKILL.md 写过不存在的 CLI flag、插件设计稿写过不存在的
agent/post-step事件)。 - 不采信自报 PASS;正式验收必须绑定当前 commit 的 boot 证据 + 浏览器渲染证据。
- 客观缺陷 fail-closed;无法确认的标
NOT_VERIFIED。