Communitygithub.com

yagyaraj234/skills

從工作差異、PR URL、發布目標或完整儲存庫審計檢查就緒狀態。當要求審查變更、評估發布就緒度或找出前後端問題並提供證據時使用。

skills 是什麼?

此技能提供一個全面的就緒度檢查機制,可應用於多種情境:差異分析(diff)、PR 審查(pr)、發布驗證(release)或完整儲存庫審計(full)。它能根據使用者指定的模式或推斷的情況,自動選擇目標範圍,並基於明確的完成標準進行評估。技能會分層收集證據,包括原始碼、自動化測試、本地運行環境、供應商沙箱和部署環境,並使用後端就緒度與前端就緒度子技能來涵蓋相關範圍。在報告階段,它會按嚴重性排序問題(安全性、資料遺失、正確性、使用者影響),並為每個失敗項目提供精確的位置、證據、後果和最簡潔的解決方案,最終以 `READY`、`NOT READY` 或 `UNVERIFIED` 的裁決結束。此技能支援 Claude Code 等工具,預設為唯讀模式,僅在使用者明確要求修復時才會編輯程式碼,並隨後驗證受影響的行為。

相容平台✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/yagyaraj234/skills/tree/HEAD/skills/check-readiness

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

檢查就緒狀態

以 $check-readiness diff、$check-readiness pr <URL>、$check-readiness release 或 $check-readiness full 方式呼叫。

預設為唯讀。回報問題並提出具體解決方案。僅在使用者明確要求修正或套用發現時才進行編輯;之後需驗證受影響的行為。

1. 選擇目標

模式目標完成標準
diff當前儲存庫的暫存、未暫存及相關未追蹤變更,以及受影響的呼叫者和測試。當變更是目標時的預設模式。每一項變更的行為及受影響的邊界都已被考量。
pr <URL>連結的 PR 差異、基底、對話、檢查及受影響的上下文。每一項變更的行為都已被考量;遺漏的本地或遠端證據需明確指出。
release當前儲存庫及指定的部署目標,或從儲存庫組態中找到的目標。每一個關鍵流程和發布依賴項目都有一個狀態。
full當前儲存庫適用的前後端表面。每一條主要路由、操作、信任邊界、資料儲存和生命週期路徑都已完成盤點和評估。

使用使用者命名的模式。若未命名,則從 PR URL、當前變更或陳述的發布中推斷;否則使用 full。在檢查前記錄確切的目標、修訂版或差異、環境以及可用的驗證路徑。如果無法存取 PR URL,請回報被阻擋的內容;請勿以無關的本地差異取代。

嚴重性

每個 FAIL 都是阻擋性或建議性的。阻擋性:安全性、身分驗證/授權、資料遺失或損毀、中斷的關鍵流程、未經驗證的付款或 Webhook 處理、洩漏的機密、失敗的建置或測試。其他所有情況都是建議性的,不會單獨阻止 READY 狀態。每個就緒技能都會列出自己的阻擋範圍。

依模式劃分的深度

diff 和 pr:僅檢查變更觸及的行為;其餘部分在一行內標記為 N/A (未觸及),而非逐項檢查。發布門檻檢查(Lighthouse、部署環境的煙霧測試、分享預覽)僅適用於 release 和 full 模式,除非變更影響了這些項目。

2. 收集證據

對於 diff,檢查 git status --short --branch、暫存和未暫存的差異以及相關的未追蹤檔案。對於 pr,閱讀連結的 PR 及其差異、檢查和討論;僅在其修訂版已驗證時,才使用相符的本地簽出進行測試。對於 release 和 full,在測試前先繪製目標應用程式的範圍。為每個受影響的領域追蹤呼叫者、資料影響、組態、測試和部署依賴。

當後端程式碼或行為在範圍內時,執行 backend-readiness。當前端程式碼或行為在範圍內時,執行 frontend-readiness。將選定的模式和目標傳遞給每個子技能;如果兩者都適用,則合併它們的發現。對於變更審查,對受影響的行為套用檢查。對於發布,對關鍵流程和目標環境套用檢查。對於 full,評估儲存庫中所有適用的檢查。將每個適用的檢查標記為 PASS、FAIL、BLOCKED 或 N/A;為每個 PASS 附加當前證據,為每個 N/A 附加原因。

使用原始碼、自動化測試、本地運行環境、供應商沙箱和部署環境作為不同的證據層。建置證明建置。將不可用的憑證、基礎設施或環境記錄為 BLOCKED,並附上仍需要的確切證明。執行能夠驗證目標的聚焦檢查;不要僅憑原始碼就斷言運行時或發布行為。

當適用的檢查都有了狀態、失敗有原因和解決方案、並且每個就緒聲明都與其證據層相符時,即完成。

3. 報告與行動

回報模式和目標,然後按安全性、資料遺失、正確性和使用者影響的順序列出發現。每個發現都需指出位置或流程、證據、後果以及最簡潔的具體解決方案。包含執行的檢查及其確切結果,以及被阻擋或未驗證的項目。以 READY、NOT READY 或 UNVERIFIED 結束以表示所選目標的狀態:READY 要求沒有已知的阻擋性失敗,並且有適用門檻的證據;UNVERIFIED 表示缺少證據而無法做出該斷言。

使用此模板:

模式 / 目標:<模式、修訂版或差異、環境>

發現
| 嚴重性 | 位置或流程 | 證據 | 後果 | 解決方案 |

已執行的檢查
| 命令或測試 | 結果 |

被阻擋 / 未驗證
- <項目>:<仍需要的證明>

裁決:READY | NOT READY | UNVERIFIED

保持審查運行唯讀。如果使用者要求修復發現,請在受影響的程式碼中套用要求的修復,執行聚焦驗證,並回報剩餘風險。請勿從檢查就緒狀態的請求中推斷編輯授權。

當報告區分了已驗證行為與缺口,或要求的修復已套用並驗證時,即完成。

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

相關技能