Security Audit Skill 保姆級教學：讓 Claude Code 變成 AI 安全審計員，從程式碼掃描到漏洞報告完整實戰

程式碼審查常卡在掃描結果零散、證據不足，或 AI 把推測寫成漏洞結論。
最快的做法是用 Security Audit Skill 固定審計步驟，再由 Claude Code 協助檢查、調用已授權工具及整理證據；但發現是否成立、風險如何分級，仍須人工複核，不能把流程當成安全認證。

適合正在用 Claude Code 標準化重複審查工作的開發者，以及需要整理可複核漏洞報告的安全工程師。
若你正評估 AI Agent 能否加入團隊審計流程，本文也會說明權限、工具覆蓋與人工責任的分界。

先界定 Security Audit Skill 能做與不能做的事

Security Audit Skill 是一組可重複使用的指令與工作流程，不是獨立的掃描引擎，也不會自動取得未設定的工具或權限。Claude Code 可依指令檢視程式碼、追蹤指定資料流、呼叫工作環境中已配置且可用的工具，並把結果整理成報告；掃描工具負責其支援範圍內的規則檢查，審計人員負責確認可達性、影響與修正是否有效。

角色	可承擔的工作	不應直接推定的事
Security Audit Skill	規定檢查順序、輸出欄位、證據要求與升級條件	指令本身能發現所有漏洞
Claude Code	按範圍檢視程式碼、解釋呼叫關係、整理工具輸出	模型提出的疑點必然可重現
已配置的掃描工具	執行其規則與語言支援範圍內的靜態檢查	未報告的問題就不存在
人工審計者	核對程式路徑、信任邊界、業務影響與修復結果	可只看摘要而不檢查證據

Security Audit Skill 怎麼設定，才能讓 Claude Code 檢查程式碼安全問題？
先限定授權倉庫、目標目錄、語言與風險類型，再寫入檢查流程和證據格式；如果沒有設定掃描工具，就明確要求 Claude Code 只做程式碼層面的初步分析，不得聲稱已執行工具掃描。官方 Skills 文件說明了 Skill 的目錄與 SKILL.md 格式，也說明可透過名稱呼叫或依描述載入；實際使用方式應以官方 Skills 配置說明為準。

這裡有一個重要限制：Skill 的文字指令不能取代 Claude Code 的權限設定。工具能否讀寫檔案、執行命令或呼叫外部服務，仍受目前權限模式與設定控制；應先閱讀權限規則文件及安全說明，避免在只需讀取程式碼的審計中意外開放修改或不必要的命令執行權限。

第一步：把審計範圍縮到可核對的邊界

不要只輸入「檢查整個專案有沒有安全漏洞」。範圍過廣時，模型可能把測試碼、產物或相依套件一併納入，卻沒有足夠上下文判斷哪些路徑可由外部輸入觸發；範圍過窄則可能漏掉驗證、授權或資料儲存所在的相鄰程式。

以下表格適合在開始前填寫。路徑及風險欄位應對應實際倉庫，不要把範例路徑照搬成通用規則。

範圍項目	建議提供的內容	未提供時的常見後果
授權對象	倉庫名稱、分支或提交版本，以及允許檢查的目錄	不清楚檢查對象，結果難以重現
排除路徑	建置產物、測試樣本、產生碼及不納入範圍的目錄	噪音增加，分析焦點偏移
語言與入口	使用語言、服務入口、路由或主要資料流	難以辨認程式間的信任邊界
優先風險	例如輸入驗證、存取控制、敏感資料處理	泛泛掃描，重要路徑未必優先
上下文	認證方式、資料來源、部署假設、已知控制措施	可能把已有防護的路徑誤判為可利用問題

可在審計請求中寫清楚：「僅檢查已授權的 src/api/ 與 src/auth/；忽略產生碼及測試資料；追蹤外部輸入如何到達資料庫操作；未能從程式碼證明的情況列為待核查，不要推定其可利用。」這類限制比單純增加風險關鍵字更能降低誤報，也能讓後續安全人員重現判斷。

第二步：用 SKILL.md 固定檢查順序

官方文件所述的專案 Skill 可放在 .claude/skills/<skill-name>/SKILL.md；下例使用 .claude/skills/security-audit/SKILL.md，並以官方文件列出的 name、description 前置資料欄位組織內容。檔案位置、格式或呼叫方式若有變更，應按Skills 文件重新核實，而非沿用舊範本。

---
name: security-audit
description: 審查已授權倉庫中的指定程式碼，整理有證據的安全疑點與待核查項。
---

# 審計規則

只檢查使用者明確授權的路徑與版本。
先確認專案結構、入口、資料來源及相關控制措施。
依序檢查輸入處理、存取控制、敏感資料流與危險操作。
如已配置並獲准使用掃描工具，才執行相關檢查；
在結果中標明工具名稱、命令及其實際輸出，不得假稱已執行。
每項發現記錄檔案位置、相關程式片段、資料流及限制條件。
無法由證據確認的問題標為「待核查」，不得寫成已確認漏洞。
未獲明確同意，不修改程式碼、不執行破壞性命令。
輸出漏洞類型、影響、修復建議、驗證狀態及待確認事項。

此範本的重點不是讓 Skill 輸出更多發現，而是要求每項結論都能回到程式位置和上下文。掃描工具的命令應由團隊依已安裝工具、語言與倉庫政策補上；不要把某一條命令寫成所有專案都支援的固定能力。

權限設定應與 Skill 指令分開檢查。Claude Code 的設定檔可控制工具權限，但 Skill 不應被視為權限邊界；變更專案或使用者層級設定前，先核對官方設定文件中的適用範圍。

第三步：在授權範例倉庫執行掃描並逐項核對

使用自行建立或明確獲准檢查的程式碼，先確認目前分支與待審目錄，再以 /security-audit 這類 Skill 名稱啟動流程。使用者請求應包含授權範圍、檢查重點及輸出要求；開始時先讓 Claude Code列出理解到的目標，若路徑或權限不符，停止並修正指令，不要讓它自行擴大範圍。

接著按 Skill 指示檢視相關檔案；若環境中已配置掃描工具，且當前權限允許，才執行指定檢查。保存工具輸出與錯誤訊息，不要把「工具沒有報錯」等同於程式安全。對每項疑點至少核對檔案位置、輸入來源、條件分支、中間驗證及敏感操作；若缺少關鍵檔案或執行環境，報告中應說明限制。

可用常見 Web 應用風險清單作為檢查方向，但它不是完整的漏洞檢測規則集；所列的十類風險可由Web 應用風險分類清單核對。弱點（weakness）與漏洞（vulnerability）也不可混為一談：程式碼中存在不良模式，不代表已證明能在特定系統中造成可利用影響；弱點與漏洞定義說明有助於維持這個區分。

Security Audit Skill 掃描出的疑點，如何由 Claude Code 驗證和分級？
要求 Claude Code 對照程式位置與資料流，列出支持和反對該判斷的證據；工具若有結果，須與原始輸出比對。分級應依團隊定義的影響、可達性與現有控制措施，而非僅憑模型使用「高風險」等字眼。下表的狀態是報告工作流標籤，不是通用的漏洞嚴重度標準。

狀態	判定條件	報告處理方式
已確認	程式位置、觸發條件及安全影響有可核對證據	記錄證據、影響、修復方向及人工確認者
待核查	有合理疑點，但缺少呼叫路徑、執行條件或環境資料	指明缺少什麼證據及下一步核查方式
不成立／誤報	程式上下文或有效控制措施能反駁疑點	記錄反證與適用範圍，避免重複報告

若檢查範圍涉及軟體開發流程，也可依安全軟體開發框架檢視如何準備組織、保護軟體、產出安全軟體及回應弱點；該框架提出四組高層實務，不代表執行其中任何一組便可證明程式沒有漏洞。

第四步：把發現整理成可重現的漏洞報告

Security Audit Skill 如何讓 Claude Code 從程式碼掃描整理漏洞報告？
在 Skill 中固定欄位與證據要求，並讓 Claude Code 將掃描紀錄轉成「發現—證據—判斷—修復—驗證」的鏈條。報告至少應包含漏洞類型、受影響位置、相關程式上下文、輸入或呼叫路徑、影響判斷、修復建議、驗證狀態與尚未確認的假設；沒有證據支持的內容應保留為待核查。

掃描筆記	報告中的可複核寫法
「這段查詢可能有注入問題」	指出檔案與行位置，說明輸入如何到達查詢，以及是否經參數化或其他控制
「似乎沒有權限檢查」	標明入口、相關授權函式與可達分支；缺少呼叫上下文時列為待核查
「修好後應該安全」	寫明採用的修正、對應測試或重跑工具結果，以及尚未覆蓋的路徑

避免把「存在可疑字串」改寫成「可遠端利用」；除非已驗證觸發條件與影響，否則這是超出證據的結論。漏洞報告也要保留工具名稱和實際執行狀態，若工具未執行或不支援該語言，應明確註記。這種證據導向的整理方式，與安全軟體開發流程中的弱點處理及回應工作相互銜接，但不能取代專業審計。

用複核清單判斷是否可以交付

Claude Code 使用 Security Audit Skill 審計程式碼時，哪些項目仍須人工複核？
至少要檢查授權範圍、敏感資料處理、關鍵資料流、漏洞成立條件、工具涵蓋限制及修正後的重測結果。若發現涉及認證或授權繞過、敏感資料外洩、可遠端觸發的危險操作，或修復需要改變信任邊界，應由安全人員深入評估；只有模型摘要、沒有原始證據時，也不宜直接結案。

• [ ] 倉庫、分支、目錄與提交版本均在明確授權範圍內。
• [ ] 已提供語言、入口、資料來源及相關安全控制的必要上下文。
• [ ] Claude Code 沒有把未執行的掃描工具描述成已執行，也沒有擴大命令或檔案權限。
• [ ] 每項已確認問題都能回到程式位置、觸發條件及影響證據。
• [ ] 待核查項目寫出缺少的證據與下一個驗證步驟。
• [ ] 報告未包含不必要的憑證、個人資料或可直接暴露機密的程式片段。
• [ ] 修正後已按適用方式重跑檢查，並記錄尚未覆蓋的路徑。
• [ ] 需要安全專業判斷的高影響發現已交由適任人員確認。

AI 審計的可見盲點通常來自範圍、上下文與工具支援，而非報告排版。若倉庫含有機密資料，先按團隊政策處理存取與資料傳送；不要把敏感內容貼入未獲授權的環境。

完成範圍與複核清單後，先在已獲授權的程式碼倉庫試跑，再決定是否納入正式審查流程。若團隊需要遠端維持 Claude Code 與分析工具的開發環境，本機方案可能受裝置可用性、環境一致性與協作交接限制；雲端環境則仍須核對資料存取、權限與交付條件，不適合所有需要本機實體介面的工作。可先檢視 Zutcloud 的 Mac mini 租用資訊及服務條款，再依實際工作負載判斷是否需要租用遠端 Mac。