guided-skill-builder

name: guided-skill-builder description: Guide users in creating a Claude skill via point-and-click choices — no SKILL.md syntax required. Use when users say: "我想写一个 skill", "帮我做一个 skill", "怎么写/创建 skill", "I want to build/create/make a skill", "how do I write a skill", "我不会写 skill", or when they describe a repetitive workflow and ask if it can become a skill. Target: Cursor/Claude Code users who have never written a skill before. ---

Guided Skill Builder

引导没写过 skill 的技术用户，通过点选方式生成可用的 SKILL.md。目标：10 分钟内产出能跑的成品。

开始前：先判断是否需要 skill

在进入流程前，用以下标准快速判断：

• •纯知识问答（"skill 是什么"、"Claude 有什么能力"）→ 直接回答，不进入流程
• •调用外部 API / 数据库（需要 OAuth、第三方服务）→ 告知"你要的是 MCP，不是 skill"
• •一次性任务（只用一次，不会重复）→ 直接帮他做，不做成 skill

只有可重复的固定工作流才值得做成 skill。

Step 0 — 入口选择

用 AskUserQuestion 问：

"从模板开始，还是从零定制？"

选项（含 description，最多 4 个）：

• •周报生成器 — 每周把工作记录整理成结构化周报
• •代码 Review 助手 — 对 PR/代码变更做安全、风格、测试覆盖检查
• •PDF/文档总结器 — 提取文档核心内容，输出结构化摘要
• •从零定制 / 邮件助手 — 选这项后再用第二个问题细化：是邮件草拟助手，还是完全从零开始？

注意：AskUserQuestion 每题最多 4 个选项。模板超过 3 个时，把"从零定制"和末尾模板合并为一个选项，进入后再用第二个问题区分。

如果用户选了模板，直接跳到 Step 7（命名），用以下对应的预设内容，跳过 Step 1-6。

预设模板内容

description（用于 frontmatter）:
Generate structured weekly work reports. Use when users say "帮我写周报",
"整理一下这周的工作", "生成周报", "weekly report", or "总结本周".

任务说明:
帮用户把零散的本周工作记录整理成结构化周报。

操作步骤:
1. 询问本周完成了什么（流水账即可，不需要整理好）
2. 询问下周计划（可选）
3. 询问是否有问题/阻塞项（可选）
4. 生成格式化周报：## 本周工作 / ## 下周计划 / ## 问题与风险

输出格式: Markdown，含 H2 分节，适合直接粘贴到飞书/Notion/邮件。

description（用于 frontmatter）:
Review code changes for security issues, style violations, and missing tests.
Use when users say "review 这段代码", "帮我看看这个 PR", "check my code",
"audit changes before merging", "看一下这个 diff".

任务说明:
对代码变更做系统性 review，覆盖安全、风格、测试三个维度。

操作步骤:
1. 读取用户提供的代码或 diff
2. 按以下维度逐一检查：
   - 安全漏洞（注入、越权、敏感信息暴露）
   - 代码风格（命名、函数长度、重复代码）
   - 测试覆盖（关键路径是否有测试，边界 case 是否覆盖）
   - 逻辑错误（明显 bug 或边界条件遗漏）
3. 输出 review 报告，每条问题注明严重级别

输出格式: 结构化 Markdown，Critical 问题排最前，每条格式：[级别] 问题描述 + 修改建议。

description（用于 frontmatter）:
Summarize documents (PDF, Markdown, Word) into structured digests. Use when
users say "帮我总结这个文档", "读一下这个 PDF", "summarize this", "提取关键信息",
or provide a file path and ask for a summary.

任务说明:
读取文档，识别类型，提取核心内容，输出结构化摘要。

操作步骤:
1. 读取用户提供的文档（用 Read 工具）
2. 识别文档类型（报告/论文/合同/手册/其他）
3. 根据类型提取关键信息：
   - 报告类：核心结论、关键数据、行动建议
   - 论文类：研究问题、方法、结果、局限
   - 合同类：核心条款、风险点、重要截止日期
   - 其他：主要观点 + 重要细节
4. 生成结构化摘要

输出格式: Markdown，含"核心要点"（3-5 条 bullet）+ 分节详情。

description（用于 frontmatter）:
Draft professional emails based on user's intent and context. Use when users
say "帮我写封邮件", "起草邮件", "draft an email", "write an email to",
"帮我回这封邮件".

任务说明:
根据用户描述的意图、收件人、背景，起草专业得体的邮件。

操作步骤:
1. 询问：收件人是谁（职级/关系，如"我的上级"、"客户"）
2. 询问：邮件目的（请求帮助/通知进展/跟进事项/礼貌拒绝/其他）
3. 询问：需要包含的关键信息点
4. 询问：语气偏好（正式 / 友好 / 紧迫）
5. 起草完整邮件，包含 Subject 和正文

输出格式: 完整邮件（Subject 行 + 正文），中英文按用户需要。

Step 1 — Skill 类型

用 AskUserQuestion 问：

"你想做的 skill 属于哪种类型？"

选项：

• •文档/内容生成型（description: 写报告、邮件、PRD、博客等有固定格式的内容）
• •代码处理型（description: review、重构、生成测试、解释代码）
• •信息整理型（description: 总结文档、提取关键信息、归类整理）
• •工作流引导型（description: 多步交互，先问用户问题，再输出结果）
• •我也不确定（description: 让用户描述任务，由 Claude 帮判断类型后继续）

如果选"我也不确定"：让用户描述想做的事，你判断出类型后继续下一步。

Step 2 — 触发时机

用 AskUserQuestion 问：

"用户在什么情况下会用到这个 skill？"

选项（含对 description 的影响说明）：

• •用户主动说要做这件事（description: 高频明确指令，如"帮我写周报"——列出用户的原话关键词）
• •描述场景时自动触发（description: 场景关键词匹配，如"这周工作比较乱"——列出场景词）
• •特定文件类型出现时（description: 说明文件类型，如"提供 .pdf 文件时"）

Step 3 — 需要哪些能力（多选）

用 AskUserQuestion（multiSelect: true）问：

"这个 skill 需要做什么操作？"

选项：

• •读取本地文件（用户提供路径或粘贴内容）
• •写入/生成文件（在本地创建或修改文件）
• •调用网络搜索（需要查最新信息）
• •调用其他 MCP / 工具（已有的 MCP 服务）
• •纯文本输出，不碰文件（只在对话里回复）

Step 4 — 输出格式

用 AskUserQuestion 问：

"最终交付的形式是什么？"

选项：

• •Markdown 文档（.md 文件，或对话里的格式化内容）
• •代码文件（.py / .js / .ts 等）
• •多文件项目（含目录结构的多个文件）
• •只在对话里回复（不生成任何文件）
• •特定格式文件（docx/pptx/xlsx，需配合其他 skill）

Step 5 — 风格约束（多选，可跳过）

用 AskUserQuestion（multiSelect: true）问：

"有什么必须遵守的规则？"（可多选，也可直接跳过）

选项：

• •简洁直接，不废话
• •中文优先（description 也加中文关键词）
• •必须引用来源（注明文件名或链接）
• •必须先问清楚再动手（不默认假设）
• •一次性产出，不要反复确认

Step 6 — 真实触发场景（free-text）

直接在对话里问（不用 AskUserQuestion）：

"给我 3 个真实例子：用户会怎么跟 Claude 开口，让它用这个 skill？"

给用户看这个示范：

好例子（用日常说话方式）：
  "帮我把这周的工作记录整理成周报"
  "把这个 PDF 的核心内容提炼出来"
  "review 一下这段代码，找找有没有安全问题"

坏例子（太抽象，Claude 不容易识别）：
  "生成周报文档"
  "文档摘要功能"
  "代码审查"

这 3 个例子直接用于组装 description 里的触发关键词，省不掉。

Step 7 — 命名

基于前面的选择，给出 2-3 个候选名字（用 AskUserQuestion），或让用户自己输入。

命名规范：

• •小写、连字符分隔：review-pr、weekly-report、summarize-doc
• •动词开头更好：review-pr 优于 pr-reviewer
• •不超过 4 个词

最终组装规则

根据步骤选择，按以下规则拼装完整 SKILL.md。

description 组装

[Step 1 的功能描述，动词开头，一句话].
Use when users say: [Step 6 的 3 个例句提取的关键词，逗号分隔].
[如果 Step 2 是"描述场景触发"：加上 "Also triggers when users describe [场景描述]"]
[如果 Step 5 选了"中文优先"：同样的关键词再补一遍中文版]

示例输出：

Summarize documents (PDF, Markdown, Word) into structured digests.
Use when users say: "帮我总结这个文档", "读一下这个文件",
"summarize this", "提取关键信息", or provide a file and ask for a summary.

SKILL.md 正文结构

# [Skill 名称]

[Step 1 类型对应的一句话任务描述]

## 何时触发
- [Step 6 的 3 个例句，变成 bullet list]
- [Step 2 补充的触发条件]

## 何时不用
[根据 Step 1 类型自动填入边界条件，见下表]

## 操作步骤
[根据 Step 2、3、4 组合出具体步骤，见下表]

## 输出格式
[Step 4 的选择] + [Step 5 的约束条件]

边界条件参考（根据 Step 1 类型填入）

操作步骤组装参考（根据 Step 3 选择）

预览与调整

组装完成后，以代码块形式展示完整 SKILL.md，然后给用户两个选项（用 AskUserQuestion）：

• •看起来不错，帮我创建文件 → 进入"文件交付"
• •我想修改某一步 → 让用户选回到 Step 0-7 的哪一步

文件交付

用户确认后，在当前目录（或用户指定目录）创建：

<skill-name>/
  SKILL.md

然后告诉用户：

你的 skill 已创建好，路径：./<skill-name>/SKILL.md

安装步骤：
1. 把 <skill-name>/ 整个文件夹拷到 ~/.claude/skills/
2. 重启 Claude Code（或重新打开项目）

测试方法：
用这句话测试是否触发：[Step 6 里的第一个例句]

如果没触发，检查：
- description 里的关键词是否和你实际说的话匹配？
- 有没有拼写错误或遗漏关键词？

description 反例库（组装时用于校对）

核心原则：description 是给 Claude 做意图分类用的，不是给人看的产品介绍。写"用户说什么时触发"，不写"这个 skill 是什么"。