上线验收官:只读检查上线状态,输出带证据的验收报告

前言

上线前常见两类做法:人工点几个页面,凭感觉说“好像没问题”;或者写一堆临时脚本,检查项散落各处,事后无法复现。前者没有证据,后者维护成本高。下面介绍的 Skill「上线验收官」把这件事收敛成一次可重复的只读检查:输入系统地址和可选的 OpenAPI 文档,自动执行上线检查,生成带真实接口证据的 GO / CONDITIONAL GO / NO-GO 验收报告。

这是什么

「上线验收官」是一个基于通用 SKILL.md 格式的 Agent Skill,坐标为 @user_06b9b4ad/skill-001,当前版本 1.0.0,由社区发布者 user_06b9b4ad 维护,分类为 dev-programming。它解决的问题是:在不登录系统、不改动任何生产数据的前提下,对一次 Web 发布做冒烟检查,核验公开 HTTP/API 的健康状态,把一份文本需求检查清单与实际收集到的证据逐条比对,最后产出交付验收报告。

核心功能

根据官方资料,该 Skill 的能力包括:

  • 对给定网站 URL 执行只读上线检查,检查过程不写生产数据。
  • 支持传入可选的 OpenAPI 文档,用于核对接口是否存在、公开可访问。
  • 将文本形式的需求检查清单与实际收集到的证据进行比对。
  • 输出 Markdown 格式的验收报告,结论分三档:GO、CONDITIONAL GO、NO-GO。
  • 报告中的每条结论附真实接口证据,而不是泛泛描述。
  • 可通过有边界的 provider API 暴露检查能力。
  • 适合用于发布前冒烟测试、识别尚未核实的上线风险。

页面标注 requires_api_key=false,即不需要单独申请 API Key。

安装与启用

官方页面摘要中未给出具体的安装命令、目录路径或配置文件字段。为避免给出无法核实的命令,这里不臆造安装步骤。获取方式以官方地址为准:

https://api.skillhub.cn/user_06b9b4ad/skill-001

SkillHub 页面:

https://www.skillhub.cn/skills/user_06b9b4ad/skill-001

在对应客户端中按 SkillHub 的通用流程启用该 Skill 后,即可在对话或任务中调用。Cursor、Codex CLI、Claude Code 的具体配置差异,资料中没有说明,此处不做区分。

典型用法

以下是根据官方简介整理的可复现用法,具体参数以页面说明为准。

1、准备一份文本需求检查清单,例如“首页可访问”“登录接口返回 200”“订单列表接口公开可访问”。

2、准备目标系统地址和可选的 OpenAPI 文档路径或 URL。

3、让 Agent 执行上线验收官的只读检查,输入检查清单、系统地址与 OpenAPI 文档。

4、检查完成后,Skill 会返回一份 Markdown 报告,按 GO / CONDITIONAL GO / NO-GO 给出结论,并在每条结论后附上实际请求得到的接口证据。

5、如果结论是 CONDITIONAL GO,按报告中指出的未核实项补齐证据后再决定是否放行。

适用场景与注意

适合的场景:Web 服务上线前的冒烟验证;公开 HTTP/API 健康核验;交付验收报告整理;需要把需求清单逐条落到证据的发布评审。

需要注意的限制:

  • 只做只读检查,不会登录系统,因此无法覆盖需要鉴权后才能验证的页面或接口。
  • 不修改生产数据,也不能代替功能测试、性能测试或安全测试。
  • OpenAPI 文档是可选项,但缺少它时接口层面的核对能力会受限。
  • 报告中的证据来自实际请求,检查项的措辞需要写清楚,否则可能出现“检查通过但语义不达预期”的情况。
  • 页面显示的评分与下载量在不同来源中不一致,本文不引用具体数值,请以官方页面实时显示为准。

结尾

上线验收官的价值在于把“上线前看一眼”变成“上线前留证据”:只读、可重复、结论分档、证据可回溯。适合作为发布流程中的固定一环,而不是临时补丁。

官方地址:https://api.skillhub.cn/user_06b9b4ad/skill-001

SkillHub 页面:https://www.skillhub.cn/skills/user_06b9b4ad/skill-001

羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

小夜