SuperAPI AI 工具集

skill-developer

通用与其它

查看项目

更新于 10-16 04:32

技能介绍

用途:本技能为在 Claude Code 中创建和管理技能提供完整指南,覆盖自动激活系统与 Anthropic 官方最佳实践(500 行规则、渐进式披露)。当用户提及创建/添加技能、修改技能触发或规则、理解技能激活机制、调试激活问题、操作 skill-rules.json、钩子系统机制、渐进式披露、YAML frontmatter、500 行规则等话题时自动激活。

系统架构:采用双钩子架构。UserPromptSubmit 钩子(.claude/hooks/skill-activation-prompt.ts)在 Claude 看到用户提示前触发,依据关键词与意图模式注入格式化的技能提醒作为上下文;Stop 钩子(.claude/hooks/error-handling-reminder.ts)在 Claude 完成响应后触发,分析被编辑文件中的风险模式,给出非阻塞的错误处理温和提醒。配置文件位于 .claude/skills/skill-rules.json,定义技能及其触发条件、执行级别(block、suggest、warn)、文件路径模式(glob)、内容检测模式(regex)和跳过条件。

技能类型:护栏技能(guardrail,enforcement 为 block,优先级 critical/high)在技能被使用前阻止文件编辑,防止常见错误,具备会话感知,例如数据库列名验证;领域技能(domain,enforcement 为 suggest)提供某领域综合指导,为建议性而非强制,例如后端/前端开发指南、错误追踪。

创建步骤:一、在 .claude/skills/{skill-name}/SKILL.md 创建技能文件,frontmatter 含 name 与 description(后者需含触发关键词,上限 1024 字符),正文含 Purpose、When to Use、Key Information;二、在 skill-rules.json 添加条目,含 type、enforcement、priority、promptTriggers 的关键词与意图模式;三、用 npx tsx 命令测试触发器;四、根据测试精简模式;五、遵循 Anthropic 最佳实践,保持 SKILL.md 在 500 行以内。

执行级别:BLOCK 通过钩子退出码 2 与 stderr 物理阻止 Edit/Write,仅用于关键错误、数据完整性与安全问题;SUGGEST 在提示前注入提醒,供参考不强制执行;WARN 为低优先级建议,较少使用。

跳过条件:会话跟踪(防止同一会话重复提示,状态存于 .claude/hooks/state/skills-used-{session_id}.json)、文件标记 // @skip-validation(永久跳过,需谨慎使用)、环境变量(SKIP_SKILL_GUARDRAILS 全局禁用,SKIP_DB_VERIFICATION、SKIP_ERROR_REMINDER 按技能禁用)。

限制与注意:文档要求进行真实场景测试并验证 JSON 语法;未提供具体收费、平台支持范围或性能基准之外的信息,此类细节暂未提供。