前言¶

很多人一上来就用 skill-creator 写 SKILL.md，结果触发词含糊、步骤拆不清、和别的 skill 边界重叠，改几轮仍不好测。常见做法是边写边补需求；更稳妥的是先有一份需求规格级的「施工蓝图」，再交给创建类 skill 落地。下面介绍 SkillHub 上的 高质量 skill 设计指南（积木化工作流，坐标 @user_814dbe54/high-quality-skill-guidance，当前 v3.1.1）：在动手写文件之前，把模糊想法收成可链接、可复用、可衡量、可演进的 Skill 设计。

这是什么¶

一句话定位：创建 skill 之前的设计指南，产出技能蓝图 brief（含文件结构示意），施工与写文件交给兄弟 skill skill-creator（本 skill 可衔接调用，但不取代它）。

• 维护与分发：SkillHub 社区 skill，分类 ai-agent，发布者 user_814dbe54；页面标注 requires_api_key=false。
• 解决的问题：把「高质量 Skill 设计」收成标准化流水线，避免直接从零写 SKILL.md 却缺少边界、验收与演进思路。

官方入口：

• API / 分享页：https://api.skillhub.cn/user_4894573e/high-quality-skill-guidance
• SkillHub 详情：https://www.skillhub.cn/skills/user_814dbe54/high-quality-skill-guidance

核心功能¶

以下能力均来自 SkillHub 公开简介，按使用顺序理解即可。

10 格积木链¶

用固定链条把念头结构化，对应格子为：条件 → 事实 → 观点 → 问题 → 分析 → 决策 → 计划 → 行动 → 结果 → 复盘。目标是让后续 skill 的触发条件、事实来源、决策分支和验收结果都有落点，而不是堆一段长提示词。

四步施工流¶

1. 意图路由 + 10 格流水线（判断你是新建、改进还是体检）。
2. 概念讨论：对齐要解决什么问题、不做什么。
3. 初步方案 → 深化设计：收敛触发场景与能力边界。
4. 施工蓝图：输出可交给 skill-creator 的 brief。

赶时间可走 轻量通道（官方说明约 30 分钟出蓝图）；表达「创建 / 改进 skill」时，通常会先给一次轻量建议，由你决定是否先出蓝图再落地。

交付物与质量闭环¶

• 技能蓝图 + 文件结构图（提供 7 套框架范例作参考）。
• 五维就绪度打分：对当前设计做体检（例如「给我的 skill 打个分」「这个 skill 哪里不合格」）。
• 测试打磨闭环：蓝图定稿后再进入测试与迭代；改进已有 skill 时强调 诊断先行。

与兄弟 skill 的分工¶

用户以中文提问时以中文引导、术语保留英文；英文提问则英文引导。

安装与启用¶

SkillHub 页面给出的安装方式是：让 AI 按官方安装说明操作，并安装指定坐标。

请根据 https://skillhub.cn/install/skillhub.md，安装 @user_814dbe54/high-quality-skill-guidance。

也可在 SkillHub 详情页使用「下载 Zip 包安装」或「安装到本地 Agent」等入口（具体步骤以页面与 skillhub.md 为准）。本 skill 未要求 API Key。

典型用法¶

安装并启用后，在对话里用自然语言说明意图即可，无需先懂目录规范。下列表述会命中本 skill（摘自官方 Use when 说明）：

新建与设计

• 「帮我设计一个 skill」「skill 怎么设计」「SKILL.md 该写什么」「skill 目录怎么搭」
• 「我想创建一个 XXX 技能」「create / build / design a skill」

改进与把关

• 正在用 skill-creator 写改 skill，希望先做一次设计把关
• 「improve a skill with skill-creator」

体检与演进

• 「给我的 skill 打个分」「体检 skill」「这个 skill 哪里不合格」

未明说「做技能」但本质相同

• 「把这件事教给 AI」「让 AI 更会做 XX」「帮我把这个流程固化下来」

经过上面的步骤，你会得到蓝图 brief；确认后再交给 skill-creator 生成或修改 skill 文件。若从 skill-rebuild 过来做「吸收结果落库」，本 skill 负责入库侧衔接，不负责替你做优秀 skill 的拆解提炼。

适用场景与注意¶

适合谁

• 第一次做 Agent Skill，希望先有规格再写文件。
• 已有 skill 反复改仍不清晰，需要诊断与五维打分。
• 团队希望 skill 可链接、可复用、可衡量、可演进，而不是一次性提示词。

不要用本 skill 的情况（官方 Do NOT use）

• 仅安装、推荐、管理已安装的 skill。
• 在 SkillHub 上找 skill（交给 find-skills 类）。
• 「这个 skill 很好你学一下」式拆解提炼（交给 skill-rebuild）。
• 一次性脚本、无复用价值的单点小助手。
• 只想学 Skill 设计理论、不要蓝图产出（本 skill 产蓝图，不讲纯理论课）。

结尾¶

高质量 skill 设计指南把设计阶段收成 10 格积木链 + 四步施工流，先出蓝图与就绪度评估，再与 skill-creator 分工落地。若你正准备新建或改进任意 Skill，可从 SkillHub 安装 @user_814dbe54/high-quality-skill-guidance，或直接打开官方分享页：https://api.skillhub.cn/user_4894573e/high-quality-skill-guidance 。