# 生成技能 - 交互式技能生成器 ## 概述该技能指导用户使用顶级社区技能（obra/superpowers、Anthropic、Vercel）中经过验证的模式创建高质量的 Claude Code 技能。它提出有针对性的问题来了解需求，然后生成包含适当结构、文档和最佳实践的完整 SKILL.md 文件。 **核心原则：** 生成可靠激活、有效执行流程并有效使用上下文的技能。 ## 何时使用 **当用户要求时始终使用：** *“为[主题]创建一项技能” *“为[工作流程]生成SKILL.md” *“为我培养一项能够完成[任务]的技能” *“帮我制作一个自定义技能” *“将这些说明变成一项技能” **适用于：** * 将团队工作流程捕获为可重用的技能 * 记录方法执行（TDD、调试、代码审查） * 创建自动化技能（部署、测试、设置） * 构建特定领域的指导（架构、安全性、性能） **避免以下情况：** * 用户只需要一般帮助（而不是技能创建） * 要求太模糊，无法创造有用的技能 * 利用现有技能可以更好地解决任务 ## 技能生成过程 ### 第 1 阶段：发现 - 了解需求 **您必须通过 AskUserQuestion 收集此信息：** 1. **技能目的和触发点** * 这个技能有什么用？ * 克劳德什么时候应该激活它？ * 哪些用户短语应该触发它？ 2. **技能类型识别** * 方法论的执行？（TDD、调试过程、代码审查） * 技术实现？（项目设置、构建自动化、部署） * 基于规则的审计？（代码质量、性能、可访问性） * 自动化/集成？（浏览器测试、API 调用、CI/CD） * 参考/知识？（库模式、架构、最佳实践） 3. **内容要求** * 要合并的现有文档？ * 具体规则或清单？ * 需要代码示例吗？ * 需要脚本或自动化吗？ 4. **执行级别** * 严格的方法论和“铁律”？ * 灵活的指导和建议？ * 基于清单的验证？ **互动地问这些问题：** 使用 AskUserQuestion 工具回答以下问题：问题 1：“这项技能应该帮助完成什么任务或工作流程？” - 标题：“目的” - 选项： 1. 实施开发方法（TDD、调试、代码审查） 2. 自动化技术任务（设置、部署、测试） 3. 根据规则审核代码（性能、可访问性、安全性） 4.提供参考知识（模式、架构、API） 5. 集成外部工具（浏览器、服务、CI/CD）问题2：“什么应该触发这个技能？” - 标题：“触发器” - 选项： 1.特定用户短语（列出） 2. 文件类型或模式（例如 *.tsx 文件） 3. 项目特征（例如Next.js项目） 4. 开发阶段（例如，实现功能之前）问题三：“执法应该有多严格？” - 标题：“执行” - 选项： 1. 严格——具有强制性阶段的铁律 2. 引导式 - 带有危险信号的明确建议 3. 灵活——最佳实践和建议 4. 仅供参考 - 需要时提供信息 **继续之前验证：** * 技能目的明确 * 确定激活触发器 * 技能类型确定 * 选择的执行级别 * 用户提供任何现有文档或规则 ### 第 2 阶段：模式选择 **根据技能类型，选择适当的模式：** 图案|使用时间 |关键部分 ---|---|--- **A：方法论** | TDD、调试、代码审查、质量门 |阶段、铁律、危险信号、验证清单 **B：技术** |项目设置、构建自动化、部署 |快速启动、配置、故障排除 **C：审计** |代码质量、性能、可访问性 |规则类别、输出格式、快速参考 **D：自动化** |浏览器测试、API 集成、CI/CD |自动检测、配置、辅助功能 **E：参考** |库模式、架构、最佳实践 |核心概念、模式库、常见错误有关具有完整结构骨架的完整模式模板，请参阅 **[模式模板]()**。 **继续之前验证：** * 模式匹配技能类型 * 模式支持执行级别 * 图案包含必要的部分 ### 第三阶段：内容生成 **使用这 10 个必需组件生成 SKILL.md：** #### 1\.前言（重要） --- 名称：技能名称-kebab-case 描述：| 使用when [触发短语1]，当询问“[用户短语]”时，或当[情况]时。包括多种触发变化更好的激活。具体说明何时激活。许可证：麻省理工学院元数据：作者：[作者姓名] 版本：“1.0.0” 参数提示：<可选参数> 标签：[相关，标签，此处] hooks: # 可选：自动化触发器后工具使用： - 写入/编辑操作后的操作停止： - 会话结束前的操作 --- **必填字段：** * `name` \- kebab-case 技能标识符（在 `/skill-name` 中使用） * `description` \- 触发器丰富的激活文本（请参阅下面的最佳实践） **可选字段：** * `license` \- 许可证类型（默认：MIT） * `metadata.author` \- 创建者姓名 * `metadata.version` \- 语义版本（例如，“1.0.0”） * `metadata.argument-hint` \- 显示技能参数的提示（例如，``） * `tags` \- 分类标签数组 * `hooks` \- 自动化触发器（post_tool_use、stop 等） **描述字段最佳实践：** * 包含 3-5 个特定触发短语 * 针对情况使用“when”子句 * 包括用户语言（“当被要求‘做 X’时”） * 要具体，不要含糊 * 避免：“……的技能”（太模糊）或单一的通用描述 **挂钩字段（高级）：** 使用挂钩在特定点自动执行操作： * `post_tool_use` \- 在写入、编辑或其他工具之后运行 * `stop` \- 在会话结束之前运行（验证、清理） #### 2\.概述部分包括 1-2 句话描述以及 **核心原则** 一句话。 #### 3\.何时使用部分包括三个小节：“何时使用”（特定触发因素）、“适用于”（更广泛的用例）和“何时避免”（具有替代方案的反案例）。 #### 4\.主要内容（特定于模式）插入选定的图案结构。有关完整的骨架，请参阅 **[模式模板]()**。 #### 5\.快速参考（如果适用）添加汇总表或命令备忘单以进行快速查找。 #### 6\。危险信号（方法论技能）列出 3-5 个表明用户偏离轨道的警告信号。结尾为：“所有这些都意味着：停止。返回到第一阶段。” #### 7\.示例部分使用“”和“”标签至少包含 2 个好/坏代码比较。展示真实场景并提供清晰的解释。 #### 8\.故障排除部分包括 3-5 个常见问题，采用结构化的 **问题/原因/解决方案** 格式。 #### 9\.整合部分记录该技能的功能、它的搭配以及它的名称。 #### 10\.参考文献部分包括源链接：灵感、官方文档和社区资源。 **验证清单：** * 包含所有 10 个组件 * 丰富的触发器描述字段 * 清晰的例子以及好/坏的比较 * 基于阶段的工作流程（如果是方法论） * 故障排除部分已完成 * 记录集成点 ### 第 4 阶段：最终确定和输出 **在向用户展示技能之前：** 1. **运行质量检查表：** * 描述字段有 3 个以上的触发短语 * 概述清楚地解释了核心原理 * 示例包括好/坏比较 * 故障排除部分解决常见问题 *适合技能类型的模式 * 500行以下或使用渐进式披露 * 记录集成点 * 包含参考文献 2. **针对反模式进行验证：** * 模糊的描述（“提供测试”） * 无示例 * 缺少故障排除 * 没有明确的触发因素 *整体结构（>1000行无参考/） * 没有验证清单（方法论技能） 3. **生成文件夹结构建议：** 技能名称/ ├── SKILL.md # 核心技能（生成） ├── 参考/ # 可选：扩展文档 │ ├── 标准.md │ └──示例.md ├──scripts/ # 可选：自动化 │ ├── setup.sh │ └── 执行.sh └── lib/ # 可选：助手 └── helpers.js 4. **呈现完整输出：** * 编写完整的SKILL.md内容 * 包括文件夹结构 * 包含安装说明 * 包括使用示例 **最终验证：** * 生成完整的SKILL.md * 通过质量检查表 * 提供安装说明 * 包含使用示例 * 不存在反模式 ## 深度参考如需详细指南，请在需要时加载这些文件： * **[模式模板]()** \- 所有 5 种技能模式的完整结构模板 * **[高级主题]()** \- 多文件技能、脚本、模板、集成模式 _仅在特别需要保存上下文时加载这些。_ ## 生成期间的危险信号如果你发现自己： * **无需提问即可生成** \- 首先需要用户输入！ * **使用模糊描述字段** \- 添加特定触发器 * **跳过示例部分** \- 始终包含好/坏的示例 * **无故障排除** \- 用户会遇到问题 * **技能类型模式错误** \- 检查模式选择 * **超过 500 行，无渐进式披露** \- 分为参考/ * **没有方法技能验证清单** \- 强制执行所需 **所有这些都意味着：停止。返回到适当的阶段。** ## 生成技能的示例 ### 示例 1：方法论技能 **用户：**“创建强制执行提交消息约定的技能” * 模式 A（方法执行） * 铁律：“没有遵循格式就不能提交” * 阶段：验证、格式化、验证 * 危险信号、验证清单、好/坏提交消息示例 ### 示例 2：自动化技能 **用户：**“制定安全运行数据库迁移的技能” * 模式 D（自动化/集成） * 自动检测：数据库类型、迁移工具 * 工作流程：备份、试运行、执行、验证 * 脚本：setup.sh、migrate.sh、rollback.sh ### 示例 3：审核技巧 **用户：**“培养检查 Python 代码安全问题的技能” * 模式 C（基于规则的审核） * 规则类别：关键、高、中、低 * 输出格式：`file.py:123 CRITICAL: SQL注入风险` * 快速参考表、易受攻击的安全示例 ## 技能生成故障排除 ### 问题：用户请求太模糊 **示例：**“让我成为 React 技能” **解决方案：** 使用 AskUserQuestion 来澄清：React 的哪些方面？它应该强制执行或指导什么？应该什么时候激活？首要目标是什么？ ### 问题：技能类型不清楚 **示例：**“创建部署技能” **解决方案：** 确定它是用于脚本化部署的自动化（模式 D）、用于流程实施的方法论（模式 A）还是用于最佳实践的参考（模式 E）。问：“这应该自动部署还是指导流程？” ### 问题：生成的技能太长 **原因：** SKILL.md 中内容过多 **解决方案：** 将 SKILL.md 保持在 500 行以下。将大量内容移至参考/。使用渐进式披露模式。链接到具有清晰描述的参考文件。 ### 问题：描述不会触发激活 **原因：** 描述过于笼统 **解决方案：** 包含用户实际所说的特定短语。坏：“测试技能”。好：“在编写测试、实现 TDD、创建测试套件或被要求‘测试我的代码’或‘添加测试覆盖率’时使用” ### 问题：没有明确的例子 **原因：** 技能太抽象 **解决方案：** 始终包含至少 2 个好/坏代码比较、真实场景、前后示例以及常见用例。 ## 元：该技能的结构该技能本身遵循模式 B（技术实现）： * **阶段 1：** 发现（向用户提问） * **阶段 2：** 模式选择（将类型与结构匹配） * **阶段 3：** 内容生成（创建 SKILL.md） * **阶段 4：** 定稿（质量检查和输出） * **高级主题：** 可在[高级主题]()中找到 ## 参考文献 * [人类技能存储库]() * [obra/superpowers]() * [Vercel 代理技能]() **官方资源：** * [特工技能规范]() * [Claude 代码文档]() ## 整合 **此技能可以：** * 为任何工作流程创建自定义技能 * 将团队流程视为技能 * 扩展 Claude Code 功能 * 记录方法 **搭配：** * 现有技能为例 * 用于版本控制技能的 Git 工作流程 * 团队文档流程 **使用此技能来创建：** * 方法执行技巧 * 技术自动化技能 * 审核和验证技能 * 领域知识技能 * 工具整合能力

生成技能

包含技能