前言¶
上线前常见两类做法:人工点几个页面,凭感觉说“好像没问题”;或者写一堆临时脚本,检查项散落各处,事后无法复现。前者没有证据,后者维护成本高。下面介绍的 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