Dimon94 Skill Developer Skill 技能

Claude Code Skill 可靠写法手册(含 Hook 调试)

Dimon94 Skill Developer 是面向 Claude Code 的可靠型 Skill 编写手册,重点解决"skill 触发规则模糊、hook 注册失败、调试路径缺失"等问题。它把 skill 文件结构、frontmatter 规则、Hook 行为、调试清单整合到一份结构化模板中,适合希望长期维护 skill 库的工程团队。

核心能力

  • SKILL.md 结构拆解:覆盖 frontmatter 字段、命名规则、目录组织与渐进式披露(progressive disclosure)。
  • 触发器配置详解:分别说明 keyword、intent、file path、content pattern 四类规则的适用场景与误触发风险。
  • Hook 行为文档化:把 UserPromptSubmit(建议)、PreToolUse(拦截)、Stop(提醒)三阶段行为写成模板。
  • 测试与调试 checklist:列出 hook 激活、JSON 校验、规则回放等本地测试命令,方便 CI 集成。
  • 激活故障排查:覆盖未触发、误触发、规则文件失效、hook 注册失败、性能瓶颈等典型场景。
  • 500 行原则与渐进披露:指导把详细资料拆到第一层 reference 文件,保持 SKILL.md 简洁可扫读。
  • guardrail 分级建议:建议根据风险等级选择 suggest / warn / block 三种拦截强度。

安装配置

  • 通过 npm 安装:npx skillstore add dimon94/skill-developer,加载后即可按提示使用。
  • 把 skills/skill-developer/ 复制到项目内 .claude/skills/,让团队成员共享同一份模板。
  • 配合项目中的 hook 配置脚本,在 CI 中跑触发规则回放测试。

使用步骤

  1. 列出待创建的 skill 主题、目标用户与典型触发语句,按 frontmatter 规则写好 name 与 description。
  2. 在 skill-rules.json 中配置 keyword、intent、file path、content pattern 四类触发器,覆盖正反例。
  3. 选择是否需要 PreToolUse / UserPromptSubmit / Stop 阶段的 hook,并按风险等级决定 enforcement 强度。
  4. 准备正负向测试样本,每个 trigger 都用真实 prompt / 文件路径跑一遍激活验证。
  5. 用 prompt 模板"Troubleshoot why my Claude Code skill hook did not activate..."诊断未触发原因。
  6. 把 SKILL.md 与 reference 文件分层组织,确保主体文件在 500 行以内,详情下沉到引用文件。
  7. 把测试结果与 guardrail 等级说明附在 PR 描述里,便于团队 reviewer 决策。

适用场景

  • 给团队交付统一规范的 Claude Code skill 库,避免每个贡献者自由发挥。
  • 配置高风险操作的硬拦截(删除生产数据、修改凭据、合并到主分支等)。
  • 把过去散落在 Confluence 的 prompt 模板迁移为 agent 可加载的 skill。
  • 排查既有 skill 的误触发 / 未触发问题,提升触发规则的稳定性。
  • 在 monorepo 多子项目环境下,给每个子项目配置特定 file path 触发器。

适用人群

  • 维护 Claude Code skill 库的 DevTools 工程师与平台 SRE。
  • 需要把 AI 工具落到生产流程的 Tech Lead 与架构师。
  • 编写安全 guardrail 的安全工程与合规岗位人员。
  • 评估与审阅第三方 skill 的 Maintainer 与 Reviewer。
  • 把 AI 工作流"制度化"的独立开发者。

工作原理

Claude Code 在用户输入或工具调用前扫描 .claude/skills/ 目录下的 SKILL.md 与 skill-rules.json,先用 description 做语义匹配,再用 keyword / intent / file path / content pattern 做精确触发;匹配命中后将 SKILL.md 注入上下文并按需触发对应 hook。该 skill 通过固化 trigger 模板、hook 编排模板与测试 checklist,让开发者按"先触发规则、再 hook 编排、最后验证"的顺序交付符合 Claude Code 加载规范的 skill 集合。

官方链接

团队信息

由 AI 猎手自动发现

评论与建议

0 条评论