Community寫作與編輯github.com

Dev-PGVAA/skills

專注撰寫可驗證的程式碼變更,或對 diff、commit 及 pull request 進行以缺陷為優先的審查。適用於實作規範、重構與程式碼審查;僅在要求時選擇審查模式。新名稱保持簡短易讀;註解說明原因,而非行為。

skills 是什麼?

此技能旨在協助開發者或 AI 代理在實作、重構或程式碼審查時,維持高品質的程式碼標準。它提供兩種主要模式:實作/重構模式與審查模式。實作模式下,使用者應定義可觀察的驗收標準,並使用專案實際的工具鏈。審查模式則要求保持唯讀,除非也要求修復,並在得出結論前確認比較對象。該技能強調整潔、聚焦且可驗證的變更,避免為了滿足技能本身而建立多餘的計劃、抽象或測試。它還包含有效的委派策略,例如將獨立檔案分割給不同的子代理,或在審查時按風險領域分配任務。完成時需報告實際的行為變更或發現的問題、實際執行的檢查,以及任何重大限制。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Dev-PGVAA/skills/tree/HEAD/code-quality

Installed? Explore more 寫作與編輯 skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

在你喜歡的 AI 中提問

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

說明文件

程式碼品質

使要求的行為透過聚焦的變更正確;使用具體證據審查缺陷。尊重儲存庫指示、現有架構、使用者編輯以及要求的讀/寫範圍。

選擇模式

  • 實作 / 重構: 閱讀 準則。定義可觀察的驗收標準並使用儲存庫實際的工具。
  • 審查: 閱讀 審查。保持唯讀,除非同時要求修復。在得出結論前確認比較對象。
  • 小編輯需要小工作流程。不要僅為了滿足此技能而建立計劃、抽象、測試或額外檔案。

有用的委派

使用可用的子代理來進行能大幅減少不確定性的獨立工作。當情境轉移成本高於任務本身時跳過委派;若代理不可用,則依序使用相同角色。

  • 實作: 合約偵察員在父代理實作的同時讀取呼叫端、介面及現有測試;驗證員在穩定補丁後執行變更行為。僅在真正獨立的檔案間分割實作,每個檔案有一個擁有者,父代理擁有整合檔案。
  • 審查: 按風險劃分,例如授權/資料處理和狀態/並行,或不相關的模組。為每位審查者提供相同的基底/頭端及所需的使用者行為。父代理追蹤跨模組路徑,檢查每個提出的發現,移除重複項,並指定最終嚴重性。
  • 委派任務需指定目標、允許的路徑、讀/寫範圍、假設、停止點以及預期的證據。回傳變更的檔案或 path:line 的發現、實際的重現/測試結果,以及未解決的問題。不要在沒有有用且受限的理由下遞迴委派。

完成

報告已變更的行為或可行的發現、實際執行的檢查,以及重大限制。「無發現」是有效的;通過型別檢查並非執行期行為或部署的證明。

Individual skills in this repo

This repo contains 3 individual skills — each has its own dedicated page.

相關技能