SKILL.md 撰写指南

一份好的 SKILL.md，能让 AI 稳定、可靠地复现你的工作方法。按下面的结构写，5 分钟就能写出一版可用的技能说明。

一、基本格式

SKILL.md = YAML 头信息 + Markdown 正文：

---
name: 你的技能名称          # 必填，与平台一致
description: 一句话说清用途  # 强烈建议：AI 判断是否使用该技能的依据
version: 1.0.0              # 建议语义化版本
tags: [写作, 周报]           # 可选
---

# 技能名称
（正文，Markdown 语法）

头信息字段说明

字段	必填	说明
name	✅	技能名称，与平台创建时一致
description	✅	一句话说明「在什么场景做什么事」，会作为 AI 触发判断依据
version	建议	语义化版本号，发布 Release 时对应
tags	可选	触发关键词列表

二、正文应包含的主要内容

1. 触发条件：什么情况下 AI 应使用这个技能（用户会说什么、什么场景出现）；
2. 工作流程：分步骤写清楚先做什么、再做什么，每步有明确的输入与产出；
3. 输出规范：结果的格式、结构、语气、长度要求，最好给一个模板或示例；
4. 注意事项 / 边界：明确禁止做什么、容易踩的坑、数据口径要求；
5. 参考资源：相关文件（可用仓库内相对路径引用，如 references/examples.md）。

三、参考范例

---
name: 周报生成助手
description: 根据本周工作要点自动生成结构化周报
version: 1.0.0
---

# 周报生成助手

## 触发条件
当用户说「写周报」「生成周报」「整理本周工作」时激活。

## 工作流程
1. 向用户收集本周工作要点（5-8 条，不足时主动追问）
2. 将要点归类为：本周成果 / 数据亮点 / 下周计划
3. 按以下模板输出：

   > **本周成果**
   > - ……
   > **数据亮点**
   > - ……（每条注明数据来源）
   > **下周计划**
   > - ……

## 输出规范
- 总长 300 字以内，语气专业简洁；
- 数字必须保留原始口径，不得推算。

## 注意事项
- 用户未提供数据来源时，在「数据亮点」处标注「来源待确认」；
- 禁止虚构工作内容。

四、写好 Skill 的 5 条经验

1. description 写给 AI 看：包含场景关键词，AI 靠它判断何时使用；
2. 流程可执行：每一步都能照做，不含「酌情处理」这类模糊表述；
3. 给出输出模板：模板比形容词更能稳定输出质量；
4. 明确边界与禁止项：AI 需要知道「不要做什么」；
5. 小步迭代：先发 v1.0，用 Issue 收集反馈，配合版本历史持续打磨。

五、发布建议

• 写完后用「引入使用」页签在真实智能体里跑一遍验证；
• 稳定后发布 Release（打版本标签），使用者可锁定稳定版本；
• 选择合适的开源协议（创建页有问卷向导），让使用者清楚权利边界。