Sickn33 Skill Developer Skill 技能

Claude Code Skill 工程化模板(触发/钩子/测试)

Sickn33 Skill Developer 是面向 Claude Code 开发者的 Skill 工程化模板,专门解决"写出来的 skill 偶尔触发、偶尔误触发、不可控"的问题。它把 skill 文件结构、触发规则、Hook 行为、测试命令整合成一份可复用的操作手册,帮助团队把 AI skill 当成正式交付物来管理。

核心能力

  • SKILL.md 结构规范:解释 frontmatter 字段、命名规则、500 行文档上限以及参考文件分层组织方式。
  • skill-rules.json 配置:展示 keyword、intent regex、file path、content pattern 四类触发器的最佳实践。
  • Hook 行为说明:覆盖 UserPromptSubmit(建议)、PreToolUse(拦截)、Stop(提醒)三类事件的合理使用边界。
  • 测试命令清单:提供钩子激活测试、JSON 校验、触发调试等本地命令模板,便于 CI 集成。
  • skip 条件与会话追踪:列出临时跳过、永久跳过、会话级跳过的差异以及推荐用途。
  • 误触发排查:给出 false positive 的常见成因(关键词过宽、文件路径误匹配、跳过标记滥用等)。
  • guardrail 设计:指导团队选择 suggest / warn / block 三种拦截等级,权衡用户体验与风险控制。

安装配置

  • 通过 npm 安装:npx skillstore add sickn33/skill-developer,加载后即可在 Claude Code 中按提示调用。
  • 将 skills/skill-developer/ 目录复制到项目内的 .claude/skills/ 下,便于团队成员共享同一份规则。
  • 配合 Claude Code 的 settings.json 配置 hook 路径,把拦截规则纳入项目级策略。

使用步骤

  1. 在项目中规划一个新 skill,确定名称、目标触发场景与目标用户。
  2. 按模板创建 SKILL.md,补齐 frontmatter 字段、name、description 与分段正文。
  3. 在 skill-rules.json 中配置 keyword、intent、file path、content pattern 四类触发规则,覆盖正反例。
  4. 根据需要为 PreToolUse / UserPromptSubmit / Stop 配置 hook 脚本并指定 enforcement 等级。
  5. 用 prompt 模板"Help me troubleshoot a Claude Code hook..."对每个规则跑真实请求测试。
  6. 在 PR 中附上测试样例(成功触发 / 未触发 / 拦截)作为验收证据。
  7. 用 checklist 复核文档长度、参考文件粒度、跳过标记是否过度使用,再合并发布。

适用场景

  • 给团队引入 Claude Code 时统一 skill 写作规范,避免每个贡献者自由发挥。
  • 为高风险操作(删库、生产部署、密钥写入)配置 PreToolUse block 级别的硬拦截。
  • 把过去散落在 Confluence 的 prompt 模板迁移为可被 agent 自动加载的 skill 库。
  • 在 monorepo 中给不同子项目分别配置特定 file path 触发器,避免相互干扰。
  • 审阅开源 skill 时判断其触发规则的合理性与抗误触发能力。

适用人群

  • 负责 Claude Code 平台接入的 DevTools / Platform Engineer。
  • 需要为团队编写 guardrail 的安全工程与合规岗位人员。
  • 维护开源 skill 仓库的 Maintainer 与贡献者。
  • 正在评估 Claude Code 风险控制能力的技术决策者。

工作原理

Claude Code 在每次用户输入或工具调用前都会扫描 .claude/skills/ 下的目录与 skill-rules.json 规则文件,先用 description 做语义匹配,再用 keyword、intent、file path 等做精确触发;匹配命中后把 SKILL.md 内容注入上下文并执行对应 hook。该 skill 通过固化 trigger 配置模板、hook 编排方式与测试命令,让开发者能够批量、稳定地交付符合 Claude Code 加载规范的 skill 集合。

官方链接

团队信息

由 AI 猎手自动发现

评论与建议

0 条评论