上線驗收官:只讀檢查上線狀態,輸出帶證據的驗收報告

前言

上線前常見兩類做法:人工點幾個頁面,憑感覺說“好像沒問題”;或者寫一堆臨時腳本,檢查項散落各處,事後無法復現。前者沒有證據,後者維護成本高。下面介紹的 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

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

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

小夜