用途
Tidy 用于审查代码变更并可选地修复它们。它审查的对象包括本地 diff、分支 diff、PR，或指定的安全范围，返回按严重程度分层的发现，每条发现都带有 file:line 证据。在应用模式下，它还会落地针对这些发现的最小完整修复，以及对 diff 范围内代码的简化。
它明确不负责：创建 PR（属于 pr-creator）、CI 失败与审查线程（属于 pr-babysitter）、面向用户的 UX、可访问性或渲染质量（属于 ui-design 的 Audit 模式）、库或 CLI 的人机工程（属于 dx-audit）、架构简报与仓库级护栏（属于 codebase-architecture）、审查计划（属于 planning）、按测量目标进行套件级测试裁剪（属于 test-audit）。
主要能力
- 报告或应用两种模式：报告是默认模式，触发词包括“review my changes”“code review”、模式短语或 PR 编号。报告模式保持工作区不变，即使是一个字符的修复也不编辑文件。应用模式在用户说“tidy”“simplify”“fix”“apply the findings”或要求直接做出更改时触发，会编辑 diff 触及或修复所需的任何文件，并运行仓库文档化的 lint、类型和测试命令。应用模式不会提交、推送、开 PR、添加或升级依赖、运行迁移，也不会在工作区之外写入。
- 模式分派：根据用户措辞选择一个视角。标准模式（默认）不额外加载；结构模式（触发词如“structural review”“thermo-nuclear review”“deep code quality audit”“harsh maintainability review”“code judo”）加载结构质量评分表；Deslop 模式（触发词如“deslop this”“clean up AI code”“remove slop”“review for AI patterns”）加载 AI 模式清单；安全审计模式（触发词如“security audit”“find vulnerabilities”“deepsec”“threat model”“audit for security”）加载安全检查清单，范围是命名子系统或整个仓库，与 diff 无关。
- 条件加载：当 diff 由智能体编写，或新增、修改、删除模块、系统边界、守卫或回退时，加载上下文错误参考；涉及认证、输入处理、外部 API、上传、依赖或锁文件变更、环境配置时，加载安全检查清单；涉及获取、渲染、图片、依赖或影响打包的导入时，加载性能检查清单；当 diff 新增或修改测试时，加载测试门禁参考。
- 五遍审查：声明映射（把描述或提交信息中的每个声明映射到 hunk，反之亦然）、新增行审查（读取每个 hunk 及其所在函数）、删除行审查（为每个删除或替换的行命名其维护的不变量，并找到新代码重新建立它的位置）、调用点审查（对每个变更函数，grep 其调用者以发现新的前置条件、变更的返回形状、新异常或顺序依赖）、diff 之外审查（对每个新模块、守卫或回退，打开 diff 未触及的文件）。
- 判定分级：每个候选发现被判定为已确认（能命名触发输入或状态以及错误输出，并引用该行）、可能（机制真实但触发不确定，说明什么能确认它）或已反驳（事实错误或已有守卫，引用证明它的行）。可能级别是默认。
- 应用模式：按根因合并发现，先修正确性，再修归属，最后简化剩余部分。从复用、质量、效率、归属、测试价值五个角度扫查 diff。约束包括：删除守卫需要系统证据；不对无关编辑做整文件回滚；不设抽象配额；测试跟随风险；已确认的测试门禁发现被删除或重写；在证据处停止。
- 高信号标准：包括编译、类型、导入或语法失败；被丢弃的捕获错误；具体利用路径；缺失必要测试；消费者缺失或不可达的脚手架；覆盖部署从不产生的状态的守卫；新的 lint、类型检查或测试失败；作用域指令文件或 REVIEW.md 违规；重试或至少一次写入无幂等键等。
使用方式
用户通过自然语言触发词调用，例如“review my changes”“code review”“tidy this”“deslop this”“security audit”等。工作流程为：发现目标（先看暂存和未暂存变更，若干净则看分支 diff，PR 则用 gh pr diff）、收集上下文（打开模式参考和条件加载，捕获意图，加载作用域 AGENTS.md / CLAUDE.md 和根 REVIEW.md）、审查（五遍）、判定、报告或应用。输出格式包含“Must fix before push”“Should fix soon”“Ready for handoff”等区块，每条发现带 file:line、一行影响和可提交的修复。
适用场景
适用于需要审查本地或分支代码变更、PR，或进行安全审计的开发者。特别适合希望获得分层发现、带证据的 file:line 引用，以及可选自动修复的场景。也适合清理 AI 生成代码（Deslop 模式）和深度结构质量审查（结构模式）。
限制
不创建 PR、不监控 CI、不处理 UX 或可访问性、不做库或 CLI 人机工程审查、不做架构简报、不审查计划、不做套件级测试裁剪。应用模式不提交、不推送、不开 PR、不添加或升级依赖、不运行迁移、不在工作区之外写入。报告模式绝不编辑文件。部分功能（如可选第二意见通过 agents/openai.yaml）需要安装不同模型的 CLI。具体收费、价格、平台支持等信息暂未提供。