agentchecker 是一个用于解决 AI 编程助手指令文件之间规则冲突的命令行工具。其核心问题是“规则漂移”：当你同时使用多个 AI 编程工具时，每个工具读取不同的指令文件，例如 Cursor 读取 .cursorrules 或 .cursor/rules/*.mdc，Claude Code 读取 CLAUDE.md 或 .claude/CLAUDE.md，GitHub Copilot 读取 .github/copilot-instructions.md，而人类与共享代理则读取 AGENTS.md。随着时间推移，这些规则会逐渐分歧，比如 Cursor 开始使用 pnpm 和 eslint，Claude 默认使用 npm 和 oxlint，Copilot 用 biome 重新格式化所有内容，最终导致生成内容冲突、编译错误以及浪费 API token。
用途与主要能力：agentchecker 是一款零依赖、超高速的命令行工具，能够扫描项目本地的代理文件以及全局工具配置（例如 ~/.claude/、~/.cursor/rules/、~/.codex/ 等），提取并解析技术栈决策（包括包管理器、linter、formatter、测试运行器、shell 环境等），然后以清晰、基于终端的诊断报告高亮所有来源之间的冲突。它支持交互式修复，且仅修改本地项目文件，全局配置始终只读。如果本地不存在任何配置，它会自动创建 AGENTS.md，为本项目锁定所选配置。
使用方式：无需安装，直接在项目根目录使用 npx 运行即可，无需配置文件、全局包或环境设置。可集成到日常工作流中：在 .husky/pre-commit 或 Git 钩子运行器中加入检查，扫描项目文件并在发现冲突时以退出码 1 终止提交（省略 --local-only 选项还会包含用户主目录下的全局工具配置）；也可使用官方 GitHub Action 或直接通过 npx 在 CI 中运行，使用 --local-only 以便仅验证仓库文件而非每位开发者的全局配置。
支持的工具与指令文件：该工具统一了业界最流行的 AI 编程助手、编辑器与代理的配置，覆盖的决策类型包括包管理器（pnpm、npm、yarn、bun）、linter（oxlint、eslint、biome）、formatter（prettier、biome、dprint）、测试运行器（vitest、jest、playwright、cypress）、包运行器（npx、pnpm dlx、bunx、yarn dlx）、响应语言（spanish / español、english / inglés）以及 shell 环境（wsl、wsl2、windows、macos、linux）。
适用场景与限制：适用于同时使用多个 AI 编程辅助工具、希望保持指令一致并避免规则漂移的开发者与团队，尤其适合在提交前和 CI 流程中做一致性校验。目前仅能添加将指令存储在磁盘文件中的工具；仅存在于 IDE 中的设置（如 Copilot 全局 UI、没有文件的 Cursor 配置文件等）无法被可靠扫描。若需添加新工具支持，可提交支持请求，需包含工具名称、项目规则路径（精确文件或 glob）、全局路径（如有）、格式（Markdown、JSON、YAML、TOML 等）、官方文档链接以及示例片段；也欢迎提交 PR，在 packages/cli/src/scan/known-files.ts 中添加模式，并在 packages/cli/tests/fixtures/ 下添加 fixture。命令行选项、本地开发说明和完整许可信息（MIT 许可证）等细节暂未在当前资料中提供具体内容。
