用于编写和创建新的Superpowers技能的综合指南。包含技能文件结构（YAML frontmatter + Markdown正文）、描述编写规范、元数据标签系统、技能调用规则。适用于扩展Agent能力、创建团队专属技能、构建自定义工作流等场景。

Superpowers技能编写指南：自定义技能开发规范

【适用场景】

Step 1：创建新技能

当需要为Agent扩展新能力时，按照技能编写规范创建新的技能文件。

Step 2：团队技能定制

根据团队特定工作流程，编写团队专属的技能集合。

Step 3：工作流封装

将常用的工作流程封装为可复用的技能，提高工作效率。

Step 4：技能库建设

建立团队技能库，积累和传承最佳实践。

【操作步骤】

第一步：确定技能用途 明确技能解决的问题和使用场景。

第二步：编写YAML frontmatter ```yaml

---

name: <技能名> description: <简短描述> version: "1.0.0" license: MIT metadata: hermes: tags: [<标签列表>]

---

```

第三步：编写正文内容 包含概述、适用场景、操作步骤、代码模板、复盘要点等章节。

第四步：设置调用规则 明确技能的触发条件和调用方式。

【代码模板】

标准技能文件结构 ```yaml

---

name: my-skill description: "技能描述" version: "1.0.0" license: MIT

---

技能标题

概述

<技能概述>

何时使用

<触发条件>

操作步骤

<详细步骤>

代码模板

<代码示例>

检查清单

<验收标准> ```

【复盘要点】

技能设计原则：单一职责，一个技能只做一件事。

描述编写：description应简洁明了，说明技能的用途和触发条件。

标签系统：合理使用标签便于技能检索和管理。

来源：GitHub https://github.com/jnmetacode/superpowers-zh/blob/main/skills/writing-skills/SKILL.md