Skip to content

Commit a8af431

Browse files
oalanicolasclaudePedrovaleriolopez
authored
docs(i18n): complete Chinese (zh-CN) documentation translation (#525)
* docs(i18n): translate agent flows to Chinese (zh-CN) Translate 4 core agent flow documents to Simplified Chinese (zh-CN): - aios-master-system.md (Orion - meta agent orchestrator) - dev-system.md (Dex - full stack developer) - architect-system.md (Aria - system architect) - qa-system.md (Quinn - quality assurance) Terminology applied: - Agent → 代理 - System → 系统 - Developer → 开发者 - Architect → 架构师 These documents provide comprehensive reference material for AIOS agents in Chinese, including tasks, workflows, integrations, and best practices. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com> * docs(zh-CN): translate MCP guides and squad examples to Chinese Translate three documentation files from English to Simplified Chinese (zh-CN): - docker-gateway-tutorial.md: Complete guide for Docker Gateway MCP setup - desktop-commander.md: Desktop Commander MCP usage and capabilities guide - squad-examples/README.md: Squad examples and patterns guide All files maintain proper language routing (EN|PT|ZH) in headers for localization. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com> * docs(i18n): add zh readme navigation and coverage status --------- Co-authored-by: Claude Opus 4.6 <noreply@anthropic.com> Co-authored-by: Pedrovaleriolopez <124090200+Pedrovaleriolopez@users.noreply.github.com>
1 parent abd21d4 commit a8af431

File tree

11 files changed

+1330
-493
lines changed

11 files changed

+1330
-493
lines changed

docs/README.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,7 @@
11
# Synkra AIOS Documentation
22

33
> 🌐 **EN** | [PT](./pt/README.md) | [ES](./es/README.md) | [ZH](./zh/README.md)
4+
45
> **AI-Orchestrated System for Full-Stack Development**
56
67
---

docs/es/README.md

Lines changed: 7 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -7,6 +7,7 @@
77
# Documentación de Synkra AIOS
88

99
> 🌐 [EN](../README.md) | [PT](../pt/README.md) | **ES** | [ZH](../zh/README.md)
10+
1011
> **Sistema Orquestado por IA para Desarrollo Full Stack**
1112
1213
---
@@ -88,7 +89,7 @@ docs/
8889
- [快速入门](../zh/getting-started.md)
8990
- [安装指南](../zh/installation/README.md)
9091
- [架构总览](../zh/architecture/ARCHITECTURE-INDEX.md)
91-
- [代理参考](../zh/meta-agent-commands.md)
92+
- [代理参考](../zh/agent-reference-guide.md)
9293
- [故障排查](../zh/troubleshooting.md)
9394

9495
---
@@ -115,11 +116,11 @@ Seguimos prácticas estándar de la industria para i18n:
115116

116117
| Sección | EN | PT | ES | ZH |
117118
| --------------- | --- | --- | --- | --- |
118-
| Getting Started |||| |
119-
| Guides |||| |
120-
| Installation |||| |
121-
| Architecture |||| |
122-
| Framework |||| |
119+
| Getting Started |||| 🟡 |
120+
| Guides |||| 🟡 |
121+
| Installation |||| 🟡 |
122+
| Architecture |||| 🟡 |
123+
| Framework |||| 🟡 |
123124
| Platforms |||||
124125

125126
---

docs/zh/README.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -60,7 +60,7 @@ docs/
6060
- [Começando](../pt/getting-started.md)
6161
- [Guia de Instalação](../pt/installation/README.md)
6262
- [Visão Geral da Arquitetura](../pt/architecture/ARCHITECTURE-INDEX.md)
63-
- [Meta-Agent Commands](../pt/meta-agent-commands.md)
63+
- [Referência de Agentes](../pt/agent-reference-guide.md)
6464
- [Documentação do Sistema de Agentes](../aios-agent-flows/README.md)
6565
- [Documentação de Workflows](../aios-workflows/README.md)
6666
- [Solução de Problemas](../pt/troubleshooting.md)
@@ -70,7 +70,7 @@ docs/
7070
- [Comenzando](../es/getting-started.md)
7171
- [Guía de Instalación](../es/installation/README.md)
7272
- [Visión General de la Arquitectura](../es/architecture/ARCHITECTURE-INDEX.md)
73-
- [Meta-Agent Commands](../es/meta-agent-commands.md)
73+
- [Referencia de Agentes](../es/agent-reference-guide.md)
7474
- [Documentación del Sistema de Agentes](../es/aios-agent-flows/README.md)
7575
- [Documentación de Workflows](../es/aios-workflows/README.md)
7676
- [Solución de Problemas](../es/troubleshooting.md)
@@ -80,7 +80,7 @@ docs/
8080
- [快速入门](./getting-started.md)
8181
- [安装指南](./installation/README.md)
8282
- [架构总览](./architecture/ARCHITECTURE-INDEX.md)
83-
- [Meta-Agent Commands](./meta-agent-commands.md)
83+
- [代理参考](./agent-reference-guide.md)
8484
- [代理系统文档](./aios-agent-flows/README.md)
8585
- [工作流文档](./aios-workflows/README.md)
8686
- [故障排查](./troubleshooting.md)

docs/zh/aios-agent-flows/README.md

Lines changed: 188 additions & 88 deletions
Original file line numberDiff line numberDiff line change
@@ -1,96 +1,196 @@
1-
# AIOS 代理流程系统文档 (中文简体)
1+
<!--
2+
翻译:zh-CN(简体中文)
3+
原文:/docs/aios-agent-flows/README.md
4+
最后同步:2026-02-22
5+
-->
6+
7+
# AIOS 代理流程 - 代理详细文档
28

39
> 🌐 [PT](../../aios-agent-flows/README.md) | [EN](../../en/aios-agent-flows/README.md) | [ES](../../es/aios-agent-flows/README.md) | **ZH**
410
511
---
612

7-
本目录包含AIOS框架的所有代理流程系统文档,翻译为中文简体(zh-CN)。
8-
9-
## 翻译文件
10-
11-
### 核心代理系统
12-
13-
1. **ux-design-expert-system.md** - UX设计专家(Uma)
14-
- 用户研究、线框、设计系统审计
15-
- 5阶段工作流:研究→审计→令牌→构建→质量
16-
- 原子设计方法论
17-
18-
2. **data-engineer-system.md** - 数据工程师(Dara)
19-
- 数据库架构、迁移、RLS安全
20-
- DBA操作、性能优化、安全审计
21-
- Supabase、PostgreSQL、MongoDB支持
22-
23-
3. **analyst-system.md** - 分析师(Atlas)
24-
- 市场研究、竞争分析
25-
- 头脑风暴促进、项目简报创建
26-
- 深度研究和可行洞察
27-
28-
4. **pm-system.md** - 产品经理(Morgan)
29-
- PRD创建(Greenfield和Brownfield)
30-
- Epic和Story规划、路线纠正
31-
- 战略规划和质量检查清单
32-
33-
## 翻译术语表
34-
35-
| 英文 | 中文 | 说明 |
36-
|------|------|------|
37-
| UX Design Expert | UX设计专家 | Uma角色 |
38-
| Data Engineer | 数据工程师 | Dara角色,即数据库架构师 |
39-
| Analyst | 分析师 | Atlas角色 |
40-
| Product Manager | 产品经理 | Morgan角色 |
41-
| Atomic Design | 原子设计 | Brad Frost的组件设计方法 |
42-
| Design System | 设计系统 | UI组件库和设计令牌 |
43-
| Design Tokens | 设计令牌 | 设计系统中的可重用值 |
44-
| RLS | RLS(行级安全) | Row Level Security |
45-
| WCAG | WCAG(网页无障碍指南) | Web Content Accessibility Guidelines |
46-
| ROI | ROI(投资回报率) | Return on Investment |
47-
| Epic | Epic | 大型功能的集合 |
48-
| Story | Story | 单个用户故事或需求 |
49-
| Greenfield | Greenfield | 全新项目 |
50-
| Brownfield | Brownfield | 现有项目的增强 |
51-
| DBA | DBA(数据库管理员) | Database Administrator |
52-
| PRD | PRD(产品需求文档) | Product Requirements Document |
53-
54-
## 使用方式
55-
56-
这些文档是AIOS框架的参考资料。每个代理系统文档包括:
57-
58-
- **概览** - 代理的目的和特征
59-
- **完整文件列表** - 所有相关任务、模板、检查清单
60-
- **流程图和状态机** - 可视化工作流
61-
- **命令映射** - 所有可用命令及其参数
62-
- **代理集成** - 与其他代理的协作方式
63-
- **最佳实践** - 如何高效使用代理
64-
- **故障排除** - 常见问题和解决方案
65-
66-
## 文档结构
67-
68-
每个代理文档包含以下标准部分:
69-
70-
1. 标题和元数据(版本、创建日期、所有者)
71-
2. 概览和核心原则
72-
3. 完整文件清单(按类别)
73-
4. 流程图和可视化
74-
5. 命令映射表
75-
6. 代理间集成
76-
7. 最佳实践
77-
8. 故障排除指南
78-
9. 参考资料
79-
10. 总结和变更日志
80-
81-
## 相关资源
82-
83-
- 原始英文文档: `docs/aios-agent-flows/`
84-
- 产品模板: `.aios-core/product/templates/`
85-
- 开发任务: `.aios-core/development/tasks/`
86-
- AIOS工作流: `.aios-core/development/workflows/`
87-
88-
## 维护和更新
89-
90-
这些是官方翻译文档,与英文原版保持同步。如发现翻译错误或需要更新,请提交反馈。
13+
**版本:** 1.0.0
14+
**最后更新:** 2026-02-05
15+
**状态:** 官方文档
16+
17+
---
18+
19+
## 概述
20+
21+
此文件夹包含所有 AIOS 代理的详细文档,包括:
22+
23+
- 每个代理的**完整系统**
24+
- 操作的 **Mermaid 流程图**
25+
- 命令到任务的**映射**
26+
- 代理之间的**集成**
27+
- 涉及每个代理的**工作流**
28+
- **最佳实践**和故障排除
29+
30+
---
31+
32+
## 已文档化的代理
33+
34+
| 代理 | 角色 | 原型 | 文档 |
35+
|--------|---------|-----------|-----------|
36+
| **@aios-master** | Orion | 编排者 | [aios-master-system.md](./aios-master-system.md) |
37+
| **@analyst** | Atlas | 研究员 | [analyst-system.md](./analyst-system.md) |
38+
| **@architect** | Aria | 愿景者 | [architect-system.md](./architect-system.md) |
39+
| **@data-engineer** | Dara | 数据圣人 | [data-engineer-system.md](./data-engineer-system.md) |
40+
| **@dev** | Dex | 构建者 | [dev-system.md](./dev-system.md) |
41+
| **@devops** | Gage | 守护者 | [devops-system.md](./devops-system.md) |
42+
| **@pm** | Morgan | 策略师 | [pm-system.md](./pm-system.md) |
43+
| **@qa** | Quinn | 守护者 | [qa-system.md](./qa-system.md) |
44+
| **@sm** | River | 协调者 | [sm-system.md](./sm-system.md) |
45+
| **@squad-creator** | Nova | 创建者 | [squad-creator-system.md](./squad-creator-system.md) |
46+
| **@ux-design-expert** | Uma | 设计师 | [ux-design-expert-system.md](./ux-design-expert-system.md) |
47+
48+
---
49+
50+
## 每个文档的结构
51+
52+
每个代理文档都遵循以下标准结构:
53+
54+
```
55+
1. 概述
56+
- 主要职责
57+
- 核心原则
58+
59+
2. 完整文件列表
60+
- 核心任务
61+
- 代理定义
62+
- 模板
63+
- 检查清单
64+
- 相关文件
65+
66+
3. 系统流程图
67+
- 完整的 Mermaid 图
68+
- 操作流程
69+
70+
4. 命令映射
71+
- 命令 → 任务
72+
- 参数和选项
73+
74+
5. 相关工作流
75+
- 使用该代理的工作流
76+
- 代理在每个工作流中的角色
77+
78+
6. 代理之间的集成
79+
- 从谁接收输入
80+
- 向谁提供输出
81+
- 协作
82+
83+
7. 配置
84+
- 配置文件
85+
- 可用工具
86+
- 限制
87+
88+
8. 最佳实践
89+
- 何时使用
90+
- 避免什么
91+
92+
9. 故障排除
93+
- 常见问题
94+
- 解决方案
95+
96+
10. 变更日志
97+
- 版本历史
98+
```
99+
100+
---
101+
102+
## 代理关系图
103+
104+
```mermaid
105+
flowchart TB
106+
subgraph ORCHESTRATION["编排"]
107+
MASTER["@aios-master\n(Orion)"]
108+
end
109+
110+
subgraph DISCOVERY["发现与规划"]
111+
ANALYST["@analyst\n(Atlas)"]
112+
PM["@pm\n(Morgan)"]
113+
end
114+
115+
subgraph DESIGN["设计与架构"]
116+
ARCHITECT["@architect\n(Aria)"]
117+
UX["@ux-design-expert\n(Uma)"]
118+
DATA["@data-engineer\n(Dara)"]
119+
end
120+
121+
subgraph MANAGEMENT["管理"]
122+
PO["@po\n(Pax)"]
123+
SM["@sm\n(River)"]
124+
end
125+
126+
subgraph EXECUTION["执行"]
127+
DEV["@dev\n(Dex)"]
128+
QA["@qa\n(Quinn)"]
129+
DEVOPS["@devops\n(Gage)"]
130+
end
131+
132+
MASTER --> ANALYST
133+
MASTER --> PM
134+
ANALYST --> PM
135+
PM --> UX
136+
PM --> ARCHITECT
137+
UX --> ARCHITECT
138+
ARCHITECT --> DATA
139+
ARCHITECT --> PO
140+
PO --> SM
141+
SM --> DEV
142+
DEV --> QA
143+
QA --> DEVOPS
144+
145+
style MASTER fill:#e3f2fd
146+
style EXECUTION fill:#c8e6c9
147+
```
148+
149+
---
150+
151+
## 如何使用本文档
152+
153+
### 了解代理
154+
155+
1. 访问所需代理的文档
156+
2. 阅读**概述**了解角色
157+
3. 查阅**命令**了解功能
158+
4. 查看**工作流**了解上下文
159+
160+
### 调试问题
161+
162+
1. 直接转到**故障排除**部分
163+
2. 查阅**流程图**了解流程
164+
3. 检查**集成**了解依赖关系
165+
166+
### 扩展系统
167+
168+
1. 分析**文件列表**了解需要修改什么
169+
2. 遵循**最佳实践**保持一致性
170+
3. 更改后更新**变更日志**
171+
172+
---
173+
174+
## 与其他文档的关系
175+
176+
| 文档 | 位置 | 目的 |
177+
|--------------|-------------|-----------|
178+
| 代理参考指南 | [docs/agent-reference-guide.md](../agent-reference-guide.md) | 快速参考 |
179+
| 工作流指南 | [docs/guides/workflows-guide.md](../guides/workflows-guide.md) | 工作流指南 |
180+
| AIOS 工作流 | [docs/aios-workflows/](../aios-workflows/) | 工作流详情 |
181+
| 架构 | [docs/architecture/](../architecture/) | 技术架构 |
182+
183+
---
184+
185+
## 贡献
186+
187+
添加或更新代理文档时:
188+
189+
1. 遵循上述标准结构
190+
2. 包含更新的 Mermaid 图
191+
3. 保持变更日志更新
192+
4. 创建 EN 和 ES 翻译
91193

92194
---
93195

94-
**翻译日期:** 2026-02-22
95-
**翻译语言:** 中文简体(zh-CN)
96-
**术语标准化:** 根据AIOS官方术语表
196+
*AIOS 代理流程文档 v1.0 - 代理系统详细文档*

0 commit comments

Comments
 (0)