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 路径,把拦截规则纳入项目级策略。
使用步骤
- 在项目中规划一个新 skill,确定名称、目标触发场景与目标用户。
- 按模板创建
SKILL.md,补齐 frontmatter 字段、name、description 与分段正文。 - 在
skill-rules.json中配置 keyword、intent、file path、content pattern 四类触发规则,覆盖正反例。 - 根据需要为 PreToolUse / UserPromptSubmit / Stop 配置 hook 脚本并指定 enforcement 等级。
- 用 prompt 模板"Help me troubleshoot a Claude Code hook..."对每个规则跑真实请求测试。
- 在 PR 中附上测试样例(成功触发 / 未触发 / 拦截)作为验收证据。
- 用 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产品库
官方
由 AI 猎手自动发现
评论与建议
登录 后参与评论或提建议