alint — model-backed lint rules for agent-generated code
alint — model-backed lint rules for agent-generated code
一句话结论
alint 是一个受 ESLint 启发的 agentic code analysis 工具：它让团队用模型调用或工具型 agent 编写“lint 规则”，并以熟悉的诊断格式检查 vibe-coded / AI-generated code。它值得入库，因为它把 AI-Code-Review 中的审查经验从一次性评审推进到可版本化、可运行、可复用的模型规则。
为什么对用户重要
用户经常使用 Hermes 执行代码修改、wiki 维护和自动化。传统 lint 能抓语法、格式、类型和少量静态模式，但抓不住很多 AI 生成代码的典型问题：需求误读、虚构 API、测试剧场、上下文遗漏、架构约束违反、文档/实现不一致。alint 的思路是把这类“需要语义判断”的检查变成项目内可配置规则，让 agent 生成物在进入 review 前先被模型-backed diagnostics 扫一遍。
这对 Harness-Engineering 的意义是：review 不应该完全靠最终人工/LLM reviewer，而应把常见失败模式沉淀成可执行 gate。
机制 / 一阶原理
alint 的关键抽象是 model-backed lint rule：
- Rule as policy：规则作者把某类质量要求写成可运行规则，而不是散落在 review comment 或 AGENTS.md 中。
- Model call for semantic judgment：当判断需要跨文件语义、意图或上下文时，规则可以调用 OpenAI-compatible provider，甚至使用 tool-using agent。
- Diagnostics format：输出像 lint 一样定位到文件/问题/严重度，便于 CI、编辑器或 reviewer 消费。
- Provider swappability：支持本地或云端 OpenAI-compatible provider，允许团队在成本、隐私和质量之间取舍。
第一性原理上，它承认“LLM 既是生成器，也是弱审查器”，但把弱审查器约束在小而明确的规则里，降低开放式 review 的漂移。
与现有 wiki 概念的关系
- 对 AI-Code-Review：alint 可实现 evidence pass / integration pass 的部分自动化，但不能替代独立 verdict。
- 对 Harness-Engineering：它是 deterministic lint 与 LLM reviewer 之间的中间层，可作为 pre-merge gate。
- 对 Agent-Benchmarks：规则有效性本身需要基准样例，否则容易产生 false positives / false negatives。
- 对 External-Agent-Skills-Design-Patterns：规则库和 skill 类似，都需要触发边界、样例、版本、禁用和评估闭环。
对 Hermes / llm-wiki 的可执行启发
- 为 wiki 页面建立 semantic lint：除了 broken wikilink/frontmatter，还可检查“是否有为什么重要、机制、关系、实践启发、失败模式、写入记录”。
- 把常见报告失真变成规则：例如“声明重建 vector index 但无工具输出”“新增页面无 raw source”“updated 未更新”“只浅摘要无深度判断”。
- 小规则优先于大 reviewer：与其让一个 reviewer 一次性判断所有问题，不如先沉淀 5-10 个高价值规则，在 cron 后自动运行。
- 规则需要 gold examples：每条 semantic lint 规则应有至少一个应该通过/应该失败的页面样本，避免模型规则自我漂移。
深度判断
值得晋升：alint 把 AI code review 的知识从“人如何看 AI diff”转化为“机器如何持续执行语义规则”。这直接补充了用户 wiki 里的 AI-Code-Review 和 Harness-Engineering：harness 的下一步是把经验规则变成可运行检查。
失败模式 / 边界条件
- 模型规则不稳定：同一规则在不同模型、temperature、上下文下可能给出不同诊断，需要固定配置和回归样例。
- 成本与延迟：对大仓库运行模型-backed lint 可能昂贵，必须有文件过滤、缓存和分级触发。
- 规则幻觉：模型可能报告不存在的问题；诊断必须附带引用位置和证据片段。
- 不能替代测试/类型系统：alint 应作为 semantic pre-review layer，而不是 CI 的唯一依据。
写入记录
- 2026-07-24 09:01 CST：新增 alint 源页面，聚焦 model-backed lint rule、AI 代码审查自动化，以及 llm-wiki semantic lint 启发。