定制 Skill

.claude/skills/my-skill/
├── SKILL.md
└── references/         # 可选的支持文件

---
name: my-skill
description: |
  这个 skill 应该什么时候被触发的一句话说明。平台根据这段文本决定是否 auto-trigger。
---

# My Skill

skill 被触发时 AI 要遵循的指令。

## 步骤

1. 读相关文件。
2. 执行逻辑。
3. 按以下格式汇报结果：...

# 好：描述触发条件
description: |
  用于用户刚修完 bug、想理解根因并防止再次发生的场景。运行 5 维分析。

# 差：描述 skill 身份
description: |
  break-loop skill 是分析 bug 的。

---
name: api-doc
description: |
  用于用户刚加 / 改了后端 API 端点并希望更新 OpenAPI 文档的场景。解析 diff，提取端点签名，写文档。
---

# api-doc

从当前 diff 自动生成 API 文档。

## 触发检查

运行前先确认 diff 包含 `src/api/` 或 `src/routes/` 下的改动；不包含就先和用户确认再继续。

## 步骤

1. `git diff --name-only HEAD` 列出改动文件。
2. 对每个改动的端点文件，提取 route、HTTP 方法、请求 schema、响应 schema。
3. 更新 `docs/openapi.yaml`。
4. 汇报新增、修改、删除的端点。

## 输出格式

```
新增端点：
  POST /api/foo
修改端点：
  PUT /api/bar（请求体变更）
删除端点：
  （无）
```