Code Quality Analysis Report

Code Quality Analysis Report

Summary

• Overall Quality Score: X/10
• Files Analyzed: N
• Issues Found: N
• Technical Debt Estimate: X hours

Critical Issues

1. [Issue description]
   • File: path/to/file.js:line
   • Severity: High
   • Suggestion: [Improvement]

Code Smells

Refactoring Opportunities

Positive Findings

• [Good practice observed]

模板的每个区块都有明确的工程意图：

- **Summary**：以 `Overall Quality Score (X/10)`、`Files Analyzed`、`Issues Found`、`Technical Debt Estimate (hours)` 四个指标把抽象质量折算为可比较、可入库的数字。其中"技术债务工时估算"正是职责"Assess technical debt"的输出载体——可与文档职责中"技术债评估"对应。
- **Critical Issues**：编号问题列表，要求每个问题携带 `File: path/file:line` 精确定位、`Severity: High` 严重级别与 `Suggestion` 改进建议。该结构可在 ruflo 的 GitHub 评审流中直接转化为 inline review comment 或 status check 依据（参考 [.claude/skills/github-code-review/SKILL.md](https://gitcode.com/GitHub_Trending/cl/ruflo/blob/3c99b1c84a25948c42a163253bac6effed5fbbbb/.claude/skills/github-code-review/SKILL.md?utm_source=gitcode_repo_files) 中 security review 的 `--check` 与按 severity 分流——critical 触发 `request-changes`，非 critical 仅评论）。
- **Code Smells**：按上一节八类坏味道逐一命名归类，便于聚合统计"哪些坏味道在本仓占比最高"。
- **Refactoring Opportunities**：以 `[机会]: [收益]` 形式回答 reviewer.md 最佳实践中"explain why + 给出具体建议"的要求。
- **Positive Findings**：刻意保留"正向发现"，呼应评审伦理——"The goal of code review is to improve code quality and share knowledge, not to find fault"，避免评审沦为单向挑刺。

## 在 ruflo / Claude Flow 中调度 code-analyzer

### 通过 CLI 直接加载与孵化

依据 [tests/docker-regression/scripts/test-agents.sh](https://gitcode.com/GitHub_Trending/cl/ruflo/blob/3c99b1c84a25948c42a163253bac6effed5fbbbb/tests/docker-regression/scripts/test-agents.sh?utm_source=gitcode_repo_files) 展示的 Agent 能力测试模式，可以这样验证与运行该子代理：

```bash
# 查看 Agent 信息（确认已注册、可加载）
npx claude-flow agent info code-analyzer

# 以子代理方式孵化执行（dry-run 预演）
npx claude-flow agent spawn code-analyzer --dry-run

通过 GitHub code-review 命令纳入 PR 流程

ruflo 提供 swarm 智能评审入口（.claude/commands/github/code-review.md）：

# 对指定 PR 发起评审
npx claude-flow github code-review --pr-number 456

# 指定评审焦点（security / performance / style）
npx claude-flow github code-review --pr-number 456 --focus security

# 附修复建议
npx claude-flow github code-review --pr-number 456 --suggest-fixes