- name
- analyze-skill
- description
- |
- license
- MIT
analyze-skill · 技能包拆解器
一、触发条件
当用户说以下任意一句话时启动：
- “分析技能”
- “帮我看看这个技能”
- “这个包是干嘛的”
- “拆解技能”
- “这个skill怎么用”
- “看看这个skill”
- “解读技能”
如果用户只说了触发词但没给技能包： 回复：“技能包发我一下，链接、路径或者直接拖文件都行。”
二、处理步骤（按顺序执行）
第一步：拿到技能包
用户可能给三种东西：
- 下载链接（GitHub 或 .zip 直链）
- 本地路径（如 C:/xxx/skill.zip）
- 直接上传的文件（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，并且单独成块。
四、容错汇总
| 场景 | 响应 |
|---|---|
| 用户未提供输入 | “你好像忘记把技能包给我了～ 链接、路径、或者直接把文件拖给我就行。” |
| 技能包格式不识别 | “这个包的格式有点陌生，读不出来。能告诉我它是 .zip、.yaml 还是别的什么格式吗？” |
| 说明文档缺失 | “包里没找到说明文档，只能根据配置信息来分析，步骤说明那部分可能不完整哦。” |
| 链接无法访问 | “这个链接打不开，可能需要登录或者已经失效了。能换个方式吗——比如直接把文件上传给我？” |
| 解析步骤失败 | “步骤解析这步卡住了，包内结构可能不太标准。先把能读到的部分告诉你，剩下的可以一起排查。” |
五、支持的平台
- Claude Code（命令行工具）
- OpenClaw
- ClawHub
- ClaudeSkill
触发方式：直接上传文件 / 粘贴链接 / 提供本地路径，说“帮我看看这个技能”即可启动。