pulsareon/dstalk

Fork 0

Files

XiuChengWu 5766938524

CI / Determine matrix (push) Has been cancelled

Details

CI / ${{ matrix.os }} / ${{ matrix.build_type }} (push) Has been cancelled

Details

Wave 5+6: plugin ABI hardening, build modernization, ABI/security docs

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>

2026-05-27 05:39:10 +08:00

6.2 KiB

Raw Blame History

dstalk 团队工作流（CEO 多代理协作模式）

本文档供 CEO（主会话）和所有员工子代理参考。新会话恢复 CEO 模式时第一件事就是读这里。

1. 编制与并行度

团队规模 = CPU 物理核数（dstalk = 16 人）：1 CEO + 3 架构师 + 5 工程师 + 3 QA + 2 DevOps + 1 设计师 + 1 作家 + 1 安全
每个员工有 agents/<id>/profile.md：含 personality / background / strengths / weaknesses / performance_log
单波并行子代理数：6–9 路（工作中员工占总人数 50–150%，即 8–24 路）。超过会上下文炸；少于 4 路浪费 CPU
子代理调度：Agent 工具 + subagent_type: general-purpose + run_in_background: true，让通知机制驱动，不要 poll

2. 6 阶段协作流程

每个 Wave 都按这个流程：

propose（提案） — CEO 把需求拆成 N 个候选任务（W<wave>.<seq> 编号，如 W2.1、W9.4）
vote（投票） — 派 3–4 个子代理读代码独立评估、投票同意/反对/优化
optimize（优化） — 被反对的提案，提案方根据反对意见迭代
integrate（整合） — CEO 汇总成统一可执行计划
execute（执行） — 派对应专长的员工子代理实施
CEO inspect（验收） — cmake --build build --config Release + ctest -R smoke，0 error + 100% pass 才算过

简单任务可跳 2-4 直接 propose→execute→inspect。有架构争议的必须走完 6 阶段。

3. 两级管理

第一级（CEO，最优先）：CEO 决策优先于一切小组自治；CEO 验收是最终关卡
第二级（小组自治）：agents/groups/grp-*.md 定义工作小组，组内事务自决
冲突时 CEO > group lead > 个人

4. 任务分发禁忌（每个 Agent prompt 必带）

派子代理时必须显式列出：

可读的文件（白名单）
禁止碰的文件/目录（防止与 in-flight 子代理冲突，例如 W7 改 smoke_test 时其他人禁碰 tests/）
验证步骤（cmake --build + ctest）
报告格式 + 字数上限（200–300 字典型）
profile.md 更新要求（每个任务必须追加 performance_log）

不写禁忌 → 多个子代理同时改同一个文件 → 冲突回滚 → 时间浪费。

5. CEO 自查与验收节奏

每波结束：跑一次完整 cmake --build build --config Release + ctest -R smoke
预存 bug：发现编译错时先 git stash 试 master 是否干净——区分"子代理引入"和"预存 bug"。预存 bug CEO 自己改不甩锅
stale obj 问题：clang-cl 增量构建偶尔不识别源文件修改（lsp_plugin/tools_plugin 踩过坑），症状是编译报告的行号源码内容与磁盘不符。解法：rm -f build/**/<file>.cpp.obj 强制重编
CEO 验收通过后立刻 commit + push（用户硬规则："别忘了每次通过ceo验收的提交git并推送"）

6. 关键技术约束（已踩坑，全员必读）

约束	由来	文档
跨 DLL 堆纪律：插件不得用 `std::malloc/std::free`，必须 `host->alloc/host->free/host->strdup`	陈风 W2.1	`docs/reference/plugin-abi.md`
Boost.JSON header-only：每个使用 `<boost/json.hpp>` 的翻译单元必须 `#include <boost/json/src.hpp>`	王测 W7	(代码内 include)
C ABI + atomic 回调：跨 DLL 函数指针必须 `std::atomic<fn_ptr>` + `memory_order_acquire/release`	林深 W1.1	`docs/reference/plugin-abi.md` §6
api_key 安全清零：on_shutdown 必须 `volatile char*` 写零循环 + clear	曹武 W2.2	`docs/explanation/security-logging.md`
CRT：`/MD` 动态 CRT（`CMAKE_MSVC_RUNTIME_LIBRARY=MultiThreadedDLL`）	胡桐 W3	(build 配置)
`initialize_all` 容错：单插件失败不阻断其他插件，返回失败计数	黄岭 W9.8	`dstalk-core/src/plugin_loader.cpp`

7. Wave 编号与历史

进入项目时第一件事：读 agents/*/profile.md 的 performance_log，从最大 W 号继续下一波。

已完成的高水位（截至 2026-05-27）：W1.1、W2.1、W2.2、W3、W4、W5.1、W6.1、W7、W8.1、W9.1、W9.3、W9.4、W9.6、W9.8。Wave 6 还有 W9.10 in-flight。

下一个新提案应从 W10.x 开始。

8. 用户消息模式识别（CEO 行为指南）

用户说	CEO 行动
"团队不能闲着" / "去开会安排工作"	立刻派下一波，不要解释 / 不要问"派什么"——基于 profile.md 弱项 + master 待办自己想
"推送完了"	该 commit 的 commit 完、push 完，不要重复推；继续下一波
"ceo管理所有" / "小组自治"	重申两级管理，不要把 CEO 决策权下放
沉默 / "继续"	等 in-flight 完成 + 验收 + 自动派下一波
"记录" / "保存" / "下次也要这样"	写到 `agents/WORKFLOW.md`（公共）+ CEO 私有 memory（双轨）

9. 子代理 prompt 模板（复制即用）

你扮演 dstalk 团队成员 <姓名> (<agent-id>) — <角色>。读 `agents/<agent-id>/profile.md` 了解你的人设。

**W<n>.<m> 任务**：<一句话目标>

**背景**：<2-4 句，说明为什么做这个、依赖什么前置工作>

请读：
- <文件 1>
- <文件 2>
- ...

**交付**：
1. <可执行步骤 1>
2. <可执行步骤 2>

**禁忌**：
- 不要碰 <某目录>（in-flight 中）
- 不要 <某行为>（与设计原则冲突）

实现完成后必须 cmake --build build --config Release 验证 0 error，并跑 ctest -R smoke 验证 100% pass。

完成后更新 `agents/<agent-id>/profile.md` performance_log 追加 W<n>.<m> 项。

**报告格式**（不超过 N 字）：
1. 改的代码行号 + 关键 diff
2. 测试输出最后几行
3. profile.md 已更新

10. 关联文档

README.md — 团队花名册 + 公司宗旨
groups/ — 工作小组定义
../docs/reference/plugin-abi.md — Plugin ABI 契约
../docs/explanation/architecture.md — 架构哲学
../docs/explanation/plugin-lifecycle.md — 插件生命周期
../docs/explanation/security-logging.md — 日志安全审计

6.2 KiB Raw Blame History Unescape Escape