版本: 1.0.0 最后更新: 2026-02-05 状态: 官方文档
此文件夹包含所有 AIOX 代理的详细文档,包括:
- 每个代理的完整系统
- 操作的 Mermaid 流程图
- 命令到任务的映射
- 代理之间的集成
- 涉及每个代理的工作流
- 最佳实践和故障排除
| 代理 | 角色 | 原型 | 文档 |
|---|---|---|---|
| @aiox-master | Orion | 编排者 | aiox-master-system.md |
| @analyst | Atlas | 研究员 | analyst-system.md |
| @architect | Aria | 愿景者 | architect-system.md |
| @data-engineer | Dara | 数据圣人 | data-engineer-system.md |
| @dev | Dex | 构建者 | dev-system.md |
| @devops | Gage | 守护者 | devops-system.md |
| @pm | Morgan | 策略师 | pm-system.md |
| @qa | Quinn | 守护者 | qa-system.md |
| @sm | River | 协调者 | sm-system.md |
| @squad-creator | Nova | 创建者 | squad-creator-system.md |
| @ux-design-expert | Uma | 设计师 | ux-design-expert-system.md |
每个代理文档都遵循以下标准结构:
1. 概述
- 主要职责
- 核心原则
2. 完整文件列表
- 核心任务
- 代理定义
- 模板
- 检查清单
- 相关文件
3. 系统流程图
- 完整的 Mermaid 图
- 操作流程
4. 命令映射
- 命令 → 任务
- 参数和选项
5. 相关工作流
- 使用该代理的工作流
- 代理在每个工作流中的角色
6. 代理之间的集成
- 从谁接收输入
- 向谁提供输出
- 协作
7. 配置
- 配置文件
- 可用工具
- 限制
8. 最佳实践
- 何时使用
- 避免什么
9. 故障排除
- 常见问题
- 解决方案
10. 变更日志
- 版本历史
flowchart TB
subgraph ORCHESTRATION["编排"]
MASTER["@aiox-master\n(Orion)"]
end
subgraph DISCOVERY["发现与规划"]
ANALYST["@analyst\n(Atlas)"]
PM["@pm\n(Morgan)"]
end
subgraph DESIGN["设计与架构"]
ARCHITECT["@architect\n(Aria)"]
UX["@ux-design-expert\n(Uma)"]
DATA["@data-engineer\n(Dara)"]
end
subgraph MANAGEMENT["管理"]
PO["@po\n(Pax)"]
SM["@sm\n(River)"]
end
subgraph EXECUTION["执行"]
DEV["@dev\n(Dex)"]
QA["@qa\n(Quinn)"]
DEVOPS["@devops\n(Gage)"]
end
MASTER --> ANALYST
MASTER --> PM
ANALYST --> PM
PM --> UX
PM --> ARCHITECT
UX --> ARCHITECT
ARCHITECT --> DATA
ARCHITECT --> PO
PO --> SM
SM --> DEV
DEV --> QA
QA --> DEVOPS
style MASTER fill:#e3f2fd
style EXECUTION fill:#c8e6c9
- 访问所需代理的文档
- 阅读概述了解角色
- 查阅命令了解功能
- 查看工作流了解上下文
- 直接转到故障排除部分
- 查阅流程图了解流程
- 检查集成了解依赖关系
- 分析文件列表了解需要修改什么
- 遵循最佳实践保持一致性
- 更改后更新变更日志
| 文档 | 位置 | 目的 |
|---|---|---|
| 代理参考指南 | docs/agent-reference-guide.md | 快速参考 |
| 工作流指南 | docs/guides/workflows-guide.md | 工作流指南 |
| AIOX 工作流 | docs/aiox-workflows/ | 工作流详情 |
| 架构 | docs/architecture/ | 技术架构 |
添加或更新代理文档时:
- 遵循上述标准结构
- 包含更新的 Mermaid 图
- 保持变更日志更新
- 创建 EN 和 ES 翻译
AIOX 代理流程文档 v1.0 - 代理系统详细文档