cot-lint

你的编码助手写出了不错的代码，却顺带把设计会议的编号、对着已离开评审者的解释、以及先这样回头再改的自白全部写进了文档、注释和 JSDoc。这些残留对代码本身没有害处，却对任何没有在场的人构成了阅读障碍。cot-lint 就是为此而生：它扫描仓库文本，用一条统一判据来检验每段文字——一个只拥有 HEAD 的读者能否独立解析每一处引用、验证每一条声明。

核心能力方面，cot-lint 覆盖八类泄漏模式：死会议引用、PR 视角、变更叙述、评审编排、面向评审者的辩解、控制流旁白、犹豫与规划残留、以及跨语言工作语泄漏。中英文检测器内置，零外部依赖，Node 20 即可运行。退出码 0、1、2 分别对应干净、有发现、用法错误，直接嵌入 CI 流水线即可。工具同时内置一套 keep-rules，明确豁免 issue 引用、TODO 标记、RFC 等外部标准引用，避免误伤真正有用的注释。配套的 cot-trim 技能则不止于发现，它会逐条判断每个命中项、先枚举段落中的命题再动手修改，并且优先修改源头而非生成物。

适合谁用？任何使用 AI 编码助手的团队、任何希望文档对 HEAD 读者自洽的仓库、任何想在 CI 中加一道文字卫生检查的项目。它不挑仓库语言、不挑 agent，MIT 协议，拿来即查。