Skill生成器

它解决什么问题

刚接触 WorkBuddy Skills 的开发者，最常见的卡点不是“不会写代码”，而是不知道如何把一句口语化需求，拆成一份结构完整、可直接被 AI 执行的 SKILL.md。尤其是新手容易在以下几个地方反复改稿：

• Skill 的名称、显示名、内部 slug 混在一起，上架时被格式校验拦住；
• 工作步骤写得过于笼统，AI 拿到后不知道先做什么、再做什么；
• 输入与输出边界模糊，导致生成的 Skill 上线后行为不稳定；
• 不知道如何从本地编写，走到 SkillHub 上架、脱敏、审核这一整条链路。

Skill生成器就是为这类场景设计的教练型技能：它不替你写业务，而是通过分阶段问答，把口语需求“编译”成符合规范的结构化文件。

核心能力与工作流程

技能以“先懂再做”为原则，只有收集齐关键信息后才动手生成文件。整体分为五个阶段：

阶段零：建立认知

触发后，先输出一段开场白，用大白话解释 Skill 是什么：一份写给 AI 看的“工作说明书”，是结构化文本，不是程序。同时确认用户是否准备好进入提问流程。

阶段一：需求诊断（五步引导）

按顺序逐个提问，每一步都等待用户回答后再进入下一步，分别记录以下变量：

1. 第1步 · Skill 名称

- 需要同时提供：
- display_name：给用户看的显示名，可用中文，如“周报生成器”；
- slug：给系统用的内部标识，必须英文小写 + 连字符，如 weekly-report，并匹配正则 ^[a-z0-9-]+$。
- 如果用户只给中文名，技能会帮忙音译或意译成 slug，并请用户确认。

1. 第2步 · Skill 用途

- 用一句话描述：这个 Skill 是做什么的，用户在什么情况下会用。
- 记录为 purpose。

1. 第3步 · 工作步骤

- 请用户按顺序列出每一步做什么，例如：
1. 询问用户本周完成了哪些主要工作
2. 询问用户本周遇到了什么问题
3. 将以上信息整理成周报格式输出
- 记录为 steps 数组，严格保留用户给出的顺序，不合并、不重排。

1. 第4步 · 输入与输出

- 明确用户需要提供什么，以及最终得到什么。
- 例如：
- 输入：用户描述本周工作内容
- 输出：一份结构化的周报文本
- 记录为 input、output。

1. 第5步 · 补充说明

- 询问是否存在补充要求，比如：
- 什么样的回复算好质量？
- 有什么特别需要注意的地方？
- 有没有特定的语气或风格要求？
- 如果用户没有补充，直接回复“没有”即可。
- 记录为 extra。

阶段二：自动生成 SKILL.md

当五个步骤的信息都齐备后，技能会按照 references/SKILL模板.md 的标准格式生成完整文件。关键规则如下：

• name 字段 = slug，英文小写 + 连字符；
• version 默认 1.0.0；
• description 是 purpose 的精炼版，使用第三人称，说明使用场景与产出，方便市场与检索命中；
• 写入 agent_created: true，确保生成后的 Skill 可以被后续修改或删除；
• tags 填 3–5 个与用途相关的标签；
• 正文至少包含：角色定位、工作流程、输入与输出、注意事项；
• 如果用户没有给 extra，注意事项统一写：“如用户指令不够清晰，主动提问引导用户补充信息。”

生成后会回显全文，请用户确认是否需要修改；确认无误后再写入本地 skills 目录。

阶段三：写入本地（可选）

用户确认后，将 SKILL.md 写入 ~/.workbuddy/skills/<slug>/SKILL.md，如果需要引用文件，同时建好 references/ 目录。完成后告知用户：以后在 WorkBuddy 里直接说触发词即可调用。

阶段四：上架指导

如果用户想要发布，技能会按 references/上架流程.md 逐步指导：

1. 脱敏：移除单位名、人名、工号、内部文件名、内部系统名、涉密数据；
2. 打包成 zip；
3. 去 skillhub.cn 填写：Slug、显示名称、描述、标签、触发词、版本、图标；
4. 提交审核，一般需要 3–7 个工作日。

适用边界与注意点

• 不替用户编造业务细节：只要信息缺失，就主动提问，不脑补业务逻辑。
• slug 必须匹配 ^[a-z0-9-]+$：否则在 SkillHub 上架时会被直接拒收。
• 上架前必须脱敏：如果生成内容包含单位名、人名、工号、内部文件名、内部系统名、涉密数据，先清理再发布。
• 用户说“没有”时不强行加内容：如果用户在第5步明确没有补充，就尊重原意，不额外扩写。
• 上架图标建议：方形 1024×1024，深底浅图，缩小到 64px 时仍然清晰。
• 适用范围：适合想快速制作第一个 Skill、希望一次成型并最终上架的用户；不适合已经有成熟团队、需要多人协作或复杂配置体系的场景。

整个过程大约需要 5–10 分钟。对完全没写过 Skill 的新手来说，它的价值在于：把“不会写 SKILL.md”这件事，拆解成五次自然语言问答，而不是一次失败率很高的硬编码任务。