技能开发者

人工智能 社区

技能解读

当前原文的自动摘译,尚未人工审校。

目的

使用自动激活系统在 Claude Code 中创建和管理技能的综合指南,遵循 Anthropic 的官方最佳实践,包括 500 行规则和渐进式披露模式。

何时使用此技能

当您提及以下内容时自动激活: 创建或添加技能 修改技能触发器或规则 了解技能激活的工作原理 调试技能激活问题

二钩架构

  1. UserPromptSubmit Hook(主动建议) 文件:.claude/hooks/skill-activation-prompt.ts 触发器:Claude 看到用户提示之前 目的:根据关键字 + 意图模式建议相关技能 方法:将格式化提醒作为上下文注入(stdout → Claude 的输入)

配置文件

位置:.claude/skills/skill-rules.json 定义:所有技能及其触发条件 执行级别(阻止、建议、警告) 文件路径模式(全局)

1.护栏技巧

目的:强制执行防止错误的关键最佳实践 特征:类型:"guardrail" 强制执行:"block" 优先级:"critical" 或 "high"

流狐档案 运行与权限由流狐静态检查推断,不代表作者声明或实际测试结果。
领域
人工智能
作者声明的智能体
未找到明确声明;不据此推断已兼容或已测试
静态检查
88 / 100 · 启发式扫描,不代表运行安全
运行环境证据
未执行;当前没有隔离运行测试证据
作者 / 版本 / 许可证
@Microck · 未声明许可证
上下文用量评级
中等消耗
接入复杂程度
需简单配置
是否需要外部接口密钥
不需要
兼容的系统
macOS · Linux · Windows
运行环境要求
Node.js
检测到的文件与系统行为
  • 只读
  • 允许写入 / 修改
  • 命令执行
  • 读取环境变量
网络行为
仅限本地
安装命令数
无(仅作为资料)

需要注意: 未声明工具权限范围;实际权限由运行环境决定。

01
第1步:创建技能文件

位置:`.claude/skills/{skill-name}/SKILL.md` 模板:最佳实践: ✅ 名称:首选小写字母、连字符、动名词形式(动词 + -ing) ✅ 描述:包括所有触发关键字/短语(最多 1024 个字符)

02
第2步:添加到skill-rules.json

请参阅 SKILL_RULES_REFERENCE.md 了解完整架构。基本模板:

03
第 3 步:测试触发器

测试 UserPromptSubmit: 测试 PreToolUse:

04
第四步:细化模式

基于测试: 添加缺失的关键字 优化意图模式以减少误报 调整文件路径模式 根据实际文件测试内容模式

05
第 5 步:遵循人择最佳实践

✅ 将 SKILL.md 保持在 500 行以下 ✅ 对参考文件使用渐进式披露 ✅ 将目录添加到超过 100 行的参考文件中 ✅ 使用触发关键字编写详细描述 ✅ 在记录之前使用 3 个以上的真实场景进行测试

讨论

基于 GitHub Discussions。登录 GitHub 即可参与讨论、点赞、订阅更新。