用途:在 Claude Code 中创建和管理技能,遵循 Anthropic 官方最佳实践(500 行规则、渐进式披露)。当涉及创建或添加技能、修改技能触发或规则、理解技能激活机制、调试激活问题、处理 skill-rules.json、钩子机制、YAML frontmatter 等话题时自动激活。
主要能力: 1)钩子架构(五条已接入钩子)。UserPromptSubmit(.claude/hooks/skill-activation-prompt.ts):在 Claude 看到用户提示前,根据关键词与意图模式(正则或可选 AI 分类)注入技能建议;仅 enforcement 为 block 的技能标记为强制,suggest/warn 始终只是建议。PreToolUse 技能验证守卫(.claude/hooks/skill-verification-guard.ts):在 Edit/MultiEdit/Write 执行前强制执行强制技能激活(两次尝试模型),并检查文件/内容模式,可选 AI 编辑分析,通过 exit code 2 + stderr 阻断。PostToolUse 编辑追踪(post-tool-use-tracker.sh):跟踪被编辑文件与仓库。PostToolUse 技能激活追踪(skill-activation-tracker.ts):Skill 工具运行后清除待激活列表,使守卫停止阻断。Stop 会话文档更新(session-doc-updater.ts):为向量检索索引开发文档并清理过期会话状态。另有 error-handling-reminder.ts(可选,默认未接入)。 2)配置:.claude/skills/skill-rules.json,定义技能与触发条件、enforcement 级别(block、suggest、warn)、文件路径模式、内容正则与跳过条件。 3)技能类型:护栏型(guardrail,block,critical/high,在技能使用前阻断文件编辑)与领域型(domain,suggest,提供综合指导)。
使用方式: 创建技能:在 .claude/skills/{skill-name}/SKILL.md 写含 frontmatter(name、description)的内容,向 skill-rules.json 添加条目,再测试触发。测试命令示例:echo '{"session_id":"test","prompt":"your test prompt"}' | npx tsx .claude/hooks/skill-activation-prompt.ts ;PreToolUse 测试:cat <<'EOF' | npx tsx .claude/hooks/skill-verification-guard.ts 并传入 {"session_id":"test","tool_name":"Edit","tool_input":{"file_path":"test.ts"}}。可用 jq . skill-rules.json 校验 JSON。
跳过条件:会话追踪(同一会话第二次编辑放行,状态文件 .claude/hooks/state/skills-used-{session_id}.json);文件标记 // @skip-validation;环境变量 SKIP_MANDATORY_SKILLS=true、SKIP_PRETOOLUSE_AI=true,以及每技能 envOverride(如 SKIP_FRONTEND_GUIDELINES、SKIP_ERROR_REMINDER)。
适用场景:需要深度领域指导、最佳实践或强制关键规则的 Claude Code 工作流。
限制:仅提供方法与配置说明,未提供具体收费或平台信息;部分内容(如数据库校验技能)在资料中标注为假设性示例,需自行设计;性能要求建议在 100ms 或 200ms 以内。