技能创建指南

要解决什么问题

Agent 技能越来越多，但常见痛点是：正文写成面向终端用户的说明书、大段领域资料堆在 SKILL.md 里、脚本与参考文档混在一起，导致另一实例加载后难以按触发语稳定执行，也难以在 SkillHub 类流程里校验与分发。

技能如何工作

本技能扮演技能设计顾问，用固定六步工作流把模糊需求收敛成可发布的技能包：

1. 用例理解 — 用少量问题厘清能力边界、典型触发语与用户说法。
2. 规划可复用内容 — 区分 scripts/（需确定性、避免反复重写）、references/（按需读入上下文）、assets/（产物直接使用的模板与素材）。
3. 初始化结构 — 必需 SKILL.md（YAML frontmatter + Markdown）；中文技能正文统一 6 段（角色、何时使用、工作流、互操作、输出规范、示例）。
4. 编写技能 — 正文用祈使/不定式，面向另一实例；程序性知识与细节下沉到资源目录。
5. 校验与打包 — frontmatter 字段、命名、目录与描述质量过关后再分发。
6. 迭代 — 真实任务上暴露的卡点回写到 SKILL.md 或资源。

产出物包含结构化工件 SkillSpec（名称、触发语、资源清单、段数）及资源归位说明；详细模板见技能内 references/template.md。

适用边界

• 适用：新建或改造技能、需要明确触发时机与 I/O（SkillSpec）时。
• 不适用：替用户编造事实；assets/ 须具备合法授权。