feat(agents): Phase 8.4-10.5 built-in plugins, bundled skills, coordinator

2026-04-04 23:24:34 +08:00
parent 88955ed550
commit d18167826e
105 changed files with 14780 additions and 15685 deletions
--- a/development-doc/daily/2026-04-03.md
+++ b/development-doc/daily/2026-04-03.md
@@ -0,0 +1,203 @@
+# 2026-04-03 工作日志
+
+## 今日开发计划
+
+### 今日目标
+
+- ~~分析 `demo/` 下三个 agent 项目与 Jarvis 当前 agents 的差异~~
+- ~~明确 Jarvis 2.0 升级方向~~
+- ~~建立 development-doc 文档结构~~
+- ~~形成分阶段 plan 文档~~
+- ~~形成 2 天融合改造计划~~
+
+### 今日计划拆分
+
+1. ~~分析 demo 项目能力与设计重点~~
+2. ~~评估 Jarvis 当前 agents 的优势与短板~~
+3. ~~输出 Jarvis 2.0 总体升级思路~~
+4. ~~建立 `development-doc/plan` 与 `development-doc/daily`~~
+5. ~~将 plan 拆成 phase 文档~~
+6. ~~输出 2 天融合改造计划~~
+
+### Day 1 工作内容
+
+#### Day 1 目标
+
+- ~~完成 demo 项目分析~~
+- ~~完成 Jarvis 当前能力差距判断~~
+- ~~完成 `development-doc/` 目录搭建~~
+- ~~完成 phase 文档拆分~~
+- ~~完成 2 天融合计划初稿~~
+
+#### Day 1 分步骤执行
+
+1. ~~分析 `demo/swarm-ide-chore-specs-mvp`~~
+2. ~~分析 `demo/claude-code-cli-master`~~
+3. ~~分析 `demo/claw-code-main`~~
+4. ~~梳理 Jarvis 当前 agents 架构优势与短板~~
+5. ~~输出 `plan/README.md` 与 phase 文档~~
+6. ~~输出 `2026-04-03-jarvis-agents-2-day-integration-plan.md`~~
+7. ~~建立并整理 `daily/` 日志结构~~
+
+#### Day 1 完成标准
+
+- ~~文档结构齐全~~
+- ~~分阶段计划可读~~
+- ~~两天改造路线明确~~
+- ~~daily 可持续维护~~
+
+> Day 2 内容已拆分到 `daily/2026-04-04.md`
+
+---
+
+## 今日实际完成
+
+1. 分析了以下 demo 项目：
+   - `demo/swarm-ide-chore-specs-mvp`
+   - `demo/claude-code-cli-master`
+   - `demo/claw-code-main`
+
+2. 梳理了 Jarvis 当前 agent 架构的优势与短板：
+   - 当前强项：分层路由、业务导向、continuity、fallback、测试基础
+   - 当前短板：动态协作不足、缺少 verifier、缺少 task/runtime、可观察性不足
+
+3. 输出并整理了 Jarvis 规划文档结构：
+   - `development-doc/README.md`
+   - `development-doc/plan/README.md`
+   - `development-doc/plan/phase-0-current-state-and-target.md`
+   - `development-doc/plan/phase-1-safe-foundation.md`
+   - `development-doc/plan/phase-2-controlled-collaboration.md`
+   - `development-doc/plan/phase-3-dynamic-collaboration.md`
+   - `development-doc/plan/phase-4-visibility-and-isolation.md`
+   - `development-doc/plan/2026-04-03-jarvis-agents-2-day-integration-plan.md`
+
+4. 建立并整理了 daily 目录：
+   - `development-doc/daily/2026-04-03.md`
+
+---
+
+## 当前进度
+
+### 文档规划进度
+
+- demo 分析：已完成
+- 总体升级方向：已完成
+- plan 目录搭建：已完成
+- 分阶段 plan：已完成
+- 2 天融合计划：已完成
+- daily 规范：已完成
+- Day 3 清单与验收文档：已更新
+- Day 4 清单：已更新
+
+### 代码改造进度
+
+- 已完成 Day 1 / Day 2 底座与协作闭环
+- 已完成 Day 3 最小受限动态协作 runtime
+- 已补齐 registry spawn policy、graph spawn guardrail、message trace、interrupt / recovery 最小闭环
+- Phase 1-3 核心功能已基本落地
+- Day 4 聚焦 Phase 4 可视化与隔离执行能力
+
+---
+
+## 今日修改的模块 / 文件
+
+### 新增 / 更新的开发文档
+
+- `development-doc/README.md`
+- `development-doc/plan/README.md`
+- `development-doc/plan/phase-0-current-state-and-target.md`
+- `development-doc/plan/phase-1-safe-foundation.md`
+- `development-doc/plan/phase-2-controlled-collaboration.md`
+- `development-doc/plan/phase-3-dynamic-collaboration.md`
+- `development-doc/plan/phase-4-visibility-and-isolation.md`
+- `development-doc/plan/2026-04-03-jarvis-agents-2-day-integration-plan.md`
+- `development-doc/daily/2026-04-03.md`
+
+### 本轮补充分析与改造涉及的代码文件
+
+- `backend/app/agents/state.py`
+- `backend/app/agents/graph.py`
+- `backend/app/agents/prompts.py`
+- `backend/app/agents/registry/models.py`
+- `backend/app/agents/registry/builtins.py`
+- `backend/app/agents/registry/indexes.py`
+- `backend/app/agents/tools/__init__.py`
+- `backend/tests/backend/app/agents/test_graph.py`
+- `backend/tests/backend/app/agents/test_registry.py`
+
+---
+
+## 今日结论
+
+### 从 demo 项目吸收的核心方向
+
+- 从 Swarm-IDE 学：动态通信原语、可观察性、协作拓扑
+- 从 Claude Code CLI 学：coordinator / task / verifier 的平台化编排
+- 从 Claw Code 学：runtime 分层、工具注册表、权限模型
+
+### Jarvis 总体升级方向
+
+Jarvis 不应直接变成完全自由的 swarm，而应升级为：
+
+- 受控的动态协作运行时
+
+原则：
+
+- 简单请求继续走当前稳定路径
+- 复杂请求才进入协作模式
+
+---
+
+## 当前阻塞点
+
+- 暂无明显代码层阻塞
+- 当前主要待办是完成定向回归测试并收尾验收
+
+---
+
+## 风险与临时决策
+
+### 当前风险
+
+- 不要一开始就引入无限动态 agent
+- 不要直接替换现有 graph 主路径
+- 应优先保持 reminder/task/search 等现有业务稳定
+- 新能力必须配套测试和约束策略
+
+### 当前决策
+
+1. 采用受限动态协作，而不是自由 swarm
+2. 通过 registry 固化 spawn role policy，再由 graph 在运行时执行权限校验
+3. interrupt / recovery 先落最小闭环，优先保证 direct 主路径稳定
+4. daily 后续必须作为开发过程中的持续更新日志使用
+
+---
+
+## 验证 / 测试情况
+
+- 已补充 Day 3 相关 runtime / registry / graph 回归测试
+- 已更新 Day 3 执行清单与 daily 状态
+- 正在执行定向 pytest 验证，重点覆盖 `test_graph.py` 与 `test_registry.py`
+
+---
+
+## 下一步计划
+
+1. 完成 Day 3 定向回归测试
+2. 若有失败，修正 runtime / test 偏差
+3. 统一整理 Day 3 最终验收结论
+4. 启动 Day 4：Phase 4 可视化 API 实现
+5. 设计隔离执行最小方案
+
+---
+
+## 每日维护要求
+
+后续正式进入改造阶段后，本文件需要持续更新：
+
+1. 开始开发前更新“今日开发计划”
+2. 完成一个阶段性步骤后更新“当前进度”
+3. 变更方案时更新“风险与临时决策”
+4. 出现问题时更新“当前阻塞点”
+5. 每次完成验证后更新“验证 / 测试情况”
+6. 一天结束前补齐“已完成 / 未完成 / 下一步计划”
--- a/development-doc/daily/2026-04-04.md
+++ b/development-doc/daily/2026-04-04.md
@@ -0,0 +1,116 @@
+# 2026-04-04 工作日志
+
+## 今日开发计划
+
+### 今日目标
+
+- 巩固 `Phase 4` 已完成的可见性最小闭环
+- 把 runtime summary 接到 Agents 页面
+- 为后续 90 分路径明确 isolation / cost / operator surface 升级项
+- 保持 reminder / task / search 主路径稳定
+
+### 今日计划拆分
+
+1. 新增 `backend/app/agents/api/visibility.py` 可见性 API 模块
+2. 实现 event stream API
+3. 实现协作链路拓扑查询 API
+4. 实现 task 执行证据查询 API
+5. 实现 message thread 查询 API
+6. 实现 verifier 结果查询 API
+7. 设计隔离执行最小方案
+8. 补测试并验证主流程
+
+### Day 4 工作内容
+
+#### Day 4 目标
+
+- 完成 `Phase 4` 可见性 API 最小闭环
+- 完成 runtime summary API 与前端 Agents 页面首屏接入
+- 为后续完整隔离执行与成本治理预留接口
+- 保证已有路径测试不回退
+
+#### Day 4 分步骤执行
+
+1. 新增 `backend/app/agents/api/visibility.py` 及各可见性 API
+2. `GET /agents/visibility/events` - event stream 按条件过滤
+3. `GET /agents/visibility/topology` - 协作拓扑视图
+4. `GET /agents/visibility/tasks/{task_id}/evidence` - task 执行证据
+5. `GET /agents/visibility/threads/{thread_id}/messages` - thread 消息流
+6. `GET /agents/visibility/verifier` - verifier 验收结论
+7. 在 `development-doc/plan/phase-4-visibility-and-isolation.md` 补充隔离执行设计方案
+8. 补 `test_visibility_api.py` 及主流程回归测试
+
+#### Day 4 完成标准
+
+- event stream API 可按 conversation_id / thread_id / agent_id 过滤
+- topology API 可返回协作拓扑视图
+- evidence API 可返回 task 执行证据链
+- thread API 可重建消息流向
+- verifier API 可返回验收结论
+- 隔离执行设计方案可落地
+- 现有主流程测试继续通过
+
+---
+
+## 今日实际完成
+
+- 分析了 Jarvis 现有代码实现状态（`graph.py`、`state.py`、`verifier.py`、`registry/models.py`、`schemas/`）
+- 确认 Phase 1-3 核心功能已基本落地：task schema、event schema、verifier、tool metadata、collaboration flow、interrupt/recovery、message trace
+- 识别了 Phase 4（可视化与隔离执行）待实现内容
+- 在 `2026-04-03-jarvis-agents-5-day-work-checklist.md` 中新增了 Day 4 任务清单
+
+---
+
+## 当前进度
+
+### 代码改造进度（Phase 1-3）
+
+- ✅ task schema / event schema 已完整
+- ✅ verifier 模块已独立
+- ✅ state.py 已包含 collaboration 全部字段
+- ✅ registry/models.py 已补充 tool metadata
+- ✅ graph.py 已接入 event trace、verifier 调用、collaboration flow
+- ✅ interrupt / recovery 最小闭环已实现
+- ✅ message trace 已实现
+
+### Day 4 待启动
+
+- 待实现可见性 API（event stream、topology、evidence、thread、verifier）
+- 待设计隔离执行方案
+- 待补可视化 API 测试
+
+---
+
+## 今日修改的模块 / 文件
+
+- 待更新
+
+---
+
+## 当前阻塞点
+
+- 待开发时更新
+
+---
+
+## 风险与临时决策
+
+- 不直接重写 graph 主路径
+- verifier 优先以 helper 形式接入
+- 先补底座，不直接做自由 swarm
+
+---
+
+## 验证 / 测试情况
+
+- 待更新
+
+---
+
+## 下一步计划
+
+1. 实现 `visibility.py` 可见性 API 模块
+2. 按顺序实现 event stream、topology、evidence、thread、verifier API
+3. 设计隔离执行最小方案
+4. 补 `test_visibility_api.py` 测试
+5. 跑测试验证主流程不回退