用途:面向既有代码库开展工作,核心原则是先理解再修改,尊重仓库既有约定、模式与历史,不擅自重组结构。
主要能力:分阶段执行。阶段一分析仓库:用 git 命令查看远程、分支、提交历史,检测配置文件与技术栈(JS/TS、Python、Flutter、Android、iOS、Rust、Go、Ruby),判断仓库结构类型(Monorepo、前后端一体化、前后端分离、微服务),映射目录与入口点。阶段二探测约定:代码风格(Prettier、EditorConfig、ESLint、Biome、ruff、black)、测试设置、CI/CD、文档风格。阶段三审计护栏:pre-commit 钩子、lint、类型检查、提交信息校验、安全扫描的现状。阶段四补齐缺失护栏,绝不覆盖已有配置。
必要用法:JavaScript/TypeScript 项目可用 npm install -D husky lint-staged 并执行 npx husky init,配置 lint-staged、ESLint、Prettier、commitlint;Python 项目用 pip install pre-commit 与 pre-commit install,并配置 Ruff、mypy、detect-secrets 等钩子。阶段五结构保留规则:不重组目录、不重命名文件、不引入新模式、不改导入风格与格式、不轻易加依赖。阶段六输出分析报告。
适用场景:接手现有仓库、为老项目补护栏、前后端分离仓库的分别配置,建议按周逐步引入(格式化、lint、钩子、提交校验、严格类型、安全扫描)。
限制:平台、收费、价格等信息暂未提供;具体规则需结合仓库实际情况调整,避免一次性引入过多严格规则。