dsh-skill-authoring：DeepSeek Harness 技能开发辅助插件

前言¶

DeepSeek Harness (DSH) 的生态理念强调模块化，技能是其中的核心资产。在维护技能库时，开发者常面临文档结构不一、质量标准缺失以及命名不规范的问题。dsh-skill-authoring 插件旨在解决这些痛点，通过标准化骨架、质量门禁审计和自动校验，确保技能库的整洁与可用。

插件定位¶

这是一个由 boomzikazita 维护的 DSH 插件，用于创建和维护高质量的智能体技能。它不依赖复杂的配置，通过插件机制直接扩展 DSH 的工具集。

核心功能¶

该插件提供以下主要工具与机制：

1. skill_scaffold
   为新技能生成符合规范的 SKILL.md 骨架，包含 frontmatter、whenToUse、Boundaries、QuickRef 和 Examples 占位符，并自动创建 references/index.md。

2. skill_audit
   对现有的 SKILL.md 进行审计，对照 9 点质量门禁标准输出通过/失败状态。

3. skill_check_name
   验证技能名称是否符合 DSH 规范（正则表达式 ^[a-z0-9]+(-[a-z0-9]+)*$），仅允许小写字母、数字和连字符。

4. skill-write-guard
   安装一个写入钩子。当使用 write 或 edit 命令修改 ~/.dsh/skills/ 下的 SKILL.md 文件时，系统会自动运行审计，若未通过质量门禁则发出警告。

9 点质量门禁标准¶

插件基于 vibe-coding-cn 标准适配 DSH，具体包含以下九项检查：

1. name：符合正则且长度 ≤ 64 字符
2. description：包含“什么+何时”，长度 20–1024 字符
3. whenToUse：包含 ≥ 3 个可执行的触发条件
4. boundaries：包含 ≥ 3 个“Not For / Boundaries”声明
5. quickref：包含 1–20 个可直接复用的模式（快速参考）
6. examples：包含 ≥ 3 个端到端示例（包含 Input / Steps / Acceptance）
7. references：references/index.md 文件存在
8. verification：不确定的声明需标记来源/证据等级
9. style：采用操作手册风格（短祈使句，非文档堆砌）

安装与启用¶

插件通过 DSH 命令行安装。安装后需重启 DSH 实例以注册工具。

dsh plugin --profile web add github:boomzikazita/dsh-skill-authoring

安装完成后，请重启对应的 dsh web 实例或 profile，以确保新工具生效。

配置与依赖¶

该插件无需额外配置（cordis.patch.yml 中 config: {} 即可）。以下为运行环境说明：

• 技能目录：默认为 ~/.dsh/skills，在运行时动态获取用户主目录，无硬编码路径。
• Python 环境：插件依赖 Python 3.8+ 解释器，用于执行质量门禁引擎（scripts/skill_gate.py）。

典型用法¶

• 生成骨架：使用 skill_scaffold 命令初始化一个新技能。
• 质量检查：使用 skill_audit 检查现有技能文档是否符合 9 点标准。
• 格式校验：使用 skill_check_name 确认技能名称格式正确。
• 自动防护：在编辑技能文件时，skill-write-guard 会自动介入审计。

生态与许可¶

该插件遵循 MIT 许可证。社区目录 skillhub.cn 提供了该插件的索引页面，但插件本身与 DeepSeek / 幻方无官方从属关系。

• GitHub 地址：boomzikazita/dsh-skill-authoring
• 社区目录：dsh-skill-authoring