【Agent工坊】用Hermes Agent v0.14搭建自愈式代码审查流水线

# ~/.hermes/config.yaml

editor:

  lsp:

    enabled: true

    diagnostics_on_save: true

    severity_threshold: warning # warning及以上都报告

    autofix: false # 不自动修复，先报告让人工确认

# ~/.hermes/config.yaml

caching:

  prompt_cache:

    enabled: true

    provider: claude

    ttl_seconds: 3600 # 1小时

    auto_cache:

      - path: "CLAUDE.md" # 项目级编码规范

      - path: "ARCHITECTURE.md" # 架构文档

      - path: ".hermes/skills/code-review/skill.md" # 审查规则

# ~/.hermes/config.yaml

cron:

  - name: "code-review-morning"

    schedule: "0 9 * * 1-5" # 工作日早9点

    skill: "code-review-pipeline"

    prompt: "审查过去24小时内所有新提交的PR，生成审查报告"

  - name: "code-review-afternoon"

    schedule: "0 14 * * 1-5" # 工作日下午2点

    skill: "code-review-pipeline"

    prompt: "检查上午修复任务的完成情况，重新分配未完成的任务"

  - name: "lsp-health-check"

    schedule: "*/30 * * * *" # 每30分钟

    skill: "lsp-diagnostics"

    prompt: "扫描项目所有文件，报告新出现的LSP警告"

文件保存 → LSP自动诊断 → 生成问题报告

    ↓

问题报告 → Kanban创建任务卡片 → Agent自动认领

    ↓

Agent修复 → 文件写入 → LSP再次诊断

    ↓

诊断通过 → 卡片归档 → Cron生成日报

诊断失败 → 卡片标记重试 → 超过重试上限则升级为人工处理

# 在项目根目录创建Hermes配置

mkdir -p .hermes/skills/code-review

# 创建项目编码规范文件

cat > CLAUDE.md << 'EOF'

# 项目编码规范

## TypeScript规范

- 禁止使用 any 类型（除非有明确注释说明原因）

- 所有函数必须有返回类型注解

- 使用 const 断言处理字面量类型

- 异步函数必须以 Async 结尾命名

## React规范

- 组件使用函数式声明，禁止class组件

- Props使用interface声明，禁止type

- useEffect必须有依赖数组，禁止空依赖数组除非有注释

- 使用React.memo包裹纯展示组件

## 测试规范

- 所有公共API必须有单元测试

- 测试文件命名为 *.test.ts

- 使用describe/it块组织测试

- 覆盖率要求：分支≥80%，行≥90%

EOF

# 创建架构文档

cat > ARCHITECTURE.md << 'EOF'

# 项目架构

## 目录结构

- src/api/ - API路由和中间件

- src/services/ - 业务逻辑层

- src/db/ - 数据库模型和迁移

- src/utils/ - 工具函数

- src/types/ - 共享类型定义

## 数据流

Client → API Router → Service Layer → Database

                ↓

           Type Validation (Zod)

                ↓

           Error Handler → Response

## 关键约束

- API层禁止直接访问数据库，必须通过Service层

- Service层禁止直接操作HTTP请求/响应对象

- 所有数据库查询必须有超时设置（默认5s）

EOF

cat > .hermes/skills/code-review/skill.md << 'SKILLEOF'

<hr>

name: code-review-pipeline

description: 自动代码审查流水线 - 扫描、诊断、分配、修复、验证

triggers:

  - 代码审查请求

  - Cron定时触发

<hr>

# 代码审查流水线

## 执行流程

### 阶段1：扫描

1. 使用 `search_files` 搜索最近修改的文件

2. 优先检查：API路由层、数据库操作、认证逻辑

3. 收集LSP最近一次诊断结果

### 阶段2：诊断

对每个文件检查：

- [ ] 类型安全：是否有any类型滥用

- [ ] 错误处理：try-catch是否完整

- [ ] 资源管理：数据库连接是否释放

- [ ] 安全：用户输入是否校验

- [ ] 性能：是否有N+1查询

- [ ] 测试：关键逻辑是否有测试覆盖

### 阶段3：评级

每个文件给出A/B/C/D评级：

- A：零问题

- B：有建议性改进（可自动修复）

- C：有需要人工判断的问题

- D：有明确的bug或安全漏洞（必须修复）

### 阶段4：分配

- B级问题 → 自动创建Kanban卡片并修复

- C级问题 → 创建卡片标记需要人工review

- D级问题 → 创建卡片并@团队成员，阻塞合并

### 阶段5：修复

对B级问题执行自动修复：

1. 使用 `patch` 工具进行精确修改

2. 每次修改后触发LSP检查

3. 修复后提交commit，格式：`fix(review): [AI] 自动修复 {问题描述}`

4. 在commit message中附上修复说明

### 阶段6：验证

1. 确认LSP诊断通过

2. 运行受影响的测试用例

3. 将Kanban卡片标记为完成

## 输出格式

审查完成后生成Markdown报告，包含：

- 审查概览（总文件数、问题数、自动修复数）

- 按严重程度分类的问题列表

- 自动修复的diff摘要

- 需要人工处理的C/D级问题

SKILLEOF

cat > .hermes/kanban.yaml << 'EOF'

boards:

  code-review:

    columns:

      - name: "待审查"

        wip_limit: 20

      - name: "审查中"

        wip_limit: 5

      - name: "待修复"

        wip_limit: 10

      - name: "修复中"

        wip_limit: 3

      - name: "待验证"

        wip_limit: 5

      - name: "完成"

    auto_assign: true

    heartbeat_interval: 60 # 每60秒检查Agent存活

    zombie_timeout: 300 # 5分钟无响应视为僵尸

    max_retries: 3 # 最多重试3次

    on_exhausted: "escalate" # 重试耗尽后升级为人工

    labels:

      - "auto-fixable" # B级问题，可自动修复

      - "needs-human" # C/D级问题，需要人工

      - "security" # 安全相关问题

      - "performance" # 性能问题

EOF

# ~/.hermes/config.yaml 追加内容

cron:

  # 早晨全面审查

  - name: "code-review-morning"

    schedule: "0 9 * * 1-5"

    skill: "code-review-pipeline"

    prompt: |

      执行全面的代码审查。

      扫描范围：过去24小时内所有变更的文件。

      优先级：安全 > 性能 > 类型安全 > 代码风格。

      自动修复所有B级问题。

      生成审查报告保存到 docs/code-review/YYYY-MM-DD-morning.md。

  # 下午跟踪修复进度

  - name: "code-review-afternoon"

    schedule: "0 14 * * 1-5"

    skill: "code-review-pipeline"

    prompt: |

      检查Kanban上的修复任务进度。

      重新分配超过2小时未处理的卡片。

      对已完成修复的卡片执行验证。

      生成进度报告保存到 docs/code-review/YYYY-MM-DD-afternoon.md。

  # 持续LSP监控

  - name: "lsp-continuous"

    schedule: "*/30 * * * *"

    skill: "lsp-diagnostics"

    prompt: |

      扫描项目所有TypeScript文件，运行LSP诊断。

      如果发现新的ERROR级别问题，立即创建Kanban卡片并通知。

      统计WARNING数量的变化趋势。

  # 每周汇总

  - name: "code-review-weekly"

    schedule: "0 17 * * 5" # 周五下午5点

    skill: "code-review-pipeline"

    prompt: |

      生成本周代码审查汇总报告。

      包含：总审查文件数、发现问题数、自动修复率、平均修复时间。

      识别高频问题类型，建议添加到CLAUDE.md规范中。

      列出本周C/D级问题中尚未解决的事项。

# 1. 验证LSP配置

hermes doctor --check lsp

# 2. 启动Kanban任务板

hermes kanban start code-review

# 3. 手动触发一次审查测试流水线

hermes skill run code-review-pipeline \

  --prompt "对src/api/目录进行一次试审查，验证流水线配置"

# 4. 确认Cron任务已注册

hermes cron list

# 应输出：

# code-review-morning 0 9 * * 1-5 ACTIVE

# code-review-afternoon 0 14 * * 1-5 ACTIVE

# lsp-continuous */30 * * * * ACTIVE

# code-review-weekly 0 17 * * 5 ACTIVE

# 5. 观察首次运行日志

hermes cron logs code-review-morning --follow

// 故意写一个有问题的函数

function getUser(id: string | null) {

  return db.users.find({ id: id.toUpperCase() });

  // LSP会报：'id' is possibly 'null'

}

// SQL注入风险

app.get('/users', async (req, res) => {

  const name = req.query.name;

  const users = await db.query(`SELECT * FROM users WHERE name = '${name}'`);

  res.json(users);

});