agentleFS
YorkWong1995YorkWong1995/OPC-Harness/.claude/skills/release-check/SKILL.md

release-check

Skill4 starsChanged 6 months agoMITView on GitHub

Produce a read-only release readiness recommendation from implementation results, QA evidence, environment details, and rollback conditions.

  • Commits and pushes

15 other projects use a version of this.

Adopted by

Most recently taken up by

The file

Files
SKILL.md

release-check

对实现结果、QA 验收、运行环境和发布对象做发布前只读检查,输出发布建议、风险和回滚条件;该 skill 只给出发布建议,不执行真实发布、部署、推送或外部系统变更。

用法

/release-check <发布对象、实现结果、QA 证据或环境信息>

目标

  • 汇总发布对象、验证证据和环境前置条件
  • 检查发布前风险、监控关注点和回滚条件是否明确
  • 给出 ready / needs-info / not-ready 的发布建议
  • 明确哪些动作需要人工确认或单独发布命令执行

适用场景

  • 代码、文档、配置或脚本准备发布前需要最终检查
  • QA 已给出结论,需要确认运行验证和回滚条件
  • 变更涉及环境、部署、监控、上传或外部系统副作用
  • 发布前需要整理人工确认清单

不适用场景

  • 执行真实发布、部署、推送、上传或回滚
  • 绕过 QA 验收或替代 /acceptance-check
  • 对没有发布对象或环境信息的任务强行给出 ready
  • 修改代码、配置、CI/CD 或基础设施

发布检查模板

发布检查字段必须与 docs/claude/standards.md 中“发布检查应至少包含”的要求一致:

  1. 发布对象:明确发布内容、版本、目标环境、影响范围和是否涉及外部系统。
  2. 发布前检查项:列出 QA 结论、测试命令、配置检查、权限检查、数据/迁移检查和依赖状态。
  3. 运行验证方式:说明发布后如何验证关键路径,包括命令、页面、接口、日志或 artifact 检查方式。
  4. 监控关注点:列出发布后需要观察的错误率、耗时、资源、日志、告警或业务指标。
  5. 回滚条件:定义触发回滚的失败信号、回滚入口、需要保留的证据和人工确认人。
  6. 发布结论:只能是 ready、needs-info 或 not-ready,并给出一句理由。

结论规则

  • ready:QA 已通过,发布前检查项满足,运行验证方式和回滚条件明确,且无未处理高风险。
  • needs-info:缺少环境、QA 证据、验证方式、监控或回滚条件,无法判断是否可发布。
  • not-ready:存在失败测试、阻塞缺陷、未批准危险操作、不可接受风险或缺失必要人工确认。

风险边界

  • 涉及 git push、上传、部署、迁移、删除、回滚或修改共享基础设施时,必须标记需要人工确认。
  • 只有检查结果,不代表真实发布已经完成。
  • 若发布对象只是文档或本地配置,也必须说明如何验证用户能找到并理解变更。

执行规则

  1. 只读取用户提供的实现结果、QA 证据、环境信息和发布对象。
  2. 不执行发布命令,不推送代码,不修改远端系统,不创建外部副作用。
  3. 缺少 QA 通过证据、运行验证方式或回滚条件时,结论不得为 ready。
  4. 发布对象涉及危险操作时,必须列出人工确认节点。
  5. 输出必须区分“检查建议”和“真实发布动作”,避免用户误以为已发布。

示例

  • /release-check v0.8 文档与 skill 变更,基于 QA 验收记录判断是否可发布
  • /release-check upload_to_github.sh 发布前检查,重点确认人工确认节点和回滚条件
  • /release-check opc runs cost CLI 发布检查,检查运行验证、监控关注点和回滚条件是否齐备

输出骨架

[示例:可发布]
[发布对象] docs/workflow-packs/ 与 .claude/skills/ 文档资产
[输入证据]
- 实现结果:文档已更新,索引可找到
- QA / 验收:定向文档结构测试通过
- 环境信息:仅本地文档资产,无线上部署
[发布前检查项]
- QA 结论:通过
- 配置检查:不涉及
- 权限检查:不涉及外部系统
[运行验证方式]
- 读取 README / DOCS_STRUCTURE 索引并确认链接目标存在
[监控关注点]
- 用户是否能从索引找到对应资产
[回滚条件]
- 发现文档误导或链接失效时 revert 对应文档提交
[人工确认节点]
- 合并或发布前由维护者确认文档范围
[结论] ready
[说明] 仅发布建议,未执行真实发布

[示例:需要补充信息]
[发布对象] upload_to_github.sh 上传入口
[输入证据]
- 实现结果:脚本存在
- QA / 验收:缺少验证记录
- 环境信息:缺少目标 remote、分支和权限说明
[发布前检查项]
- QA 结论:信息不足
- 权限检查:缺少人工确认规则
[运行验证方式]
- 信息不足,无法确认安全 dry-run 或检查命令
[监控关注点]
- GitHub push / release 状态、失败日志、误上传风险
[回滚条件]
- 信息不足,缺少回滚入口和负责人
[人工确认节点]
- 必须由用户确认 remote、分支、是否 push 和回滚方式
[结论] needs-info
[说明] 仅发布建议,未执行真实发布

验收标准

  • 示例覆盖 ready 和 needs-info 两种结论
  • 输出骨架包含发布对象、发布前检查项、运行验证方式、监控关注点、回滚条件和发布结论
  • ready 示例必须有 QA 证据、运行验证和回滚条件
  • 缺少环境或回滚信息时必须输出 needs-info

验收

  • 明确 release-check 只做发布建议,不执行真实发布
  • 输入覆盖实现结果、验收结果、运行环境和发布对象
  • 输出包含发布前检查项、运行验证方式、监控关注点、回滚条件和发布结论
  • 缺少关键证据时不得输出 ready

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.