用途:审查项目根目录及各子目录中的开发工具链配置文件,识别 linter、formatter、pre-commit 钩子、测试运行器和 CI/CD 流水线,并指出缺口。仅做分析,不安装或配置任何工具。
主要能力:
- 检测工具。在项目根目录和子目录中搜索配置文件(排除 node_modules/、vendor/、.build/ 等 vendored 目录),并归类为 Linters、Formatters、Pre-commit Hooks、Test Runners、CI/CD 五类。示例:ESLint(.eslintrc*、eslint.config.)、Biome(biome.json、biome.jsonc)、Prettier(.prettierrc、prettier.config.)、Husky(.husky/ 目录)、lint-staged、pre-commit 框架(.pre-commit-config.yaml)、Jest、Vitest、pytest、GitHub Actions(.github/workflows/.yml)、GitLab CI、Jenkins、CircleCI、Bitbucket Pipelines、Travis CI、Azure Pipelines 等。表格并非穷尽,可根据配置文件识别未列出的工具。
- 识别项目生态。根据配置文件和源码判断主要语言/生态,以决定哪些缺口相关。例如 Go 项目缺 Prettier 不算缺口,Node.js 项目缺 linter 才算。信号包括 package.json、Package.swift、pyproject.toml、go.mod、Cargo.toml、Gemfile、pom.xml、build.gradle*、deno.json 等。
- 分析缺口。每类按“已配置 / 部分配置 / 缺失”评估,并检查已检测的 linter/formatter 是否接入 pre-commit 钩子,以及 CI 是否运行测试和 linter。
使用方式:始终以项目级别运行,配置位于项目根目录;scope 参数(diff 命令、文件列表)会被接受但忽略。独立调用时以 git 仓库根目录作为项目根,不在 git 仓库中则退回当前工作目录。
输出格式:每条发现为“### [P<N>] <标题>”,含 Category 和一段说明;随后输出 Tooling Summary 表格(Category / Status / Tool(s))和 Overall Verdict(well-equipped 或 gaps found)。优先级:P0 有源码但无测试运行器;P1 主语言无 linter,或 CI 存在但跳过测试;P2 无 formatter、无 pre-commit 钩子,或 linter/formatter 未接入钩子;P3 无 CI/CD 或轻微配置缺口。
限制:仅分析,不安装或配置工具;分类表未穷尽;缺失事实暂未提供。