icpg

icpg 技能概覽

icpg 技能是做什麼的

icpg 技能替程式碼理解加上一層「WHY 層」。它不只是在對應結構，而是把函式、類別與模組連回它們存在的理由、負責人，以及是否仍符合原本的設計意圖。當你需要 icpg 進行 Code Review、重構，或自主維護時，它最大的價值是在變更程式碼之前，先降低猜測成本。

它最適合誰

icpg 很適合在活躍程式碼庫中工作的工程師與 agent，特別是當行為、擁有權與設計意圖比快速掃過語法更重要的時候。當 repo 累積了漂移、任務歷史不清楚，或常常出現「這段到底為什麼要寫？」這類問題時，它最有用。

它的不同之處

這個技能以 ReasonNodes、正式合約與跨多個維度的漂移偵測為核心。也就是說，icpg 不只是程式碼地圖，而是一個用於事前分析的決策支援層。實際好處是提升變更安全性、讓審查脈絡更清楚，並減少那些悄悄違背原始意圖的修改。

如何使用 icpg 技能

安裝並找到核心檔案

先依照 repo 的技能安裝流程完成安裝，接著從 skills/icpg/SKILL.md 開始。由於這個 repository 沒有提供輔助腳本或支援資料夾，技能檔本身就是主要的真實來源。若要快速判斷是否要安裝，先看 frontmatter 和前幾個段落，再決定下一步。

把模糊目標轉成可用的提示詞

icpg usage 最適合在你提供具體任務、目標路徑，以及期待的輸出形式時使用。好的輸入例如：「在我改 retry logic 之前，先檢查 src/payments/charge.ts 是否有意圖漂移」或「為 auth flow 建立 ReasonNodes，並找出缺少的 ownership 連結。」像「分析這個 repo」這種太籠統的請法，通常抓不到這個技能擅長的意圖追蹤能力。

第一次使用時建議的流程

先問目標程式碼原本是要解決什麼，再問有哪些約束或合約保護它，最後再問哪些地方最可能出現漂移。這個順序符合技能設計，也能幫助 agent 由結構走向意圖，再走向風險。若是 icpg guide 工作流程，請把請求聚焦在單一模組或單一變更集，不要一開始就拉到整個 repository。

先看 repo 裡的哪些內容

先從 SKILL.md 讀起，特別是目的說明、CLI 範例，以及涵蓋核心原則、標準事前查詢、ReasonNode 和 edge types 的段落。這些內容最可能影響採用決策，也最會左右 icpg 在 Code Review 時的輸出品質。

icpg 技能常見問題

icpg 只適合自主 agent 嗎？

不是。icpg 對人類與 agent 都有用，但在系統需要可重複的事前推理時，效果最明顯。如果你只需要一次性的摘要，一般提示詞可能就夠；如果你要的是帶有意圖感知的 code review 或變更規劃，icpg 會更合適。

icpg 跟一般的程式碼提示詞有什麼不同？

一般提示詞可以摘要程式碼，但 icpg 的設計目標是保留任務之間的意圖、擁有權與漂移脈絡。當你在變更前需要先回答「這段程式碼是拿來做什麼的？」而不只是「這段程式碼在做什麼？」時，它會更有價值。

icpg 適合新手嗎？

新手也能用，但最好的效果通常來自能精準指出檔案、功能或變更邊界的使用者。如果你剛接觸這個 repo，建議先從單一模組開始，要求它說明意圖、約束與審查風險，而不是直接做全系統分析。

什麼情況下不該用 icpg？

當任務很單純、程式碼彼此獨立，或你只需要快速的表層說明時，可以先跳過 icpg。如果你無法提供目標區域或任何變更脈絡，它也不是好選擇，因為這個技能的價值建立在把程式碼對應到「它為什麼存在」的具體理由上。

如何改進 icpg 技能

提供更強的任務脈絡

最好的 icpg 結果，來自包含變更目標、受影響檔案，以及哪些部分絕對不能壞的提示詞。例如，「新稅則上線後，請檢查 src/billing 是否有漂移」就比「檢查 billing code」更有力。這能幫助技能在 icpg for Code Review 中找出正確的 ReasonNodes 與約束。

先問意圖，再談實作

常見失敗模式是直接跳去改程式碼，卻沒先確認它原本想保護什麼。想讓輸出更好，可以先要求原始目的、現有合約與疑似漂移，再請它提出變更方案。這個順序能降低非預期回歸，也讓審查輸出更值得信任。

用第一輪答案來縮小第二輪範圍

如果第一次回覆太廣，就用模組、工作流程步驟或擁有權邊界來縮小範圍。如果答案太淺，就再問缺少的合約、最可能漂移的維度，或最符合任務的標準事前查詢。這種迭代方式通常比單純要求更長的回覆更能提升訊號。

讓提示詞和技能設計保持一致

icpg skill 最擅長的是理由追蹤、漂移偵測與事前分析，而不只是程式碼解釋。如果你想得到更好的 icpg usage，請把「完成」的定義、你正在考慮的變更類型，以及程式碼庫中哪些部分在範圍內一起寫清楚。