邏輯性程式碼庫審計技能 是做什麼的？
一個 Claude 技能，用於審計任何程式碼庫的真實性，透過 12 個階段和 21 本書籍框架找出幻影功能、存根整合與不一致的主張。
概述
此技能會掃描您的程式碼庫，找出幻影功能（聲稱存在但未實作的功能）、存根整合（僅有外殼但未實作的 API/服務呼叫）以及誤導性主張（文件、提交訊息或註解與實際行為不符）。它運用 12 個審計階段，並引用 21 本軟體工程經典著作（如《Code Complete》、《Working Effectively with Legacy Code》等）中的邏輯架構，確保審計過程徹底且具備可回溯性。
功能特色
- 12 階段深度審計：從靜態分析到語義一致性檢查，逐步覆蓋所有層面。
- 21 本書籍框架：每個審計階段對應特定書籍原則，例如《The Art of Unit Testing》用於測試覆蓋率檢查。
- 真實性評分：為每個模組與整個程式碼庫提供量化真實性指標。
- 報告產出：生成結構化報告（支援 Markdown 與 JSON 格式），列出發現的問題與建議修復措施。
- 增量審計：支援僅針對 Git 差異提交進行審計，適用於 CI/CD 流程。
支援平台
- Claude Code：直接作為技能載入，透過對話介面執行。
- Cursor：可整合為自訂指令或工作流程步驟。
- Codex：作為外掛或腳本觸發。
- 其他 AI 代理：若支援自訂技能/工具，通常可透過標準輸入/輸出整合。
使用方式
- 將此技能下載至您的 AI 代理技能目錄（例如
~/.claude/skills/）。 - 開啟您的專案目錄，確保已初始化 Git 倉庫。
- 呼喚技能：
claude skill run logical-codebase-audit --target /path/to/repo - 或直接在對話中要求：
使用 Logical-codebase-audit 審計目前專案的真實性。 - 檢視報告（位於
./audit-report.md或終端機輸出）。
審計階段
| 階段 | 名稱 | 對應書籍框架 |
|---|---|---|
| 1 | 功能宣告清查 | 《The Pragmatic Programmer》 |
| 2 | 符號是否存在 | 《Clean Code》 |
| 3 | 整合點掃描 | 《Building Microservices》 |
| 4 | 測試覆蓋率比對 | 《The Art of Unit Testing》 |
| 5 | 文件一致性 | 《Docs for Developers》 |
| 6 | 提交歷史追溯 | 《Git Pro》 |
| 7 | 錯誤處理檢查 | 《Code Complete》 |
| 8 | 安全邊界驗證 | 《The Tangled Web》 |
| 9 | 效能宣稱驗證 | 《High Performance Browser Networking》 |
| 10 | 依賴真實性 | 《Working Effectively with Legacy Code》 |
| 11 | 語義完整性 | 《Domain-Driven Design》 |
| 12 | 綜合評分與報告 | 《Software Engineering at Google》 |
注意事項
- 技能僅讀取檔案，不會修改任何內容。
- 對於大型程式碼庫，建議先對特定目錄或模組執行，以減少執行時間。
- 報告中的真實性評分僅供參考，不可作為最終部署決策的唯一依據。
授權條款
此技能採用 MIT 授權。