SpecFact CLI：面向 Python 团队的 AI 代码膨胀防御与确定性代码审查命令行工具

核心能力与快速开始

★ 17 · Python

能做什么

提供本地、确定性的 Python 代码审查，运行 Ruff、Radon、Semgrep、AST 清洁代码检查、basedpyright 类型检查、Ruff lint 策略检查、契约检查和针对性测试与覆盖率检查，输出判定结果（Verdict/CI 退出码/评分）。针对 AI 辅助编码常见的代码膨胀形态给出 ai_bloat 建议，如冗余包装器、直通 lambda、恒等 try/except、可避免的中间列表、低分支长函数。可生成清理影响预测与 AI 膨胀指数，并产出可移植的 JSON 报告作为交接工件，供 AI IDE 或无头代理使用。还可从既有代码中反向提取结构、对照契约/清洁代码规则/策略关卡审查改动、在合并前阻止漂移，并消费 Spec Kit、OpenSpec、backlog、specs、tests、contracts 等作为验证证据。具备模块系统，可安装 project、backlog、code、spec、govern、requirements 等模块族。

适用场景

适合使用 AI IDE 的 Python 个人开发者与团队，在 AI 辅助代码进入 PR 前进行确定性的本地审查与膨胀清理；适合维护存量（brownfield）遗留代码的维护者在修改前反向提取结构；适合需要统一 IDE、CI 与 PR 之间审查规则、在预提交钩子或 GitHub Actions 中设置质量关卡的团队；也适合需要将清理修复包交给 AI 代理处理并复跑审查验证的简化流程。

项目形态

可直接使用的工具

部署方式

本地 CLI 运行；可在 pre-commit 钩子与 GitHub Actions（如 uvx specfact-cli@latest govern enforce stage --preset minimal）中运行；无需 API 密钥、可离线工作；支持 uvx 零安装或持久安装。

主要依赖

面向 Python 项目；使用 uvx 试用；审查管线依赖 Ruff、Radon、Semgrep、basedpyright、契约检查与测试等本地工具链（官方模块文档提及具体命令与标志）。

使用限制

当前状态为 beta；膨胀相关发现属于代码形态检测与清理指引，并非 AI 作者身份识别，资料未说明检测准确率或误报率；未说明许可之外的商用限制、API 成本与硬件要求（官方称无需 API 密钥且可离线）。

许可证

Apache-2.0

最近推送

2026-09-17 06:38

资料检查：2026-09-17 07:00 · 卡片整理：2026-09-17 07:00
卡片由 AI 根据仓库资料整理，未进行安装或运行验证 · 本次更新未完成，保留上次成功内容

职业应用

程序员

在本地对 AI 辅助编写的 Python 代码运行确定性代码审查，检测冗余包装器、直通 lambda、恒等 try/except、可避免的中间列表、低分支长函数等 AI 编码膨胀形态，并将 JSON 审查结果交给 Claude、Codex、Cursor、Copilot 或无头代理进行修复，再复跑审查获得证据；也可接入 pre-commit 钩子和 GitHub Actions 在合并前阻止代码漂移。

官方使用入口 ↗

由 AI 根据来源材料整理，未进行安装或运行验证