前言¶
写一个 Skill 常见的问题不是不会写 SKILL.md，而是开工前没想清楚：这个技能解决什么问题、输入输出是什么、目录怎么搭、边界在哪。于是写到一半发现结构不对，返工成本高；交付后也无法判断它到底”行不行”。
下面介绍的 高质量skill设计指南 就是用来在动手之前把这件事想清楚的。它属于设计阶段工具，产出蓝图与结构约定，真正的施工落地交给同系列的 skill-creator。
这是什么¶
高质量skill设计指南（坐标 @user_814dbe54/high-quality-skill-guidance）是 SkillHub 社区发布者 user_814dbe54 维护的一个 Skill，版本 3.1.1，分类 ai-agent。
它解决的问题是：把”我想让 AI 会做 XX”这种模糊念头，转成一份可执行、可检查的 Skill 设计文档。核心思路是先做设计，再做施工——本 Skill 出蓝图（brief），施工交给 skill-creator，两者分工。
它明确不做的事有：不负责安装/推荐/管理已装 Skill，不负责搜索发现 Skill（那是 find-skills 类的事），不做优秀 Skill 的拆解提炼（那是 skill-rebuild 的事），也不讲纯设计理论。
核心功能¶
下面按资料中给出的能力逐条说明。
1. 10 格积木链设计流
用 10 个环节的积木链把模糊念头一步步落成可链接、可复用、可衡量、可演进的 Skill。输出物是技能蓝图 + 文件结构图，其中文件结构图附带 7 套框架范例，用来对照目录怎么搭。
2. 五维就绪度打分
蓝图产出后，对 Skill 做五维就绪度打分，用来回答”这个技能现在合格不合格、哪里不合格”。
3. 测试打磨闭环
打分之后进入测试与打磨循环，直到就绪度达标。
4. 四步施工流
设计阶段拆成四步：意图路由 + 10 格流水线 → 概念讨论 → 初步方案 → 深化设计 → 施工蓝图。意图路由的作用是先判断这次该走哪条路径。
5. 轻量通道
赶时间可以走轻量通道，官方说明约 30 分钟出蓝图。
6. 零技术门槛
直接说需求即可开工，不需要用户自己提供技术方案。
安装与启用¶
安装数据在资料中显示为安装 0 次，说明它主要作为设计指引类 Skill 使用。
按 SkillHub 通用方式，需要先在 skillhub.cn 上找到该 Skill 页面，再按平台提示安装。坐标为：
@user_814dbe54/high-quality-skill-guidance
官方地址：
https://api.skillhub.cn/user_814dbe54/high-quality-skill-guidance
SkillHub 页面：
https://www.skillhub.cn/skills/user_814dbe54/high-quality-skill-guidance
关于 Cursor / Codex CLI / Claude Code 的差异化安装命令，资料中未提供，这里不写，请以 SkillHub 页面上的最新说明为准。
资料中标注 requires_api_key=false，即不需要额外 API Key。
典型用法¶
下面这些触发场景来自官方资料中给出的 Use when 描述，可以直接用自然语言触发。
想创建或设计一个 Skill
创建 skill
设计 skill
怎么写好一个 skill
我想创建一个 XXX 技能
skill 怎么设计
skill 目录怎么搭
SKILL.md 该写什么
英文用户
create / build / design / improve a skill
已经用 skill-creator 在写改，想先把关
直接说明你已有的方案，让它按蓝图要求审查，再决定是否返工。
想给已有 Skill 打分体检
给我的 skill 打个分
体检 skill
这个 skill 哪里不合格
想让 AI 学会做某件具体的事（即使没提”技能”）
资料中特别说明：只要用户想创建/设计/改进任何 Skill，即使没明确说”做技能”，也要用这个 Skill。例如：
把这件事教给 AI
让 AI 更会做 XX
帮我把这个流程固化下来
与 skill-creator 搭配
用 skill-creator 做施工落地，本 Skill 负责先出蓝图、做把关。
与 skill-rebuild 搭配
吸收重构结果后”入库”时使用本 Skill（”吸收结果落库”）。
语言
中文提问即中文引导，术语保留英文；英文用户走英文引导。
适用场景与注意¶
适合谁
- 准备新建 Skill、但还没想清楚结构与边界的开发者
- 已经写了 Skill、想先打分体检再交付的人
- 用
skill-creator施工、希望上游先有一份蓝图的人 - 想把某个重复流程固化成可复用 Skill 的人
不适合的场景
资料中明确列出的 Do NOT use 场景：
- 安装 / 推荐 / 管理已装 Skill
- 找 / 发现 / 搜索 Skill（交给
find-skills类） - 吸收优秀 Skill 的拆解提炼（”这个 skill 很好你学一下” →
skill-rebuild，本 Skill 只做入库） - 一次性脚本或无复用价值的单点小助手
- 纯学 Skill 设计理论（本 Skill 产蓝图，不讲理论）
注意事项
- 它是设计阶段工具，不替代施工。真正生成文件、落地代码的活要交给
skill-creator。 - 它产出的蓝图与文件结构图是设计约定，最终能否跑通仍需测试打磨闭环验证。
- 轻量通道约 30 分钟出蓝图，适合赶时间；完整流程覆盖概念讨论到深化设计，耗时会更长。
结尾¶
高质量skill设计指南 的价值在于把”设计 Skill”这件事从个人经验变成一套可走完的流程：10 格积木链产出蓝图与文件结构图（含 7 套框架范例），五维就绪度打分给出体检结果，测试打磨闭环负责收敛。它和 skill-creator 分工明确——一个出蓝图，一个做施工。
官方地址：https://api.skillhub.cn/user_814dbe54/high-quality-skill-guidance
SkillHub 页面：https://www.skillhub.cn/skills/user_814dbe54/high-quality-skill-guidance
发布时间核对：资料中下载数为 21695 次，安装 0 次，评分 100000。
