用途:对项目做整体健康评估,覆盖架构、性能、安全、测试、依赖与代码质量。适合季度体检、重大发布前、大型重构后以及新成员了解代码库状况。
主要能力:通过 Agent 工具并行启动 5 个专项子智能体——架构评审(phoenix-patterns-analyst)、性能审计(general-purpose)、安全审计(security-analyzer)、测试健康审计(testing-reviewer)、依赖审计(general-purpose)。各智能体将结果写入 .claude/audit/reports/ 下对应文件(arch-review.md、perf-audit.md、security-audit.md、test-audit.md、deps-audit.md)。随后由 context-supervisor 压缩为 .claude/audit/summaries/consolidated.md,按 0-100 分计算各类别健康分,并生成项目健康报告 project-health-{date}.md,含总评、分类评分表、关键问题、建议与行动计划。
使用方式: /phx:audit(完整审计) /phx:audit --quick(约 2-3 分钟快速检查) /phx:audit --focus=security(单领域深入,可选 performance、architecture、tests、deps) /phx:audit --since abc123(自某提交起的增量审计,可用 HEAD~10) 可组合使用。快速模式执行 mix compile --warnings-as-errors、mix hex.audit && mix deps.audit、mix xref graph --format stats、mix test --trace 2>&1 | tail -20。增量模式先用 git diff --name-only <commit>...HEAD 找出改动文件,仅做定向审计。
限制:必须等全部智能体完成后再汇总,否则健康分失真;提示词须限定到具体目录与模式;不要跨项目比较分数,只在同一项目内追踪趋势;若 2 个以上智能体返回空结果或限流/API 错误,应停止启动并标注未审计类别,待限流恢复后重跑。性能与依赖分类暂未提供专用专项智能体,使用 general-purpose。评分方法见 ${CLAUDE_SKILL_DIR}/references/scoring-methodology.md。