skill-clarify｜Skill透视镜
一、这个 Skill 到底是什么
skill-clarify（Skill透视镜）帮助用户回答一个最基础也最容易被忽略的问题：
> 「一个 SKILL 到底是什么？」
它把任意 Skill（一个名字、一段 SKILL.md、一份功能列表、或一个模糊想法）从外到内看清楚，并进一步帮用户把它设计成一个规范、可上架、可扩展的 Skill。
它由两大前身融合而来：
- Skill解析器（skill-decoder）——负责「读懂」已有 Skill
- Skill架构师（skill-architect）——负责「设计」一个新 Skill
融合后按 先读懂 → 再设计 → 后交付 的最佳顺序，去重合并为下方 18 项有序功能。
二、适用场景（什么时候用）
- 「这个 Skill 是干什么的，能不能一句话讲清楚？」
- 「我有一个想法，怎么把它变成一个规范的 Skill？」
- 「这两个 Skill 能不能合成一个更强的？」
- 「我的 Skill 能不能直接上架 SkillHub？还差什么？」
- 「帮我写一份别人一看就懂的 Skill 说明书」
三、18 项有序功能（核心能力，可形成合力）
功能按三个阶段分层排序，前一层是后一层的基础：
阶段 1｜读懂（Decoding，继承自 skill-decoder，1–6 为识别层）
- 身份识别——提取中文名、英文名(slug)、版本、作者
- 一句话定位——用大白话讲清「它是什么」
- 取名理由解析——还原命名方式（含义/来源/组合逻辑）
- 能力分类——归入创作/分析/开发/效率/金融研究/设计等大类
- 功能清单——列出全部实际功能点并编号
- 类比解释——用一个生活例子比喻它（如「它是 XX 界的 XX」）
阶段 2｜读懂（7–12 为拆解层）
- 输入标准化——它接受什么输入（字段/类型/必填）
- 输出标准化——它产出什么（结构/字段/格式）
- 触发场景——什么时候该用它
- 目标用户——谁最适合用它
- 典型工作流——从输入到输出的标准步骤
- 依赖与前置条件——需要什么环境/数据/权限
阶段 3｜读懂（13–14 为边界层）
- 边界声明 + 风险局限——它明确不做什么、可能出错的情形
- 关系图谱——与同类 Skill 可组合 / 可替代 / 上下游关系
阶段 4｜设计（Designing，继承自 skill-architect，15–16）
- 能力全景卡生成——把 1–14 汇总成一张可读卡片（对比/体检/完整度评分）
- 需求澄清 + 能力定义——把模糊想法拆成目标/用户/场景/能力边界
阶段 5｜设计（17 为骨架层）
- 规范骨架生成——目录脚手架 + 命名规范（小写英文+中文名+SLUG）+ frontmatter + 工作流 + 输入输出契约 + 扩展点 + icon 设计指引
阶段 6｜交付（Delivering，融合核心：A + B → C）
- 融合与自检交付——吸收两个 Skill，按「去重→分层→补齐→排序→统一命名→收敛边界→连续编号→保留扩展点」的规则产出完整 Skill C，并输出上架清单（一级/二级分类、上架文案、可见性）+ 自检报告（中文名/英文名/描述/结构/禁止文件）
> 合力说明：1–14「把别人的看明白」→ 15–17「把自己的设计好」→ 18「合成一个并交付」，层层递进、缺一不可。
四、输入输出标准化（契约）
输入（Input）
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| subject | string | ✅ | 一个 SKILL 的名字 / SKILL.md 文本 / 功能列表 / 一个新想法 |
| mode | enum | ❌ | decode(仅读懂) / design(仅设计) / full(融合交付，默认) |
| refs | array | ❌ | 融合模式下的第二个 Skill（A + B → C） |
输出（Output）
| 字段 | 类型 | 说明 |
|---|---|---|
| identity | object | 中文名/英文名/slug/版本/作者 |
| one_liner | string | 一句话定位 |
| naming_reason | string | 取名理由 |
| category | object | 一级分类 + 二级分类 |
| functions | array | 有序功能清单（编号+分组） |
| input_schema | object | 输入契约 |
| output_schema | object | 输出契约 |
| boundaries | array | 边界与风险 |
| relationships | array | 与同类 Skill 的关系 |
| skeleton | object | 规范目录骨架（设计/融合时） |
| publish_checklist | object | 上架清单 + 分类 + 上架文案 |
| self_check | object | 自检报告（中文名/英文名/描述/结构/禁止文件） |
五、工作流（6 步）
- 收束输入：归一为文本，判断是「已有 Skill」还是「新想法」
- 读懂（阶段1–3）：按 1–14 逐项填写，信息不足显式标注「待确认」，绝不编造
- 生成全景卡（阶段4）：输出能力全景卡 + 完整度评分
- 设计骨架（阶段5）：若为想法或需重构，按 16–17 生成规范骨架
- 融合交付（阶段6）：若为 A+B，按融合规则产出 Skill C + 上架清单
- 自检：跑打包前自检，输出中文名/英文名/描述/结构/禁止文件清单
六、融合规则（A + B → C，有序合力）
- 去重——相同功能只保留更强的实现
- 分层——先「识别/解析」→ 再「处理/生成」→ 最后「输出/交付」
- 补齐——A 缺的能力若 B 有，则补入 C
- 排序——高频基础能力在前，扩展能力在后
- 统一命名——A/B 术语不一致时 C 采用统一命名
- 收敛边界——C 的「不做什么」合并 A 与 B 的边界
- 连续编号——C 的功能从 1 连续编号，≥15 项时分组合并
- 保留扩展点——规则/数据拆到 references/，保证可复用、可扩展
七、可复用 / 可扩展
- 规则与数据拆分到
references/下独立文件，可单独替换 - 输入/输出契约为 JSON Schema，可被其它工具消费
- 新增能力只需追加功能编号 + 对应 reference 文件
八、硬边界（安全与合规）
- 纯静态、离线可用，不调用外部 API、无外部服务强依赖
- 不读取私钥/助记词/钱包/账户凭据/
~/.ssh/~/.aws/auth.json - 不执行任何用户代码或脚本
- 不发起任何网络请求
- 仅产出 Markdown 与 JSON 规范文本
- 本 Skill 用于「理解与设计 Skill」，不构成对任何 Skill 质量的背书
九、上架建议（提交到 SkillHub 时填的文案）
中文名：Skill透视镜
SLUG（小写英文短名）：skill-clarify
版本号：1.0.0
一级分类：开发者工具
二级分类：AI Skill 设计与文档
上架文案（让用户知道它是干嘛的、什么时候用）：
> Skill透视镜（skill-clarify）帮你把一个 AI Skill「从外到内看清楚」。输入任意 Skill 的名字、SKILL.md、功能列表或一个新想法，它会先读懂它——一句话讲清它是干什么的、有哪些功能、输入输出是什么、边界在哪、和同类比如何；再帮你把它设计成一个规范、可上架、可扩展的 Skill；最后把两个 Skill 融合成一个合力更强的完整 Skill，并输出能力全景卡、规范骨架与上架自检报告。纯静态、离线可用、无需任何 API。适合：想快速理解陌生 Skill、把想法变成规范 Skill、或将两个 Skill 合并为一个更强能力的开发者与团队。
