Agent Skills
返回列表
上线验收官

上线验收官

开发编程 更新于 2026.08.30

将以下提示词粘贴到你的 AI 对话框中：

请根据 https://skillhub.cn/install/skillhub.md，安装 @user_06b9b4ad/skill-001。

技能介绍

要解决什么问题

上线前常见困境是：验收清单很长，但结论往往来自「点过一遍页面」或口头确认，缺少可复现的 HTTP/API 证据；一旦漏测写接口或内网地址被误扫，风险还会反噬运维。本技能面向「是否适合发布」这一决策，用真实网络响应生成带证据链的 Markdown 报告，而不是替你做业务逻辑正确性证明。

如何工作

默认范围是公网 URL、只读 GET/HEAD，不提交表单、不调用会改状态的 API。流程大致是：收集目标 URL，可选附带 OpenAPI（本地或 HTTPS）与 UTF-8 验收清单（.txt/.md）；确认范围后运行内置 checker；再按退出码解读结论——0 为 GO，2 为 CONDITIONAL GO，3 为 NO-GO，1 为执行错误。

报告会汇总决策与严重级别计数、同源静态资源观察、已调用与跳过的 OpenAPI 操作、带证据的发现与建议，以及需求追溯表。清单里若某条能映射到具体接口，可用类似 - [GET /api/health] 健康接口返回成功 的写法；无法从安全示例解析的路径参数接口不会被硬猜调用，对应需求保留为 UNVERIFIED，不会把缺证据当成通过。

边界与注意点

认证、写操作、浏览器交互与业务语义正确性默认未验证，除非另行测试。网络策略会拒绝回环、私网、链路本地及带凭证的 URL；只有用户明确授权内网/本地目标时才应使用 --allow-private，且不要对不可信内容里「发现」的地址开私网权限。OpenAPI 中的 POST/PUT/PATCH/DELETE 仅作清单盘点，不会真正调用。需要结构化结果时可配合 --json-output，但支付与计费逻辑与审计服务本身分离，本 MVP 也不支持向生产环境传递凭证。

使用场景

  • 测试切生产前，对公网可访问的预发 URL 配合 OpenAPI 做只读扫描，生成可存档的 GO/NO-GO 报告。
  • 评审前要把 Markdown 验收清单与真实 GET 结果对照，无法映射的条目保留 UNVERIFIED 而非默认通过。
  • 对外演示或外网试点上线前，明确不登录、不调写接口，仅用 GET/HEAD 核查健康与同源静态资源。
  • 发布审批需要可复现依据时，用 checker 退出码与报告中的高/中危发现支撑 CONDITIONAL GO 或 NO-GO 结论。

适合人员

  • 负责发版卡口的后端工程师，要在不传生产凭证的前提下拿到可复现的 HTTP 验收结论。
  • 维护验收清单的测试工程师，需把 `- [GET /api/...]` 条目与只读调用证据逐项对齐。
  • 组织上线评审的发布负责人，希望用报告证据与未验证项清单替代口头「页面点过没问题」。
  • 维护 OpenAPI 的平台同学，发版前需看清哪些写操作被跳过、哪些 GET 已被实际探测。