Claude Code Agents 项目

这是一个基于 Claude Code 的多 Agent 协作系统，专为游戏研发团队设计，提供从项目管理到技术开发的全面支持。

📁 项目结构

.
├── README.md                 # 项目主文档（本文件）
├── memory.md                 # 记忆库（自动保存的知识内容）
├── start_claude.sh           # 启动脚本
├── requirements.txt          # Python 依赖
├── .claude/agents/           # Agent 配置文件目录（11个专业 agent）
├── docs/                     # 文档目录
│   ├── README_USAGE.md       # 使用指南
│   ├── README_AGENTS.md      # Agent 配置说明
│   ├── README_ROUTER.md      # Router-Hao 使用指南
│   ├── README_MCP.md         # MCP 协议说明
│   └── TROUBLESHOOTING.md    # 故障排除指南
├── scripts/                  # 工具脚本目录
│   ├── check_agent_mcp.sh    # 查看 Agent MCP 配置
│   ├── diagnose_api_config.sh # API 配置诊断
│   ├── fix_api_config.sh     # API 配置修复
│   └── verify_env.sh         # 环境变量验证
└── tools/                    # Python 工具目录
    ├── llm_api.py            # LLM API 封装
    ├── screenshot_utils.py   # 截图工具
    ├── search_engine.py      # 搜索引擎
    └── web_scraper.py        # 网页抓取

🚀 快速开始

1. 安装依赖

# 激活虚拟环境
source venv/bin/activate

# 安装 Python 依赖
pip install -r requirements.txt

2. 配置环境变量

⚠️ 安全警告：项目包含敏感信息配置，请务必正确配置环境变量。

复制环境变量模板

cp env.example .env

编辑 .env 文件

# Claude Code API 配置
ANTHROPIC_BASE_URL=https://api.anthropic.com  # 注意：不要包含 /v1
ANTHROPIC_AUTH_TOKEN=sk-ant-your-api-key-here

# 飞书机器人配置（用于 daily_news 自动化脚本，可选）
FEISHU_APP_ID=your-feishu-app-id
FEISHU_APP_SECRET=your-feishu-app-secret
FEISHU_USER_OPEN_ID=your-feishu-user-open-id

注意：

• .env 文件已被 .gitignore 忽略，不会被提交到 Git
• 请勿在代码中硬编码敏感信息
• ANTHROPIC_BASE_URL 不要包含 /v1，SDK 会自动添加

3. 启动 Claude Code

./start_claude.sh

启动后，你可以直接输入自然语言问题，系统会自动路由到合适的 agent。

🤖 Agent 列表

本项目包含 11 个专业 Agent：

1. router-hao - 智能路由助手（推荐使用，自动路由到其他 agent）
2. news-hao - 行业资讯助手
3. pm-hao - 游戏研发项目管理专家
4. version-hao - 版本管理专家（P4&UE5）
5. art-pm-hao - 美术制作管理专家
6. whitebox-hao - 白盒测试专家
7. blackbox-hao - 黑盒测试专家
8. engine-hao - 游戏引擎研发专家
9. server-hao - 游戏服务器研发专家
10. reflection-hao - 导师式复盘助手
11. memory-hao - 知识库管理中枢

详细说明请查看 Agent 配置说明。

💾 记忆存储

系统通过 memory-hao 自动保存有价值的对话内容到本地文件：

• 存储位置：memory.md 文件（项目根目录）
• 存储内容：技术方案、决策记录、问题解决方案、经验教训
• 存储格式：Markdown 格式，按类型分类存储
• 检索方式：通过 /memory-hao 或直接询问 memory-hao 进行知识检索
• 编辑方式：可以直接编辑 memory.md 文件进行调整和修改

记忆存储是自动的，无需手动操作。Router-Hao 会在每次对话结束后自动将有价值的信息记录到 memory.md 文件中。

优势：所有记忆都以 Markdown 格式保存在本地，你可以随时查看、编辑和修改 memory.md 文件。

如何查看已保存的记忆

有以下几种方式可以查看已保存的记忆：

方法 1：直接调用 memory-hao（推荐）

在 Claude Code 中输入：

/memory-hao 查看所有保存的记忆

或者询问具体内容：

/memory-hao 之前关于项目管理的决策有哪些？
/memory-hao 查找关于 UE5 性能优化的方案
/memory-hao 显示所有技术方案

方法 2：通过自然语言查询

直接输入问题，Router-Hao 会自动识别并调用 memory-hao：

之前我们讨论过哪些技术方案？
查找关于版本管理的经验教训
显示所有决策记录

方法 3：直接查看 memory.md 文件

所有记忆都保存在项目根目录的 memory.md 文件中，你可以：

• 直接打开：用任何文本编辑器打开 memory.md 文件
• 直接编辑：可以手动添加、修改或删除记忆内容
• 版本控制：可以将 memory.md 纳入 Git 版本控制

文件结构：

# 记忆库
## 技术方案
## 决策记录
## 问题解决方案
## 经验教训

方法 4：按类型检索

memory-hao 支持按以下维度检索：

• 按主题：项目管理、引擎技术、服务器架构等
• 按时间：最近一周、最近一个月等
• 按类型：技术方案、决策记录、问题解决方案、经验教训
• 按关键词：直接搜索相关关键词

示例查询：

/memory-hao 查找最近一周的项目管理决策
/memory-hao 显示所有关于性能优化的技术方案
/memory-hao 查找与 UE5 相关的所有记录

🛠️ 工具脚本

项目提供了多个工具脚本，位于 scripts/ 目录：

• check_agent_mcp.sh - 查看 Agent 可用的 MCP 协议
• diagnose_api_config.sh - 诊断 API 配置问题
• fix_api_config.sh - 修复 API 配置问题
• verify_env.sh - 验证环境变量配置

🔧 开发工具

tools/ 目录包含 Python 工具：

• llm_api.py - 支持多 LLM 提供商的 API 封装
• screenshot_utils.py - 网页截图工具
• search_engine.py - 网络搜索工具
• web_scraper.py - 网页内容抓取工具

📰 每日新闻自动推送

项目集成了每日新闻自动推送功能，每天早上 8:00 自动收集 AI 和游戏行业资讯并发送到飞书。

功能特性

• ✅ 自动收集：DuckDuckGo 搜索 AI 和游戏行业新闻
• ✅ 智能过滤：只推送最近的新闻，自动去重
• ✅ 分类整理：AI 资讯和游戏资讯各最多 3 条
• ✅ 富文本格式：飞书消息支持链接跳转
• ✅ 定时推送：每天早上 8:00 自动执行（macOS launchd）

快速配置

1. 配置飞书参数（在 .env 文件中）：

FEISHU_APP_ID=your-feishu-app-id
FEISHU_APP_SECRET=your-feishu-app-secret
FEISHU_USER_OPEN_ID=your-feishu-user-open-id

2. 安装定时任务：

./setup_daily_news.sh

3. 手动测试：

./daily_news.sh

详细说明请查看 每日新闻配置指南。

📝 使用示例

方法1：使用智能路由（推荐）

启动 Claude Code 后，使用 router-hao 进行智能路由：

/router-hao 30人的游戏研发团队，要加入第一个 pm，应该如何协作？

Router-Hao 会自动：

1. 🔍 分析问题类型（项目管理）
2. 📍 推荐合适的 agent（pm-hao）
3. ✅ 提供专业回答
4. 💾 自动记录到 memory-hao

方法2：直接使用特定 Agent

如果你明确知道需要哪个 agent：

/pm-hao 帮我制定版本计划
/engine-hao UE5性能优化建议
/memory-hao 查看所有保存的记忆

⚠️ 常见问题

API 错误：/v1/v1/messages

如果遇到此错误，通常是因为 API base_url 配置中包含了 /v1，但 SDK 又自动添加了 /v1。

解决方法：

1. 运行诊断脚本：./scripts/diagnose_api_config.sh
2. 运行修复脚本：./scripts/fix_api_config.sh
3. 详细说明请查看 故障排除指南

📚 文档导航

• CHANGELOG - 项目更新日志和历史记录 🆕
• 使用指南 - 如何开始使用，常见问题解答
• Agent 配置说明 - 所有 Agent 的详细介绍
• Router-Hao 使用指南 - 智能路由助手的使用方法和路由规则
• 规则管理说明 - 统一的规则管理和 .cursorrules 使用指南
• MCP 协议说明 - MCP 服务器配置和使用
• 每日新闻配置指南 - 每日新闻自动推送的配置和使用
• 故障排除指南 - 常见问题和解决方案

🔒 安全最佳实践

1. 环境变量管理

   • 使用 .env 文件存储敏感信息
   • 不要将 .env 文件提交到版本控制
   • 定期轮换 API 密钥

2. 日志安全

   • 日志文件已被 .gitignore 忽略
   • 确保日志中不包含敏感信息

3. API 配置

   • ANTHROPIC_BASE_URL 不要包含 /v1
   • 使用官方 API endpoint 或可信的第三方服务

🤝 贡献指南

在提交代码前，请确保：

• 已移除所有硬编码的敏感信息
• 已更新相关文档
• 已测试修改的功能
• 提交消息包含 [Cursor] 标记（如使用 Cursor AI）