Skills

Agent Skills 是一个开放格式：一个技能就是一个文件夹，里面必须有一个 SKILL.md，开头写明名称（name）和描述（description），正文是具体的做法；还可以附带脚本、参考资料和模板。

为什么好用：按需加载

1. 发现。 Agent 启动时只读取每个技能的名称和描述，占用的上下文很少。
2. 激活。 当前任务和某个技能的描述匹配时，才把完整的 SKILL.md 读进来。
3. 执行。 按说明操作，需要时运行附带的脚本或读取参考文件。

所以你可以准备很多技能，而不会像把所有流程塞进 AGENTS.md 那样挤占上下文。

写好一个技能

• 描述决定它会不会被用上。 写清楚“什么时候用”，包括用户可能怎么说，例如“当用户要求发布新版本或写更新日志时使用”。
• 步骤写成可以执行的清单。 每一步说清楚运行什么命令、检查什么结果。
• 把确定性的部分写成脚本。 能用脚本完成的，就不要让模型每次重新推理。
• 说明失败时怎么办。 哪一步失败要停下来问人。

目录结构

release/
├── SKILL.md       # 必需：名称、描述与做法
├── scripts/       # 可选：可执行脚本
├── references/    # 可选：参考文档
└── assets/        # 可选：模板等资源

技能放在哪里取决于工具（项目内或用户目录下的技能文件夹），文件夹本身在支持 Agent Skills 的工具之间通用。

---
name: release
description: 发布新版本时使用：更新版本号、生成更新日志、打标签。当用户说“发布”“发版”“写更新日志”时触发。
---

# 发布新版本

## 前置检查
1. 运行 `git status`，确认工作区干净；不干净就停下来问我。
2. 运行 `pnpm check`，必须全部通过。

## 步骤
1. 读取上一个标签以来的提交：`git log $(git describe --tags --abbrev=0)..HEAD --oneline`。
2. 按 Conventional Commits 判断版本号：有 `!` 或 `BREAKING CHANGE` 升主版本，有 `feat` 升次版本，否则升修订号。
3. 在 `CHANGELOG.md` 顶部新增一节，按“新功能 / 修复 / 其他”分组，每条一句话。
4. 更新 `package.json` 的 `version`。
5. 把以上改动展示给我确认后，再提交并打标签 `v<版本号>`。

## 不要
- 不要推送标签或发布到 npm，除非我明确要求。