Hermes-Agent 与 CodeBuddy 组合使用技巧¶

角色分工¶

工具	定位	最擅长
CodeBuddy	前端执行器	文件操作、实时调试、代码编辑
Hermes-Agent	后端大脑	复杂推理、策略规划、知识管理

最佳实践¶

1. 分层协作模式¶

用户 → CodeBuddy (执行层)
           ↓
      Hermes-Agent (思考层)
           ↓
      CodeBuddy (执行层)

示例：复杂项目重构

# 1. CodeBuddy: 分析需求
# 用户提出需求："重构用户认证模块"

# 2. Hermes: 制定方案
hermes chat -q "分析 /workspace/src/auth/ 模块，设计重构方案，包括：
- 目录结构
- 接口设计
- 迁移步骤"

# 3. CodeBuddy: 执行重构
# 根据方案逐步执行重构

# 4. Hermes: 验证和审查
hermes chat -q "审查重构后的代码，确保功能完整性"

2. 上下传递策略¶

方法 1：CodeBuddy → Hermes（预处理）

# CodeBuddy 先整理上下文
cat > /tmp/context.md << 'EOF'
# 项目结构
$(find /workspace/src -type f -name "*.ts" | head -20)

# 相关代码
$(cat /workspace/src/api/user.ts)
EOF

# 传给 Hermes 分析
hermes chat -q "基于以下上下文，分析代码问题：$(cat /tmp/context.md)"

方法 2：Hermes → CodeBuddy（生成方案）

# Hermes 生成执行计划
PLAN=$(hermes chat -Q -q "生成项目初始化命令清单，以 JSON 格式输出")

# CodeBuddy 执行
echo "$PLAN" | jq -r '.commands[]' | while read cmd; do
  eval "$cmd"
done

3. 互补使用场景¶

场景	使用 Hermes	使用 CodeBuddy
理解复杂代码库	✅ 生成架构分析	✅ 浏览文件结构
编写新功能	✅ 设计接口和方案	✅ 编辑具体代码
Bug 调试	✅ 定位根因	✅ 修改代码、测试
代码审查	✅ 提供改进建议	✅ 高亮显示问题
文档编写	✅ 生成文档内容	✅ 编辑和格式化
部署配置	✅ 规划部署流程	✅ 编辑配置文件

4. 典型工作流¶

工作流 1：功能开发

# Step 1: Hermes 需求分析
hermes chat -q "分析以下需求，输出实现方案：
用户管理模块需要支持：注册、登录、密码重置、JWT 认证"

# Step 2: CodeBuddy 创建文件结构
# 根据方案创建目录和基础文件

# Step 3: Hermes 代码生成
hermes chat -q "为 /workspace/src/user 模块生成完整的 TypeScript 代码"

# Step 4: CodeBuddy 调整和整合
# 修改生成的代码以适配项目

工作流 2：问题排查

# Step 1: CodeBuddy 收集错误信息
echo "错误日志:" && cat /workspace/error.log

# Step 2: Hermes 诊断
hermes chat -q "分析以下错误日志，定位问题根因：
$(cat /workspace/error.log)"

# Step 3: CodeBuddy 修复
# 执行 Hermes 提供的修复方案

# Step 4: Hermes 验证
hermes chat -q "验证修复是否成功，查看 /workspace/error.log"

工作流 3：代码重构

# Step 1: Hermes 制定重构计划
hermes chat -q "为 /workspace/legacy-code 设计重构计划，保持向后兼容"

# Step 2: CodeBuddy 分步执行
# 每次修改一个小模块

# Step 3: Hermes 审查
hermes chat -q "审查 /workspace/refactored/ 代码质量"

# Step 4: CodeBuddy 调整
# 根据反馈调整代码

5. 提示词模板¶

模板 1：方案生成

请分析 [任务描述]，输出：
1. 技术方案
2. 实施步骤
3. 潜在风险
4. 验收标准

模板 2：代码审查

请审查 [文件路径] 的代码，关注：
1. 代码规范
2. 安全问题
3. 性能优化
4. 可维护性

模板 3：调试协助

遇到问题：
[错误信息/现象]

相关代码：
[代码片段]

请分析可能的原因和解决方案。

注意事项¶

避免重复：不要让两者同时操作同一文件
上下文管理：重要信息用文件传递，避免长对话
验证执行：Hermes 生成的命令，CodeBuddy 执行前先检查
版本同步：修改后及时更新上下文

快捷命令¶

# 一键分析并修复
alias fix='hermes chat -q "分析问题并提供修复方案" | xargs -I {} eval "{}"'

# 快速审查
alias review='hermes chat -q "审查代码质量，给出改进建议"'

# 自动文档
alias doc='hermes chat -q "生成项目文档"'