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