Auto Create Skill

本 Skill 的核心能力：从对话中提取可复用的工作流，生成结构化的 Skill 文件，
让 Claude 在后续会话中能按照固定流程执行任务。

核心概念

什么是「工作流 Skill」

工作流 Skill 是一个结构化的 SKILL.md 文件，它定义了：

1. 1. 触发条件：什么场景下应该使用这个流程
2. 输入参数：用户需要提供哪些信息（如 Jira ID、分支名等）
3. 执行步骤：按顺序排列的操作步骤，每步包含：具体动作、使用的工具/MCP、

1. 4. 流程控制：条件分支、循环、用户交互点

环境检测（关键！）

在创建或更新 Skill 之前，必须先检测当前运行环境，因为不同环境的 Skill
安装路径完全不同。执行以下检测逻辑：

CODEBLOCK0

各环境的行为差异：

Claude.ai 特别注意：Claude.ai 的代码执行环境是临时沙箱，写入
/mnt/skills/user/ 的文件在会话结束后会消失。所以必须：

1. 1. 将生成的 Skill 文件输出到 /mnt/user-data/outputs/ 供用户下载
2. 使用 present_files 工具向用户展示文件下载链接
3. 明确告知用户：「请下载此文件，然后到 Customize > Skills 上传安装」

工作流 Skill 的目录结构（严格遵守！）

Claude Code 的 Skill 加载机制要求：文件必须放在以 skill 名称命名的子目录下，
文件名必须是 SKILL.md（全大写）。这不是建议，是硬性要求，否则 Claude Code
无法识别该 Skill。

正确结构（以 fix-easy-bug 为例）：
CODEBLOCK1

以下都是错误的，会导致 Skill 无法被发现：
CODEBLOCK2

创建文件时必须使用以下命令序列（不可省略 mkdir）：
CODEBLOCK3

在 Claude.ai 环境下同理：
CODEBLOCK4

注册表

所有由 auto-create-skill 创建的 Skill 都会被记录到注册表中，方便管理。
注册表路径根据环境自动选择（见上方环境检测）。

操作模式

根据用户意图，本 Skill 有三种操作模式：

模式 A：创建新 Skill（从会话或描述中提取工作流）

模式 B：更新已有 Skill（修改由本 Skill 创建的工作流）

模式 C：管理 Skill（列出、查看、删除已创建的 Skill）

模式 A：创建新 Skill

第一步：提取工作流信息

从当前会话或用户描述中，收集以下关键信息：

1. 1. Skill 名称：简洁的英文标识符（kebab-case），如 INLINECODE8
2. Skill 用途：一句话描述这个流程做什么
3. 触发场景：用户会怎样描述需要执行这个流程
4. 输入参数：用户每次需要提供的变量信息

1. 5. 执行步骤：按顺序的操作列表

1. 6. 流程分支（如果有）：不同条件走不同路径
2. 完成条件：怎样算流程执行完毕

关键原则：向用户确认你的理解是否正确，不要假设。特别关注：

• - 哪些步骤是需要用户确认的「检查点」（checkpoint）
• 哪些步骤可以自动执行无需干预
• 步骤之间的依赖关系
• 异常情况的处理方式

第二步：与用户确认工作流

用结构化的方式向用户呈现你提取到的工作流，例如：

CODEBLOCK5

请用户确认或修改后再继续。

第三步：生成 Skill 文件

用 references/workflow-skill-template.md 作为参考模板，生成 SKILL.md。

生成前请先阅读模板文件（路径根据 auto-create-skill 自身安装位置而定）：

• - Claude Code: INLINECODE10
• Claude.ai: INLINECODE11

生成 Skill 时遵循以下原则：

1. 1. YAML frontmatter 中的 description 要「积极触发」——列出所有可能的

1. 2. 输入参数段 要清晰列出所有参数，包括类型、是否必填、默认值
2. 步骤定义 要精确到可执行级别——Claude 读了就能直接按步骤操作
3. 每一步都要明确标注：

1. 5. 工具调用要写具体：不要写「使用 MCP 查询」，要写明

1. 6. 错误处理 要为关键步骤定义失败后的行为

第四步：写入文件并注册

首先执行环境检测（参见上方「环境检测」章节），确定 SKILL_DIR。

Claude Code 环境：

1. 1. 必须创建子目录，然后在子目录内创建 SKILL.md 文件（不可直接在 skills 目录下创建 .md 文件）：

CODEBLOCK7

1. 2. 更新注册表

1. 3. 告知用户：「Skill 已安装，你可以在新会话中通过 /skill 找到它，

1. 4. 创建后验证（必做）：

Claude.ai 环境：

1. 1. 将 Skill 文件写入到 INLINECODE17
2. 使用 present_files 工具向用户提供下载链接
3. 必须明确告知用户以下安装步骤：

1. 4. 同时更新沙箱内的注册表（供当前会话使用）

模式 B：更新已有 Skill

第一步：定位目标 Skill

1. 1. 先执行环境检测，确定注册表和 Skill 目录的路径
2. 运行注册表管理脚本查看所有已创建的 Skill：

1. 3. 根据用户描述匹配到目标 Skill
2. 读取该 Skill 的 SKILL.md 获取当前内容

第二步：理解修改意图

常见的修改类型：

• - 添加步骤：在指定位置插入新的操作步骤
• 删除步骤：移除某个不再需要的步骤
• 修改步骤：更改某个步骤的具体操作方式
• 调整顺序：重新排列步骤的执行顺序
• 修改参数：添加/删除/修改输入参数
• 修改触发条件：更新 description 中的触发短语
• 添加分支：增加条件判断和不同路径

第三步：向用户展示修改前后对比

用 diff 风格或并列方式展示修改前后的差异：

CODEBLOCK10

第四步：用户确认后执行修改

1. 1. 读取原始 SKILL.md
2. 按照确认的修改方案更新内容
3. 写入更新后的 SKILL.md（先备份原文件）
4. 更新注册表（如果描述或参数有变）

CODEBLOCK11

Claude.ai 环境下更新已有 Skill：由于沙箱环境限制，需要：

1. 1. 读取原始 Skill 内容（如果用户已上传，可从 /mnt/user-data/uploads/ 获取）
2. 修改后将更新版本输出到 INLINECODE23
3. 使用 present_files 提供下载
4. 告知用户在 Customize > Skills 中删除旧版本并上传新版本

模式 C：管理 Skill

列出所有 Skill

CODEBLOCK12

以友好的格式向用户展示所有已创建的 Skill，包含名称、描述、参数、创建/更新时间。

查看某个 Skill 的详情

读取并向用户展示目标 Skill 的完整工作流定义。

删除 Skill

CODEBLOCK13

同时删除对应的 Skill 目录（需要用户确认）。

生成 Skill 的质量检查清单

在生成或更新 Skill 后，对照以下清单检查：

• - [ ] 文件路径正确：确认是 <skill-name>/SKILL.md（子目录 + 全大写文件名），

• - [ ] YAML frontmatter 的 description 是否包含足够的触发短语
• [ ] 所有输入参数是否都有清晰的说明和示例
• [ ] 每一步的操作是否精确到可执行级别
• [ ] 每一步是否都标注了 [AUTO] / [CONFIRM] / [INPUT]
• [ ] 工具调用是否写明了具体的 server、方法、参数
• [ ] 关键步骤是否有错误处理
• [ ] 步骤之间的依赖关系是否合理
• [ ] 用户交互点是否合理（不会太多打断流程，也不会跳过重要确认）
• [ ] 流程的起点和终点是否清晰

重要提醒

1. 1. 文件路径是铁律：生成的 Skill 必须放在 <skill-name>/SKILL.md 子目录结构中，

1. 2. 永远先确认再执行：在创建或修改 Skill 之前，务必向用户确认你的理解
2. 保持幂等性：生成的流程应该是可重复执行的
3. 参数化一切可变项：不要硬编码，所有会变化的值都应该是参数
4. 合理设置检查点：敏感操作（如 git push、删除文件）前设置用户确认点
5. 考虑失败恢复：关键步骤要定义失败后的行为（回滚、重试、通知用户等）
6. 写给 Claude 看：生成的 SKILL.md 是给 Claude 读的指令，要精确、无歧义