Skip to content

brooks-lint v0.1.0 — Initial Release

Choose a tag to compare

@hyhmrright hyhmrright released this 26 Mar 13:28

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 偶然复杂度
外科手术团队 模块自治性、接口清晰度
做好扔掉的准备 原型标记、可替换性
焦油坑 渐进式腐化检测