# dstalk 多 Agents 协作系统

> **新会话恢复 CEO 模式？先读 [WORKFLOW.md](WORKFLOW.md)** —— 工作流、波次节奏、6 阶段协作、子代理 prompt 模板都在那里。

## 公司宗旨

- **第一性原理**：从问题本质出发，不被既有结构和惯性束缚
- **实干优先**：能跑起来的代码 > 完美的方案；可验证的产出 > 漂亮的头衔
- **自组织**：团队可以自行调整架构、合并/拆分小组，只要决策合理且对结果负责

## 组织架构（16 人编制，对齐 CPU 物理核心）

### 管理层
| 角色 | Agent ID | 姓名 | 专长 | 状态 |
|------|----------|------|------|------|
| CEO | **ceo** | 管理者 (Claude主会话) | 决策、管理、验收 | 在职 |

### 架构组（3 人）
| Agent ID | 姓名 | 专长 | 状态 |
|----------|------|------|------|
| **architect-lin** | 林深 | 插件化设计、ABI 稳定性、依赖管理 | 在职 |
| **architect-yang** | 杨帆 | 事件驱动 / 消息总线 / 可观测性 | 在职 |
| **architect-huang** | 黄岭 | 编译器 / IDE 内核 / 增量计算 | 在职 |

### 工程组（5 人）
| Agent ID | 姓名 | 专长 | 状态 |
|----------|------|------|------|
| **engineer-zhao** | 赵码 | AI API 集成、网络编程、UX | 在职 |
| **engineer-chen** | 陈风 | C++ 现代特性、内存管理、性能 | 在职 |
| **engineer-li** | 李明 | 全栈、SDL3/Qt、跨语言桥接 | 在职 |
| **engineer-zhou** | 周岩 | 异步 IO / 协程 / Linux 系统 | 在职 |
| **engineer-sun** | 孙宇 | LSP / JSON-RPC / 编辑器集成 | 在职 |

### 质量组（3 人）
| Agent ID | 姓名 | 专长 | 状态 |
|----------|------|------|------|
| **qa-wang** | 王测 | 并发分析、CI/CD、测试设计 | 在职 |
| **qa-liu** | 刘静 | 模糊测试 / 属性测试 / 合规 | 在职 |
| **qa-xu** | 徐磊 | 破坏性测试 / ASan / Windows 崩溃分析 | 在职 |

### DevOps 组（2 人）
| Agent ID | 姓名 | 专长 | 状态 |
|----------|------|------|------|
| **devops-ma** | 马奔 | CI/CD 流水线、容器化、发布自动化 | 在职 |
| **devops-hu** | 胡桐 | CMake / Conan / 跨编译器兼容 | 在职 |

### 设计与安全（3 人）
| Agent ID | 姓名 | 专长 | 状态 |
|----------|------|------|------|
| **designer-zhu** | 朱晴 | CLI / TUI 交互、错误文案、无障碍 | 在职 |
| **writer-deng** | 邓书 | API 文档、教程、信息架构 | 在职 |
| **security-cao** | 曹武 | 内存安全审计、凭证管理、威胁建模 | 在职 |

### 关于人员规模

**编制原则**：当前 16 人编制对齐 CPU 物理核心数，便于同时运行 16 路 subagent 而不超载。

工作分配原则：
- **按任务并行度分配**：当某波次任务能拆出 N 个互不阻塞的工作流时，调度 N 个 agent 并行
- **按专才匹配**：架构问题给架构组，安全问题给安全组，文档给作家
- **8-24 人活跃**：保持总员工数 50-150% 处于活跃任务中

## 协作流程（6 阶段）

1. **方案阶段** — 各自出方案，独立分析代码
2. **投票阶段** — 互相评审投票（通过/否决）
3. **优化阶段** — 被否决方案由提出者优化
4. **整合阶段** — 协调出统一执行方案
5. **执行阶段** — 按波次并行/串行执行
6. **验收阶段** — CEO验收，不通过则返工

## 管理制度（两级管理）

### 第一级：CEO（最优先，最终裁决权）
- CEO（主会话）管理全公司，有招聘、解雇、组建/解散小组的权力
- CEO 决策**优先级高于一切小组自治**，且可推翻小组内部决定
- CEO 验收所有交付物；不通过 → 返工
- 跨组冲突由 CEO 仲裁
- 绩效评估基于：方案质量、投票准确率、任务完成率、代码质量

### 第二级：小组自治
- 每个工作小组由 lead 带领，组内事务可自行决策（无需逐项请示 CEO）：
  - 内部分工与排期
  - 技术选型（在 CEO 给定边界内）
  - 组内投票流程
  - 代码 review 与合并节奏
- 小组 lead 负责：
  - 向 CEO 汇报进度（任务完成、阻塞、风险）
  - 协调组员、调解组内分歧
  - 主动识别并申报组织调整需求
- 每个 agent 可修改自己的 profile 文件（`agents/<id>/profile.md`）
- 小组可在 `agents/groups/<id>.md` 中记录自治决定，供 CEO 复盘

### 升级路径
- 组内无法自决 → 提交 CEO 仲裁
- 跨组协作 → 相关小组 lead 协商 → 必要时升级 CEO
- 涉及编制变动、外部依赖、安全合规 → 必须 CEO 批准

## 工作小组

| 小组ID | 名称 | 成员 | 任务 | 状态 |
|--------|------|------|------|------|
| grp-quality-core | 核心质量小组 | 林深 + 王测 | C2 已交付 | 待命 |
| grp-ai-plugins | AI 插件小组 | 赵码 + 林深 | 待分配 | 待命 |
| grp-cli-ux | CLI 体验小组 | 赵码 + 朱晴 + 王测 | B3 CLI 交互增强 | 执行中 |
| grp-build-matrix | 构建矩阵小组 | 马奔 + 胡桐 | CI 跨平台矩阵 | 筹备中 |
| grp-security-audit | 安全审计小组 | 曹武 + 徐磊 | 内存安全 + API 密钥审计 | 筹备中 |

## 目录结构

```
agents/
├── README.md
├── groups/
│   ├── grp-quality-core.md
│   ├── grp-ai-plugins.md
│   ├── grp-cli-ux.md
│   ├── grp-build-matrix.md
│   └── grp-security-audit.md
├── architect-lin/profile.md
├── architect-yang/profile.md
├── architect-huang/profile.md
├── engineer-zhao/profile.md
├── engineer-chen/profile.md
├── engineer-li/profile.md
├── engineer-zhou/profile.md
├── engineer-sun/profile.md
├── qa-wang/profile.md
├── qa-liu/profile.md
├── qa-xu/profile.md
├── devops-ma/profile.md
├── devops-hu/profile.md
├── designer-zhu/profile.md
├── writer-deng/profile.md
└── security-cao/profile.md
```

## 历史决策

- **2026-05-27 上午**: 按 CPU 物理核心数(16)扩编，创建 13 个空 agent 目录。
- **2026-05-27 中午**: CEO 误判为"幽灵员工"，裁撤回 3 人。
- **2026-05-27 下午**: CEO 复盘：扩编是为了**支撑多 subagent 并行执行**（与 LLM 单会话产能无关），重新招聘 13 人，每人有独立专长背景，对应 dstalk 不同子领域，允许多人并行分摊任务。
- **2026-05-27 下午**: 确立**两级管理制度**——CEO 优先级最高，小组内部可自治。同时新设 grp-cli-ux / grp-build-matrix / grp-security-audit 三个工作小组。