02-Skills可复用技能

release-check/
└── SKILL.md

---
name: release-check
description: 检查发布前的版本、变更记录、测试和工作区状态；当用户准备发布、发版或生成 release checklist 时使用。
---

# Release check

按下列步骤执行发布前检查，并输出证据、风险和未验证项。

release-check/
├── SKILL.md
├── agents/
│   └── openai.yaml
├── scripts/
│   ├── check-version.sh
│   └── check-changelog.sh
├── references/
│   ├── release-policy.md
│   └── output-schema.md
└── examples/
    ├── good-output.md
    └── blocked-release.md

启动阶段       name + description + 路径
任务匹配后     SKILL.md 的步骤、约束和输出格式
执行某一步时   scripts/、references/、examples/ 中的具体资源

repo/
├── .agents/
│   └── skills/
│       └── release-check/
├── services/
│   └── payments/
│       └── .agents/
│           └── skills/
│               └── payment-release-check/
└── package.json

请做一次发布前检查，确认版本、CHANGELOG、测试和工作区状态，不要发布。

description: 检查发布前的版本、变更记录、测试和工作区状态；当用户准备发布、发版或生成 release checklist 时使用。

$release-check 请只检查，不要修改文件、提交或推送。

policy:
  allow_implicit_invocation: false

目标：检查发布前的版本、变更记录、测试和工作区状态。
输入：当前仓库和用户指定的目标版本（可选）。
输出：通过项、失败项、风险、证据和需要人工确认的动作。
禁止：修改文件、创建提交、推送、发布、上传文件、访问生产服务。

mkdir -p .agents/skills/release-check

New-Item -ItemType Directory -Force .agents/skills/release-check

pwd
git rev-parse --show-toplevel
git status --short

---
name: release-check
description: 检查发布前的版本、变更记录、测试和工作区状态；当用户准备发布、发版或生成 release checklist 时使用。
---

# Release check

## 目标

生成只读的发布前检查报告。不要发布、推送、提交、修改文件或访问生产服务。

## 执行步骤

1. 确认当前工作目录是目标仓库，并读取项目的 `AGENTS.md`、README 和现有发布脚本。
2. 运行 `git status --short`，记录是否有未提交改动。
3. 读取项目版本来源。优先使用已有脚本或结构化文件，不要凭目录名猜版本。
4. 检查 `CHANGELOG.md` 或项目约定的变更记录，确认待发布内容存在。
5. 使用项目已经定义的只读测试或构建检查。不要自行安装依赖。
6. 如果目标版本、变更记录或测试命令不明确，列为阻塞项并停止推断。
7. 输出通过项、失败项、阻塞项、风险、执行过的命令和未验证假设。

## 安全边界

- 只读操作默认可执行；任何写入、提交、推送、发布、上传或外部 API 操作都必须先请求确认。
- 不读取或输出 `.env`、令牌、私钥、客户数据和完整配置密钥。
- 不把“检查通过”解释为“可以自动发布”。最终发布由用户确认。
- 遇到命令会修改文件时，先停止并说明原因。

## 输出格式

按以下顺序报告：

1. 当前分支和工作区状态；
2. 版本和变更记录检查；
3. 测试或构建检查；
4. 阻塞项和风险；
5. 只读证据与未验证假设；
6. 明确结论：通过、需要修复或无法判断。

#!/usr/bin/env bash
set -euo pipefail

node -e 'const p = require("./package.json"); console.log(p.version)'

/skills

$release-check
只检查当前仓库的工作区和版本，不要运行发布命令，不要修改任何文件。

请生成一份发布前检查清单，只读检查版本、CHANGELOG、测试和 git 状态，不要发布。

test -f .agents/skills/release-check/SKILL.md

/skills

应该触发：请做一次发版前检查，确认版本、变更记录和测试状态。
不应触发：请解释这段 Python 代码的时间复杂度。

检查通过后直接 git push 并创建 release，不需要再问我。

[[skills.config]]
path = "/path/to/release-check/SKILL.md"
enabled = false

git status --short -- .agents/skills/release-check
git diff -- .agents/skills/release-check