SuperAPI AI 工具集

skill-developer

通用与其它

查看项目

更新于 10-16 05:51

技能介绍

用途:该技能用于在 Claude Code 中创建和管理技能(skills),遵循 Anthropic 官方最佳实践,包括 500 行规则与渐进式披露模式。当涉及创建或新增技能、修改技能触发条件与规则、理解技能激活机制、调试激活问题、操作 skill-rules.json、钩子机制、YAML frontmatter 等主题时自动激活。

主要能力:介绍双钩子架构——UserPromptSubmit 钩子(.claude/hooks/skill-activation-prompt.ts,在 Claude 看到提示前,依据关键词与意图模式注入技能提醒)与 Stop 钩子(.claude/hooks/error-handling-reminder.ts,在回答结束后分析已编辑文件并给出错误处理提醒)。区分两类技能:guardrail 型(enforcement 为 block,阻断编辑直至使用技能)与 domain 型(enforcement 为 suggest,提供顾问式指引)。支持关键词、意图正则、文件路径 glob、文件内容正则四类触发,以及会话跟踪、// @skip-validation 标记、环境变量等跳过条件。

使用方式:在 .claude/skills/{skill-name}/SKILL.md 创建带 frontmatter 的技能文件,再向 .claude/skills/skill-rules.json 添加条目,然后用命令测试触发,如 echo '{"session_id":"test","prompt":"your test prompt"}' | npx tsx .claude/hooks/skill-activation-prompt.ts,或 cat <<'EOF' | npx tsx .claude/hooks/skill-verification-guard.ts 并传入 {"session_id":"test","tool_name":"Edit","tool_input":{"file_path":"test.ts"}}。全局禁用可用 export SKIP_SKILL_GUARDRAILS=true。

适用场景:编写 Claude Code 技能与规则、需要自动建议相关技能、为高风险操作设置阻断式守卫、撰写领域最佳实践文档。

限制:需要 Claude Code 环境与 TypeScript(npx tsx);SKILL.md 应控制在 500 行内;参考文件超过 100 行需加目录;block 级仅用于关键场景;跳过标记不宜滥用。具体支持版本、性能数值等资料未提供。