用途:引导创建与优化 Claude Code 技能(skills),遵循 Claude Code 官方文档的最佳实践。适用场景包括从零构建新技能、优化或审计现有技能、决定是否使用高级特性(子代理执行、hooks、动态上下文等),以及排查技能无法正常工作的问题。完整技术参考见 reference.md。
模式一:构建新技能。先做发现访谈,未完成前不要写文件。访谈用 AskUserQuestion 逐轮进行,每轮一个主题:第1轮目标与命名(小写、连字符、最多64字符);第2轮触发(2-3个自然语言短语、仅用户可调用/Claude自动调用/两者、是否接受参数);第3轮分步流程(每步由 Claude 直接做还是委派子代理或脚本、是否需对话式);第4轮输入输出与依赖;第5轮护栏与边界情况;第6轮确认,以摘要格式复述并请用户确认。若用户已提供足够上下文可跳过已回答轮次。
构建阶段:选择任务型或参考型技能;据发现配置 frontmatter(name 匹配目录名,description 用自然关键词,如有副作用设 disable-model-invocation: true,接受参数设 argument-hint,自包含可设 context: fork + agent,必要时设 model 与 allowed-tools);撰写内容按上下文、分步工作流、输出格式、注意事项结构,SKILL.md 保持在500行以内,使用 $ARGUMENTS/$N 动态输入与 !command 动态上下文注入;按需添加 reference.md、examples、scripts 等支持文件并从 SKILL.md 引用;在 CLAUDE.md 的 Active Skills 注册并在 decisions/log.md 记录;通过自然语言与 /skill-name 测试。
模式二:审计现有技能,检查 frontmatter、内容、集成与质量,并评估是否有优化空间。项目约定:技能位于 .claude/skills/[skill-name]/SKILL.md,代理位于 .claude/agents/,输出在 projects/[skill-name]/,API 密钥从 .env 读取,脚本在 scripts/[skill-name]/。注意技能描述会占用上下文预算,宜精简;/ 菜单只显示非 user-invocable: false 的技能。