AutoMage-2 Agent 初版工程

本目录当前提供面向后续 Hermes / OpenClaw 深度集成的 Agent 初版骨架。

🚀 快速开始

一键运行全链路工作流

cd 客制化
python run.py

这将运行完整的工作流演示：

1. ✅ Staff 提交日报
2. ✅ Staff 查询任务
3. ✅ Manager 分析团队日报
4. ✅ Manager 生成汇总
5. ✅ Executive 生成决策方案
6. ✅ Executive 提交决策
7. ✅ 查看系统状态

其他常用命令

# 启动 API 服务器
python run.py --server

# 启动服务器（热重载模式）
python run.py --server --reload

# 运行集成示例
python run.py --demo

# 运行测试
python run.py --test

# 查看系统状态
python run.py --status

# 显示详细输出
python run.py -v

# 查看帮助
python run.py --help

🎯 配置模板系统（新增）

为新员工注册和知识库自动导入提供完整的配置模板生成系统。

快速生成配置

# 为新员工生成配置
python scripts/onboard_new_user.py \
  --user-id user-002 \
  --display-name "李四" \
  --role staff \
  --department-id dept-sales \
  --job-title "销售专员" \
  --manager-node-id manager-node-001 \
  --feishu-open-id ou_abc123xyz

生成的配置文件

每个用户会自动生成：

• ✅ 用户配置 (user.{role}.toml) - 角色、职责、权限
• ✅ Hermes 配置 (hermes.toml) - Hermes Runtime 配置
• ✅ OpenClaw 配置 (openclaw.toml) - OpenClaw 集成配置
• ✅ 知识库配置 (knowledge.toml) - 知识库节点配置
• ✅ 用户映射 (feishu_user_map.json) - 飞书 Open ID 映射

现有配置模板

模板类型	文件路径	说明
Hermes 配置	configs/hermes.example.toml	Hermes Runtime 配置模板
OpenClaw 配置	configs/openclaw.example.toml	OpenClaw 集成配置模板
系统配置	configs/automage.example.toml	系统主配置
员工配置	examples/user.staff.example.toml	员工角色配置模板
经理配置	examples/user.manager.example.toml	经理角色配置模板
高管配置	examples/user.executive.example.toml	高管角色配置模板
知识库配置	configs/feishu_knowledge.example.toml	飞书知识库配置模板

详细文档：

• 配置模板系统 README
• 配置模板使用指南

📦 集成接口

客制化团队为 OpenClaw 和全栈前端提供统一的 Agent Runtime 接口。

为 OpenClaw 团队提供的接口

本地 Python 集成（推荐）：

from automage_agents.integrations.hermes.client import LocalHermesClient
from automage_agents.integrations.hermes.contracts import HermesInvokeRequest
from automage_agents.integrations.hermes.runtime import HermesOpenClawRuntime

# 初始化 Runtime
runtime = HermesOpenClawRuntime.from_config_files()
hermes_client = runtime.hermes_client

# 调用 Skill
request = HermesInvokeRequest(
    skill_name="post_daily_report",
    actor_user_id="zhangsan",
    payload={...}
)
response = hermes_client.invoke_skill(request)

详细文档：OpenClaw 集成指南

为全栈前端提供的接口

HTTP API：

# 启动 Agent Runtime 服务
python run.py --server

# 调用 API
curl -X POST http://localhost:8000/api/v1/agent/run \
  -H "Content-Type: application/json" \
  -H "X-User-Id: zhangsan" \
  -H "X-Role: staff" \
  -H "X-Node-Id: staff_agent_mvp_001" \
  -d '{
    "agent_type": "staff",
    "org_id": "org_automage_mvp",
    "user_id": "zhangsan",
    "node_id": "staff_agent_mvp_001",
    "run_date": "2026-05-13",
    "input": {
      "skill_name": "fetch_my_tasks",
      "skill_args": {}
    }
  }'

详细文档：全栈前端集成指南

可用的 API 端点

• POST /api/v1/agent/run - 运行 Agent Skill
• POST /api/v1/agent/batch-run - 批量运行 Skills
• GET /api/v1/agent/skills?agent_type={type} - 查询可用 Skills
• GET /api/v1/agent/health - 基础健康检查
• GET /api/v1/agent/health/detailed - 详细健康检查
• GET /api/v1/agent/stats/cache - 缓存统计
• GET /api/v1/agent/stats/pool - 连接池统计

集成测试

# 运行集成测试
python run.py --test

# 或使用 pytest
pytest tests/test_integration_interfaces.py -v

当前已包含

• automage_agents/core/：Agent 枚举、共享数据模型、异常类型。
• automage_agents/config/：运行配置与 user 配置加载。
• automage_agents/api/：统一后端 API Client、响应模型、传输错误处理、Agent Runtime API。
• automage_agents/agents/：三级 Agent 模板注册表与 agents.md 渲染器。
• automage_agents/schemas/：Staff / Manager / Dream Schema 草案。
• automage_agents/integrations/：OpenClaw / Feishu 适配层、Hermes Runtime。
• automage_agents/skills/：Staff / Manager / Executive Skill 初版封装与本地 Skill registry。
• automage_agents/templates/user.md：岗位级 Agent 的 user.md 模板。
• automage_agents/templates/*/agents.md：base、line_worker、manager、executive 四类 Agent 模板草案。
• configs/automage.example.toml：本地运行配置示例。
• examples/user.staff.example.toml：可被加载器读取的员工配置示例。

Docker 部署

本项目支持两种 Docker 启动方式：

1. 本地自部署

适合团队成员在自己电脑上直接测试和启动，默认会一起拉起 Postgres 容器。

copy .env.example .env
docker compose up -d --build

启动后访问：

• Swagger：http://localhost:8000/docs
• 健康检查：http://localhost:8000/healthz

2. 远程数据库 / 生产模式

适合连接公司已有远程数据库，不启用本地 Postgres 容器。

copy .env.example .env
docker compose -f docker-compose.yml up -d --build

3. 配置切换规则

• 本地模式：使用 docker-compose.override.yml，自动切到 configs/automage.docker.toml
• 远程模式：只使用 docker-compose.yml，默认读取 configs/automage.local.toml
• 如果要手动覆盖配置文件路径，可以设置 AUTOMAGE_CONFIG_PATH

设计原则

• 不写死 Hermes Runtime。
• 不把飞书 / OpenClaw 逻辑写进业务 Skill。
• Skill、Schema、API Client、集成适配层保持独立。
• 数据库和后端 API 是事实源。
• 所有未确认契约保留 TODO 注释，等待对应同学确认。

当前 Skill 初版

• agent_init
• check_auth_status
• load_user_profile
• post_daily_report
• fetch_my_tasks
• analyze_team_reports
• generate_manager_report
• generate_manager_schema
• delegate_task
• dream_decision_engine
• commit_decision
• broadcast_strategy
• schema_self_correct

后端 API 初版封装

• POST /api/v1/agent/init
• POST /api/v1/report/staff
• GET /api/v1/tasks
• POST /api/v1/report/manager
• POST /api/v1/decision/commit

Runtime Additions

python scripts/run_api.py
python scripts/run_scheduler.py

New runtime config keys:

• scheduler_enabled
• scheduler_timezone
• scheduler_jobs
• abuse_protection_enabled
• rate_limit_window_seconds
• rate_limit_max_requests
• idempotency_ttl_seconds
• write_protected_paths

本地 Mock 端到端演示

可运行本地 mock 流程：

python scripts/demo_mock_flow.py

该流程模拟：

• Staff Agent 收到飞书日报提交事件。
• OpenClaw Adapter 把事件交给内部路由。
• Staff Skill 写入 mock 后端日报。
• Manager Agent 生成部门汇总。
• Executive Agent 生成 Dream 决策草案。
• 飞书适配层发送老板 A/B 决策卡片 mock。
• 老板选择方案后写入 mock decision_logs 和 task_queue。
• Staff Agent 查询新任务。

TODO(OpenClaw): 后续替换为真实 OpenClaw Feishu/Lark Channel。 TODO(熊锦文): 后续替换为真实后端 API 和鉴权。

Agent 模板渲染

可用示例用户配置渲染 Staff Agent 文档：

python scripts/render_agents.py --user examples/user.staff.example.toml --output examples/rendered/staff.agents.md

TODO(Hermes): 当前渲染结果是 AutoMage-2 初版 agents.md，后续需要按 Hermes 官方格式调整。

待确认事项

• TODO(熊锦文): API 字段、错误码、鉴权方式、user.md 存储方式。
• TODO(杨卓): schema_v1_staff / schema_v1_manager 最终字段和校验规则。
• TODO(徐少洋): Dream 机制输入输出。
• TODO(Hermes): 真实 Agent 配置格式和 Skill 注册方式。
• TODO(OpenClaw): Feishu / Lark Channel、事件格式、用户身份映射。