用途:该技能是创建与管理 Claude Code 技能的元指南,适用于在 HASH 仓库中新增技能、修改技能触发规则、理解技能激活机制、排查激活问题,以及处理 skill-rules.json、钩子系统、YAML frontmatter、渐进式披露和 500 行规则等主题。
主要能力:说明技能激活系统由 UserPromptSubmit 钩子(.claude/hooks/skill-activation-prompt.ts)在 Claude 看到用户提示前,根据关键词与意图模式注入相关技能提醒;配置集中在 .claude/skills/skill-rules.json,定义技能、触发条件、执行级别(当前仅实现 suggest)、关键词触发(子串匹配)与意图模式触发(正则)。技能类型目前为 domain 技能,执行级别为建议性、非阻塞。
使用方式:新建技能时在 .claude/skills/{skill-name}/SKILL.md 编写带 name 与 description 的 frontmatter,并在 skill-rules.json 添加条目;随后用 yarn lint:skill 校验配置,用 yarn workspace @local/claude-hooks run:skill 或 dev:skill 测试与调试匹配逻辑,必要时设置 SKILL_DEBUG=true。
适用场景:需要为特定领域提供深度指导、最佳实践文档、架构模式或操作指南时。
限制:block 与 warn 执行级别、文件路径与内容模式触发、PreToolUse 钩子及会话状态管理均仅在设计或文档中,尚未实现;技能文件应保持在 500 行以内,超过 100 行的参考文件需加目录。