3-2 SKILL.md格式详解

SKILL.md的完整结构

每个Skill是一个目录，核心是 SKILL.md 文件。格式分两部分：YAML frontmatter（机器读取的元数据）+ Markdown正文（给AI读取的指令）。

YAML Frontmatter字段详解

---
name: stock-technical-analysis          # 唯一标识符，小写+连字符
category: finance                        # 分类目录，影响存储路径
description: A股个股技术面分析：均线、MACD、RSI...  # 一句话描述，影响AI搜索时的匹配
tags:                                    # 标签，用于搜索和关联
  - stock
  - technical-analysis
  - a-share
related_skills:                          # 关联的其他Skill
  - stock-fundamental-capital-sentiment
---

Markdown正文结构

# Skill名称

## 触发条件（Trigger）
- 用户说"分析XXX股票的技术面"
- 用户说"帮我看看XXX的K线"
- 每日定时技术分析任务触发

## 步骤（Steps）
1. 调用baostock登录并获取K线数据
2. 计算技术指标：MA5/MA10/MA20/MA60
3. 计算MACD(12,26,9)、RSI(6,14)、KDJ(9,3,3)
4. 分析布林带位置和成交量
5. 生成技术面报告

## Pitfalls（已知陷阱）
- baostock需要先login()，否则数据请求会失败
- 数据不足20条时跳过分析，避免指标失真
- 节假日前一天数据可能延迟

## 验证步骤
- 确认K线数据条数 >= 60
- 确认MA5 < MA10（空头排列时验证方向）
- 确认输出包含所有必要字段

完整真实Skill示例

---
name: ai-weekly-digest
category: productivity
description: AI前沿动态每日采集+每周周报系统
tags: [ai, digest, weekly-report, automation, cron]
---

# AI前沿动态周报系统

## 触发条件
- 用户要求生成AI周报
- 周一09:00定时触发

## 执行流程
1. 用web_search搜索上周AI热点（3次搜索）
2. 去重、按重要性排序
3. 生成结构化周报（500字以内）

## 输出格式
📊 AI前沿周报 [日期区间]
🔥 本周最热...
🛠️ 新工具...

## Pitfalls
- 输出不能超过500字，否则会被截断
- 不要输出[SILENT]，每次都必须输出报告

写Skill时最重要的两部分：触发条件（让AI知道什么时候加载）和Pitfalls（记录踩过的坑，避免重蹈覆辙）。