Forge – AI代理的代碼質量護欄

Forge是一個為AI代理時代設計的代碼質量管理工具。它通過一個pip可安裝的Python包（forge-scripts）提供一組確定性CLI工具，這些工具無論是由人類還是AI代理調用，都以相同的方式運行。其主要目的是在AI生成代碼越來越快的背景下，防止代碼質量下滑，如lint規則被靜默禁用、文檔字符串只寫一半、標準僅作為無法執行的文本存在。

Forge的核心組件包括：一個pip包，其中包含用於lint、文檔字符串驗證、測試命名、GitHub標籤和環境診斷的CLI；一個即插即用的預提交鈎子，無需每個倉庫的額外配置即可在每次提交時按順序運行這些CLI；以及一個可選的Claude Code插件，該插件將相同的CLI集成到AI代理會話中——這是一個附加組件，而非先決條件。所有機械性操作都是普通的CLI或shell鈎子，Claude Code插件只是其上的一個薄層協調器，門控始終是CLI，而非模型。

採用Forge只需三個步驟，大約一分鐘即可完成。第一步：通過pip install安裝forge-scripts包。第二步：運行install-forge-bootstrap，這是一個一鍵式自動安裝程序，用於設置git鈎子、生成FOUNDATION.md/CLAUDE.md、安裝規範的GitHub標籤方案，並運行forge-doctor進行驗證。第三步（可選）：安裝Claude Code插件，僅當團隊使用Claude Code時執行。

Forge的存在是因為大多數團隊在每個倉庫中積累相同的腳手架（如ruff配置、預提交鈎子、標籤設置腳本），但這些腳手架會逐漸漂移。Forge將這些腳手架整合到一個可pip安裝的包和一個即插即用的預提交鈎子中。採用Forge後，團隊可以獲得一套嚴格的ruff配置哲學、一個驗證Google風格文檔字符串的檢查器、一組一致的GitHub標籤，以及一個幫助貢獻者診斷本地安裝問題的forge-doctor CLI。

當前Forge提供了豐富的功能集，包括多種CLI（如install-forge-bootstrap、forge-upgrade、forge-precommit等）、審計包CLI（可選）、git鈎子以及可選的Claude Code插件。所有核心功能（前三個類別）都獨立於Claude工作，可在任何shell、CI或IDE中使用。審計包CLI需要額外安裝依賴。

總之，Forge通過確定性工具和自動化鈎子，為AI代理生成代碼提供了硬性的質量護欄，確保代碼標準得到嚴格執行，從而提升整體代碼質量。