konsistent：为 Agent 统一 TypeScript 代码结构

是什么

文章介绍 Vercel 开源的 konsistent：一个面向 TypeScript 代码库的 CLI 检查器。它关注 TypeScript 类型系统和 ESLint 不擅长表达的结构性约定，用项目级 konsistent.json 描述规则，让 Agent 与工程师共享明确的实现边界。

核心设计

规则可以覆盖文件模式、导出内容、目录配套文件、类实现指定类型，以及文件内必须声明和使用的符号。示例中的 harness 检查会指出缺失的类型、常量、文件、导入和返回类型，说明它不仅检查格式，还能验证代码组织是否符合架构约定。工具强调确定性与速度，示例中扫描了 340 个文件。

关键洞察

Agent 编程的难点不只是生成语法正确的代码，还包括理解仓库隐含的结构规则。把这些规则显式化并纳入快速反馈回路，可以减少遗漏、降低上下文依赖，并让代码审查从经验判断转向可重复验证。

边界与风险

konsistent 更像结构契约层，而不是 TypeScript 或 ESLint 的替代品。规则质量取决于团队是否准确建模真实架构；约束过多会增加维护成本，约束过少则无法改善一致性。它也主要验证静态结构，不能证明业务逻辑、运行时行为或 API 设计正确。