Prelint

Prelint：防止AI代码偏差，确保AI生成代码与产品规格精准对齐

在当今的软件开发中，AI 编写代码已成为常态，但 AI 往往存在一个致命缺陷：它虽然能读懂你的规格书，却无法理解背后的业务意图。这导致了所谓的“产品偏差（Product Drift）”。Prelint 是一款专为解决这一问题而生的自动化产品评审工具。通过在每一个 Pull Request (PR) 阶段对照产品规格书进行检查，Prelint 能在偏差发生之前及时拦截，确保 AI 生成的代码始终符合业务逻辑与战略方向。

什么是 Prelint？

Prelint 是一个集成在 GitHub 工作流中的产品评审 Agent。如果说传统的代码评审（Code Review）关注的是“代码能否运行”以及“是否安全”，那么 Prelint 关注的则是“这段代码是否应该存在”以及“它是否符合产品规格”。

AI 编写的代码往往会悄然偏离预定的商业模型。Prelint 通过在代码合并前进行全自动化的产品评审，约束 AI 智能体的行为。它能够理解完整的产品上下文，捕捉规格书之间的矛盾、技术选择的冲突以及重复的开发工作，从而让 AI 智能体在无需人工干预的情况下进行更长时间的迭代。

Prelint 的核心功能

1. 自动执行产品意图

您的产品规格书直接存储在 GitHub 中。Prelint 会检查每一个 PR，确保代码与既有的决定、一致性和完整性保持对齐。这一切都在后台自动完成，无需召开繁琐的评审会议。

2. 机器可读的产品约束

Prelint 能够理解深层次的产品语境。它能检测到如定价策略冲突、合规性漏洞等人类工程师可能忽略的细节，并在问题进入生产环境前发出警报。

3. 无需中断工程师的问答系统 (MCP)

利益相关者可以通过 Prelint 询问“为什么我们这样构建这个功能？”，并获得基于规格书的准确回答。这让工程师能够专注于心流工作，无需频繁参与同步会议。

4. 严苛的安全性保障

Prelint 采用隔离的组织架构运行，严格遵守以下安全标准：

• 零留存：不同组织间数据完全隔离。
• 不参与训练：您的代码永远不会被用于训练任何模型。
• 最小权限原则：仅申请必要的 GitHub 权限。
• 全方位加密：传输中使用 TLS 1.3，存储中使用 AES-256 加密。

AI 代码偏差的六种形式：Prelint 如何应对

AI 在没有约束的情况下，会通过以下六种方式产生偏差，而 Prelint 能够精准识别并纠正这些问题：

• 业务逻辑偏差：AI 可能会在不理解财务影响的情况下修改定价或计费规则。例如，将供应商货币切换为客户货币，导致公司承担汇率波动风险。
• 合规性风险：AI 可能会在存储数据时忽略同意流程或违反保留规则（如 GDPR 或 CCPA），而 Prelint 能在审计发生前识别风险。
• 工具链与架构冗余：AI 喜欢引入新的依赖项。例如，在团队已有标准方案的情况下引入竞争供应商的 SDK，造成不必要的架构分裂和成本增加。
• 领域语言混乱：AI 常使用通用术语而非内部统一语言（如将代码库中的“Merchant”写成“Seller”或“Partner”），导致概念分裂。
• 功能蔓延 (Scope Creep)：AI 往往会构建没人要求的过度功能，例如为国内产品添加国际化支持，增加不必要的维护负担。
• 战略偏差：AI 可能会构建脱离路线图的功能（如为内部工具构建复杂的公共 API），浪费数个开发周期。

典型使用场景

场景一：国际结算中的汇率风险控制

在一项涉及国际结算的定价修改中，AI 代理可能会将费用按当天汇率转换并存储在客户货币中。Prelint 会立即检测并对比 Notion 中的定价规格书，指出：“规格书要求始终以供应商货币存储费用，仅在展示时进行转换。”通过这种方式，Prelint 防止了平台由于汇率漂移而遭受财务损失。

场景二：防止无效的需求堆砌

当销售团队请求添加 Google OAuth 登录以解决企业交易时，Prelint 可以迅速分析历史规格文档并指出：特定大客户需要的是 SAML/OIDC 联邦身份验证，而非社交登录。这避免了开发团队走向错误的路径，并提供了更快的替代方案。

Prelint 如何运作 (How to Use)

Prelint 与您现有的开发流程无缝集成，只需三步即可开启：

1. 规格书入库：将您的产品约束、Markdown 或 YAML 格式的文档存储在代码仓库中，确保它们是版本受控且最新的。
2. AI 提交 PR：无论是人类开发者还是 AI 智能体提交拉取请求，Prelint 都会自动触发。
3. 秒级评审结果：Prelint 根据完整的产品上下文评审代码。如果发现偏差、冲突或遗漏，它会直接在 PR 中内联标记，以便 AI 代理或工程师自我修正。

常见问题解答 (FAQ)

Q: Prelint 究竟评审什么？ A: Prelint 评审的是“意图”而非“实现”。它检查 PR 是否违反了公司预设的产品规格、合规规则、业务约束或架构决策。

Q: 它与普通的代码评审（Code Review）有什么不同？ A: 代码评审关注技术正确性（如安全、性能、模式），而 Prelint 关注业务正确性（如是否符合路线图、是否满足业务逻辑、是否遵循工具链标准）。

Q: Prelint 如何计费？ A: 您可以免费试用 Prelint，无需信用卡，注册即送 $10 免费额度。

Q: 它支持哪些平台？ A: Prelint 目前完美集成于 GitHub 工作流中，支持多种格式的文档解析。

Q: 设置 Prelint 需要多久？ A: 设置过程仅需几分钟。一旦集成，它就会在您的下一个拉取请求中开始工作。

通过 Prelint，您的产品意图将得到自动化强制执行。它让 AI 智能体在正确的轨道上高速运行，避免错误堆叠，确保最终交付的代码正是您想要的产品。