brooks-lint v0.1.0
基于《人月神话》(The Mythical Man-Month) 核心理念的代码质量管理工具,作为 Claude Code Skill 使用。
包含内容
SKILL.md— 完整 brooks-lint skill,直接复制到项目即可使用references/brooks-principles.md— Brooks 七大原则详解及代码审查评分标准references/review-checklists.md— 六类场景化审查清单(PR Review、架构评审、遗留系统等)scripts/complexity_analyzer.py— 代码质量量化分析工具,支持三种模式
快速开始
# 复制 skill 到你的项目
cp SKILL.md /your-project/.claude/skills/brooks-lint.md
# 运行代码分析
python scripts/complexity_analyzer.py --mode=file --path=src/your_file.py --pretty
python scripts/complexity_analyzer.py --mode=project --path=./src --pretty
python scripts/complexity_analyzer.py --mode=debt --path=./src --pretty七大审查维度
| 原则 | 说明 |
|---|---|
| 概念完整性 | API 风格一致性、命名规范 |
| Brooks 定律 | 模块耦合度、依赖复杂度 |
| 第二系统效应 | 过度抽象、配置膨胀 |
| 没有银弹 | 本质 vs 偶然复杂度 |
| 外科手术团队 | 模块自治性、接口清晰度 |
| 做好扔掉的准备 | 原型标记、可替换性 |
| 焦油坑 | 渐进式腐化检测 |