前言¶
在 Agent 里反复做同一件事——例如固定格式的代码审查、发布检查或文档生成——常见做法是堆一段长提示词，或把步骤写在项目 README 里。提示词难版本管理，README 也不会在对话里自动生效。更稳妥的做法是把「已经跑通的路径」写成 Skill：有触发条件、有步骤边界、有可复用的产物结构。
下面介绍 SkillHub 社区 Skill「Skill 设计师」（坐标 @user_00c9b356/chenlin-skillcreator，当前版本 v3.3.0）。它面向「从零创建 Skill」或「迭代已有 Skill」，用一套设计方法把经验落成标准四件套，并对齐 Claude Code 的 Skill frontmatter 规范。
这是什么¶
Skill 设计师是社区发布者 user_00c9b356 维护的 dev-programming 类 Skill，来源为 community，不依赖 API Key（requires_api_key=false）。
一句话定位：把已验证成功的路径复刻为可用的能力模块，输出可安装、可分发的 Skill 文件组。
官方入口：
- SkillHub 页面：https://www.skillhub.cn/skills/user_00c9b356/chenlin-skillcreator
- API 坐标页：https://api.skillhub.cn/user_00c9b356/chenlin-skillcreator
核心功能¶
以下能力均来自官方简介与 SkillHub 页面说明。
设计方法¶
Skill 融合三类方法论，用于约束 Agent 怎么写 Skill、怎么避免空泛步骤：
- 六大设计原则：反幻觉、角色扮演、三层分离、证据优先、行动建议内置、经验捕获。
- Loop Thinking：围绕触发条件、停止条件、验证边界做设计，避免 Skill 无限展开或过早结束。
- Claude Code 官方 frontmatter 规范：产出与当前生态的 Skill 元数据格式一致，便于在支持 Skill 的客户端加载。
三种 Skill 类型¶
设计时会区分用途，便于步骤与反馈结构不同：
| 类型 | 含义 |
|---|---|
| A 任务执行类 | 完成明确任务的一次性或流水线式执行 |
| B 习惯养成类 | 行动分层 + 反馈循环，适合重复性行为 |
| C 工具使用类 | 围绕特定工具或接口的可复用操作路径 |
标准四件套输出¶
完成设计后，产出完整文档组：
SKILL.md：Skill 主文件（含 frontmatter 与执行说明）REQUIREMENTS.md：需求与约束SOLUTIONS.md：方案与步骤MISTAKES.md：常见错误与规避
何时应启用本 Skill¶
当用户表达「创建 / 设计 Skill」或要把工作流固化成 Skill 时，应使用本 Skill。官方列出的典型表述包括：
- 中文：「我想做一个 XX skill」「做 skill」「创建 skill」「skill 设计」「帮我设计个工作流模板」「写个 skill」「怎么写 skill」等
- 英文：
create a skill、design a skill、make a skill、skill designer、skillcreator等 - 意图：把 workflow / process 转成可复用 Skill，即使用户未明确说「skill」
不应使用：用户只是想调用某个已有 Skill，而不是新建或改造 Skill。
安装与启用¶
SkillHub 推荐通过 CLI 安装到当前 Agent 的 skills 目录；装错目录会导致客户端识别不到。
1、检查或安装 SkillHub CLI¶
先确认本机是否已有 skillhub：
command -v skillhub && skillhub --version
未安装时，可按 SkillHub 安装文档执行完整安装（CLI + 默认 Skill）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
仅安装 CLI 时：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only
安装说明全文：https://skillhub.cn/install/skillhub.md
2、安装 Skill 设计师¶
安装时必须用 --dir 指向当前环境的 skills 目录。常用路径如下（以安装文档为准）：
- Claude Code：
~/.claude/skills/ - Cursor：
~/.cursor/skills/ - Codex：
~/.codex/skills/或项目下的.agents/skills/
示例（将 <skills 目录> 换成你的实际路径）：
skillhub install user_00c9b356/chenlin-skillcreator --dir <skills 目录>
也可把下面这句交给 Agent，让其按 SkillHub 安装文档完成安装：
请根据 https://skillhub.cn/install/skillhub.md，安装 @user_00c9b356/chenlin-skillcreator。
安装后若客户端未自动刷新，按你所用产品的说明重启或重载 skills 目录。
典型用法¶
用法本质是「用自然语言描述要做的 Skill」，由 Skill 设计师引导补齐类型、边界与四件套。
从零创建¶
在已启用该 Skill 的对话中，直接说明目标，例如：
我想做一个「PR 合并前检查」的 skill：检查 CI 状态、changelog、破坏性变更说明。
经过上面的步骤，Agent 会按 A/B/C 类型与设计原则组织内容，并生成 SKILL.md 及三份配套 Markdown。
迭代已有 Skill¶
若目录里已有半成品 Skill，可说明要改的点，例如：
帮我优化现有 skill：触发条件太宽，经常误触发；请收紧 when_to_use，并补 MISTAKES.md。
（具体字段名以 Skill 设计师 v3.3.0 产出与 Claude Code 规范为准；安装后以其生成的 SKILL.md frontmatter 为权威。）
与工作流模板需求对齐¶
官方说明也覆盖「工作流模板」类表述，例如：
帮我设计个工作流模板：每周五生成团队周报，输入是本周 merge 列表和 issue 链接。
这类需求会落到 REQUIREMENTS + SOLUTIONS，并在 SKILL 中写清触发与验证边界。
适用场景与注意¶
适合谁
- 需要把团队内「已经验证过」的操作路径沉淀为 Skill 的开发者
- 维护多个 Agent 客户端、希望产出符合 Claude Code Skill 格式的作者
- 希望用 MISTAKES.md 单独记录踩坑、减少重复幻觉的维护者
限制与注意
- 本 Skill 解决的是「设计并写出 Skill 文件」，不是替代业务 Skill 本身的执行逻辑。
- 安装路径必须对：未使用
--dir指向 Agent skills 目录时，默认可能装到./skills/，客户端无法加载。 - SkillHub 页面展示的社区数据（截至查阅时）：评分 100000，下载 9158；与本地统计可能不同，以 SkillHub 为准。
- 用户仅想「使用」某个现成 Skill 时，应直接安装目标 Skill，不必经过 Skill 设计师。
结尾¶
Skill 设计师把「成功路径」从口头经验变成可版本管理的四件套，并嵌入反幻觉、Loop Thinking 与三层分离等约束，降低 Skill 写成空泛清单的概率。若你正在规划第一个团队 Skill，可从 SkillHub 安装 v3.3.0，用一句「我想做一个 XX skill」启动设计。
官方地址：https://www.skillhub.cn/skills/user_00c9b356/chenlin-skillcreator
