1.6k hyhmrright

brooks-health Skill

代码库健康总览仪表盘,一次性从 PR 质量、架构、技术债和测试质量四个维度为项目打分,基于十二本经典工程书籍。触发时机:用户想要整体质量评估,问"这个代码库健康吗?"、"跑一遍所有检查"、"发布前我需要一个健康分数",或希望给新团队做质量概览。不要触发:服务器健康检查、HTTP 健康端点、Kubernetes 存活/就绪探针、数据库健康或应用运行状态。

安装方式:把技能目录放入 ~/.claude/skills/(Claude Code)或在 claude.ai 设置中启用;也可复制右侧安装命令一键添加。

查看源码

技能指令原文(SKILL.md)

Brooks-Lint — Health Dashboard

Setup

Read in order:

  1. ../_shared/common.md — Iron Law, Project Config, Report Template, Health Score
  2. ../_shared/source-coverage.md — book coverage, exceptions, tradeoffs
  3. ../_shared/decay-risks.md — production risk symptoms
  4. ../_shared/test-decay-risks.md — test risk symptoms
  5. health-guide.md (this directory) — the dashboard orchestration process

Process

Scope: if the user did not specify a project or directory, apply Auto Scope Detection
(../_shared/common.md) first.

  1. Run abbreviated scans across all four dimensions (Step 1 of the guide)
  2. Complete one score ledger and finalize the score-free draft with the bundled scoring tool when execution is permitted (Step 2 of the guide)
  3. Verify the final artifact against that same ledger and output it unchanged (Step 3 of the guide)

Mode line in report: Health Dashboard