前言¶

写一个 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。