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代理生成代码提供了硬性的质量护栏，确保代码标准得到严格执行，从而提升整体代码质量。