SuperAPI AI 工具集

skill-developer

智能体与模型

查看项目

更新于 10-16 05:06

技能介绍

用途:本技能是一份在 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/skills/skill-rules.json,定义技能触发条件、执行级别(block、suggest、warn)、文件路径 glob、内容正则与跳过条件。技能分两类:guardrail 型(enforcement 为 block,阻止编辑直至使用技能)和 domain 型(enforcement 为 suggest,提供建议性指导)。

使用方式:新建技能时在 .claude/skills/{skill-name}/SKILL.md 创建文件并写 frontmatter,名称建议小写连字符、动名词形式,描述需含全部触发关键词(最多 1024 字符),正文控制在 500 行以内。随后在 skill-rules.json 添加条目,再用 npx tsx 命令测试钩子,例如 echo '{"session_id":"test","prompt":"your test prompt"}' | npx tsx .claude/hooks/skill-activation-prompt.ts。跳过条件包括会话跟踪、文件标记 // @skip-validation 及环境变量 SKIP_SKILL_GUARDRAILS 等。

适用场景与限制:适用于搭建技能自动激活体系、编写技能规则与调试触发问题。资料同时强调记忆模式、最佳实践与测试清单,但未提供价格、平台支持范围等信息。