Wave 5 (9 parallel agents): - W1.1 atomic diag callback + DLL handle release on shutdown (lin) - W2.1 unify cross-DLL heap discipline (host->alloc/free/strdup) (chen) - W2.2 secure_zero api_key on shutdown for deepseek/anthropic (cao) - W3 CMake modernization: target-based cxx_std_20, dstalk_boost_config INTERFACE lib, root-level RUNTIME_OUTPUT_DIRECTORY (hu) - W4 GitHub Actions CI with dynamic Linux/Windows matrix (ma) - W5.1 SSE buffer_body to cut peak memory ~67% on 32K streams (zhou) - W6.1 LSP JSON-RPC frame parser hardened against header reordering (sun) - W7 smoke test: copy plugin DLLs post-build + Boost.JSON src.hpp fix for full 9-plugin load coverage (wang) - W8.1 README slimmed 398->92, Diataxis docs/ skeleton (deng) Wave 6 (6 parallel agents): - W9.1 docs/explanation: architecture + plugin-lifecycle (deng) - W9.3 log credential leak audit (0 vulns, audit trail in docs/explanation/security-logging.md) (cao) - W9.4 docs/reference/plugin-abi.md - 7-point ABI contract (lin) - W9.6 CLI /history command + status integration (zhao) - W9.8 plugin_loader fault tolerance: per-plugin failure no longer aborts dstalk_init (huang) - W9.10 host_api unit tests: tests/host_api_test.cpp, 8 cases (liu) CEO oversight (preexisting bugs fixed during Wave 5 verification): - lsp_plugin.cpp:449 forward decl mismatch (int vs void) - tools_plugin.cpp:109 missing forward decl Multi-agent collaboration framework: - agents/WORKFLOW.md: 6-stage protocol, two-tier governance, prompt template, technical constraints registry Build: cmake --build 0 error / 0 warning. Tests: 2/2 100% pass. 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com>
144 lines
6.4 KiB
Markdown
144 lines
6.4 KiB
Markdown
# 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 三个工作小组。
|