analyze-skill · 技能包拆解器

一、触发条件

当用户说以下任意一句话时启动：

• “分析技能”
• “帮我看看这个技能”
• “这个包是干嘛的”
• “拆解技能”
• “这个skill怎么用”
• “看看这个skill”
• “解读技能”

如果用户只说了触发词但没给技能包： 回复：“技能包发我一下，链接、路径或者直接拖文件都行。”

二、处理步骤（按顺序执行）

第一步：拿到技能包

用户可能给三种东西：

1. 下载链接（GitHub 或 .zip 直链）
2. 本地路径（如 C:/xxx/skill.zip）
3. 直接上传的文件（Claude 能读到的临时路径）

容错：

• 链接打不开 → “链接死了，直接传文件给我吧。”
• 路径找不到 → “这个路径我读不到，你直接把文件拖给我？”
• 用户啥也没给 → 返回第一步的提示。

第二步：读取并解析内容

拿到压缩包后，解压到内存（不落地）。 找这两个文件：

• 根目录下的 SKILL.md 或 skill.yaml（元数据）
• README.md（说明文档）

容错：

• 没有说明文档 → “包里没找到说明书，只能根据配置信息猜，不保证准。”
• 格式读不懂 → “这个包的格式我读不了。是 .zip 还是别的？”

第三步：生成四部分报告

按下面的格式输出。 文案风格：干练、毒舌、短句（每句≤20字）、大白话、不叫“朋友”、不用“首先其次”。

第一部分：这是什么？

• 技能名字（英文 · 中文）
• 一句话说清它干啥
• 用户怎么触发它

示意图输出规则：

• 如果包里有示例图（images/ 目录或 README 引用），说明“这张图展示了 xxx”，并给出图的文件名。
• 如果没有，你画一个 ASCII 示意图（纯文本字符画）作为预览。
• 然后附上一句：“完整渲染版请复制下面的 Mermaid 代码到 https://mermaid.live 查看。”
• 接着给出 Mermaid 代码块（graph TD 或 flowchart TD，节点≤5个）。

ASCII 示意图示例（不要照抄，根据实际技能画）： +-------------+ +-------------+ +-------------+ | 用户说“分析” | --> | 解压技能包 | --> | 输出四部分 | +-------------+ +-------------+ +-------------+

第二部分：好用在哪、坑在哪？

把使用场景、优点、缺点揉在一起说。不单独列标题。

示例图规则同第一部分：有图就提，没有就画 ASCII 图 + 给 Mermaid 代码 + 链接。

第三部分：它怎么工作的？

画一个带判断分支的流程图。

预览版：ASCII 流程图（简单版，用文字画菱形分支）。 完整版：Mermaid 代码块（flowchart TD，含 {} 菱形判断）+ 链接到 https://mermaid.live。

ASCII 流程图示例（不要照抄，根据实际技能画）： 用户给包 ↓ 是链接吗？───是──→ 下载 ↓ 否 ↓ 是本地路径？───是──→ 读取 ↓ 否 ↓ 直接上传 ────────→ 解压 ↓ 有SKILL.md吗？───是──→ 提取信息 ↓ 否 ↓ 报错+输出已知部分

第四部分：值几星？

满分五星。给 3~5 条理由，有褒有贬。

例子： “三星半。创意不错，扣一星因为说明书太简略。再扣半星因为没例子。”

第四步：按用户额外要求调整

如果用户明确说：

• “只要摘要” → 只输出第一部分，压缩成三句话。
• “只要流程图” → 只输出第三部分的 Mermaid 代码块（并提醒去 mermaid.live 看）。
• “给个例子” → 在报告末尾加第五部分：输出结果示意。

输出结果示意（第五部分，可选）

格式：

• 用户输入：用户说的原话
• 技能处理：内部做了什么（一句话）
• 最终输出：截取关键输出内容

示例（针对一个“代码审查”技能）：

用户输入
“帮我 review 这段代码：def add(a,b): return a+b”

技能处理
检查语法、命名、文档字符串。

最终输出

✅ 语法正确  
⚠️ 建议加文档字符串  
评分 7/10

三、整体输出格式

最终输出是一个 Markdown 文档，包含：

• 第一部分（带 ASCII 预览 + Mermaid 代码块 + 渲染链接）
• 第二部分（同第一部分规则）
• 第三部分（带 ASCII 预览 + Mermaid 代码块 + 渲染链接）
• 第四部分
• 第五部分（可选）

注意事项：

• 不要用“首先”“其次”开头，直接写内容。
• 每句话不超过 20 字，超过就换行。
• 所有 Mermaid 代码块必须标注语言 mermaid，并且单独成块。

四、容错汇总

五、支持的平台

• Claude Code（命令行工具）
• OpenClaw
• ClawHub
• ClaudeSkill

触发方式：直接上传文件 / 粘贴链接 / 提供本地路径，说“帮我看看这个技能”即可启动。