RoleFlow

两类任务：

• research：文献检索、作者信息收集、网页抓取、研究总结
• coding：工作区文件读写、代码生成/修改、命令执行、代码审阅

核心能力有四层：

1. Agent：基于角色描述完成子任务
2. Planner：把总任务拆分给多个 Agent
3. Environment：暴露 research/coding 工具
4. Engine：驱动多轮执行并汇总结果

目录

RoleFlow/
├── configs/
│   ├── coding.yaml
│   └── research.yaml
├── roleflow/
│   ├── environments/
│   │   ├── base.py
│   │   ├── coding.py
│   │   └── research.py
│   ├── utils/
│   │   └── logger.py
│   ├── agent.py
│   ├── config.py
│   ├── engine.py
│   ├── llm.py
│   ├── main.py
│   ├── memory.py
│   └── planner.py
└── workspace/

安装

cd /Users/tzm/Desktop/RoleFlow
cp .env.template .env
poetry install

运行

Research 任务：

poetry run roleflow --config configs/research.yaml

Coding 任务：

poetry run roleflow --config configs/coding.yaml

配置说明

配置文件里最重要的是这几块：

• environment.type：只能是 research 或 coding
• llm.model：例如 gpt-4o-mini
• agents：每个 Agent 的 name 和 profile
• task.content：总任务描述
• runtime.max_iterations：最多迭代轮数
• runtime.output_path：结果 JSON 保存位置

设计原则

• 保留多 Agent 的味道，但结构尽量简单
• 每个环境只暴露少量高价值工具
• 配置文件少，便于你自己扩展
• 所有代码都聚焦在 research/coding 两条主链路