用途:帮助开发者为仓库搭建 AI Checks。每个检查是一个 Markdown 文件,定义代码质量标准,在每次 PR 上作为完整 AI 智能体运行——不仅读取 diff,还能读取文件、运行命令、使用浏览器;发现问题则使 PR 失败并给出修复建议,否则静默通过。
主要能力与流程:
- 定位:创建会话待办清单(探索代码库并编写检查、试用检查、设置 CI(可选)、提交与 PR)。
- Git 准备:用 git rev-parse --git-dir 2>/dev/null 验证是否为 git 仓库;用 git status --porcelain 检查未提交更改,若脏则询问是否 stash 并新建分支 add-checks。
- 探索并编写检查:目标 60 秒内完成,浅层扫描项目结构、语言、框架、构建系统、已有 linter/formatter/类型检查器、测试框架、CI/CD、贡献指南(CONTRIBUTING.md、CLAUDE.md、AGENTS.md)及 PR 审查历史(gh CLI,不可用则跳过)。提出 3-5 条发现,再通过多选提出恰好 3 个检查(默认全选)。核心原则:不为已被确定性工具(linter、类型检查器、CI 步骤)强制的内容创建检查;检查用于需要判断的事项,如 slop、漂移的约定、安全反模式、品味问题。在 .checks/ 下每个检查写一个 .md 文件,含 frontmatter(name、description)及 Context、What to Check、Key Files、Exclusions 等章节,文件名小写连字符。并向项目智能体配置文件(CLAUDE.md、AGENTS.md 或 COPILOT.md,按所用工具选择,不存在则创建最合适的)追加 Checks 章节。
- 试用检查:让用户选择要试的检查,读取该文件并扫描代码库(读相关源文件而非仅 diff),逐条给出严重级别(Error/Warning/Info)、文件与行号、问题与修复方式;无问题报 PASS,有问题报 FAIL 并可提供修复。
- CI 设置(可选):询问是否通过 GitHub Actions 在每次 PR 自动运行,若同意则创建 .github/workflows/checks.yml,安装 @anthropic-ai/claude-code,获取 PR diff,逐个运行 .checks/*.md 检查,创建 check run 并汇总评论,上传产物。用户需自行在终端运行 echo "YOUR_API_KEY" | gh secret set ANTHROPIC_API_KEY --repo <owner>/<repo> 添加密钥(不要代为执行)。
- 提交与 PR:git add 相关文件、提交、推送并用 gh pr create 创建 PR;若之前 stash 过则恢复原分支并 git stash pop。
适用场景:希望为仓库引入基于 AI 判断的 PR 质量门禁的团队或个人。
限制:需要 git 仓库;PR 历史分析依赖 gh CLI;CI 需 Anthropic API 密钥;检查应避免与已有确定性工具重复;资料未提供具体收费、价格或效果保证。