33 evidence-backed checks

    AgentLint 会对 agent harness跑的 33 项检查。

    AgentLint 检查 CLAUDE.md、AGENTS.md、Cursor 规则（.cursor/rules）、CI、hooks 和相邻 rule files 是否正确、具体、结构清楚、可执行，并且干净到 agent 真能用。

    01 / 完整检查列表

    正确性

    8 项检查
    • harness 引用的文件，必须真的存在于那些路径。
    • 命令必须能从规则暗示的工作目录运行。
    • package manager 指引必须和 repo lockfiles 一致。
    • build、test、lint 规则必须和真实 project scripts 对上。
    • 工具名和 agent entrypoints 必须和已安装配置一致。
    • 本地文档链接必须能解析。
    • 环境变量名必须真实，而且拼写一致。
    • harness 规则不能和 CI、hooks 或 repository policy 冲突。

    具体性

    10 项检查
    • 模糊建议必须改成可观察动作。
    • 高风险文件类型需要明确 owner 或 approval 规则。
    • 常见 workflow 需要精确 verification commands。
    • 什么时候问、什么时候直接做，边界必须写清楚。
    • 禁止操作必须点名命令、路径或数据类别。
    • 预期输出必须说明格式或目的地。
    • 生成变更的限制必须说明 scope。
    • 决策规则优先于 personality traits。
    • 沟通要求必须能被判断。
    • 空泛形容词要么配例子，要么删除。

    结构

    6 项检查
    • 主规则文件应该短到可以快速扫完。
    • 稳定 headings 应该把事实、规则和 enforcement 分开。
    • 强制规则必须和偏好分开。
    • project facts 应该出现在 workflow policy 前面。
    • 工具专属规则应该待在工具专属层。
    • 重复规则需要指定 source of truth。

    执行

    5 项检查
    • 关键规则需要 CI、hooks、permissions 或 required checks。
    • 不安全操作需要机械化 approval boundary。
    • 格式规则需要 formatter command。
    • review 期待需要 checklist、test 或 handoff step。
    • 失败的 lint 需要 owner 或升级路径。

    卫生

    4 项检查
    • 历史说明应该从 active instructions 里移走。
    • secrets 和 private values 不能出现在 harness 里。
    • 工具或 workflow 变化后，规则需要周期性 review。
    • 例子必须使用当前 repo 名、路径和命令。

    对你的 repo 跑完整检查集。

    目标不是孤立地拿高分。目标是让 harness 给 agent 当前事实、清楚决策和可验证约束。

    安装 AgentLint