From f8036d53008a44bf96f98a1ce895d0161622f0fc Mon Sep 17 00:00:00 2001 From: yumoqing Date: Sat, 15 Aug 2026 09:41:08 +0800 Subject: [PATCH] =?UTF-8?q?docs:=20=E8=AE=B0=E5=BD=95=E5=AE=8C=E6=95=B4?= =?UTF-8?q?=E5=8F=AF=E6=8F=92=E6=8B=94=E7=BB=B4=E5=BA=A6=E6=B8=85=E5=8D=95?= =?UTF-8?q?+=E6=8A=80=E8=83=BD=E5=85=AD=E7=BA=A7=E9=9A=94=E7=A6=BB+slash?= =?UTF-8?q?=E5=91=BD=E4=BB=A4?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- docs/agent-architecture.md | 40 +++++++++++++++++++++++--------------- 1 file changed, 24 insertions(+), 16 deletions(-) diff --git a/docs/agent-architecture.md b/docs/agent-architecture.md index d0dd8c2..42e5db5 100644 --- a/docs/agent-architecture.md +++ b/docs/agent-architecture.md @@ -50,29 +50,37 @@ get_ability(pipeline_id) # 按产线取能力包 - **依赖方向**：pipeline-core（纯定义+注册表）← pipeline-service（sdlc_ability 注册 SDLC 能力）。 - **扩展 B 产线**：新增 `b_ability.py` + `register_ability(...)`，零侵入 core / AgentExecutor。 -## 4. 通用工具 vs 产线工具 +## 4. 完整可插拔维度（能力栈） -**GENERAL_TOOLS（core 内核，任何产线 agent 都有，11 个）**： -switch_project / create_project / run_command / ask_user / delegate_subtask / -read_file / write_file / list_files / search_files / session_search / todo +每个维度遵循「通用 → 产线 → 角色 → 会话」四级加载（高覆盖低）： -**SDLC 能力包（pipeline_service/sdlc_ability.py，14 个）**： -create_task / list_tasks / task_detail / start_agents / diagnose_project / -list_deliverables / view_deliverable / list_questions / answer_question / -add_repo / list_repos / clone_repo / check_progress / add_bug +| 维度 | 通用(core) | 产线(pipeline) | 角色(role) | 会话/项目 | 状态 | +|------|-----------|---------------|-----------|----------|------| +| 工具 Tools | GENERAL_TOOLS | PipelineAbility.tools | 角色工具白名单 | 临时工具 | ✅ 通用+产线 | +| 技能 Skills | global/ | pipelines/{id}/common | pipelines/{id}/roles/{role} | projects/{id} | ✅ 六级 | +| slash 命令 | /help /status /reset /model /tools /skills | /tasks /diagnose | — | — | ✅ 通用+产线 | +| 角色 Roles | — | 产线定义角色集 | 角色=工具子集+技能+prompt+模型 | — | ⏳ 设计定待实现 | +| prompt 片段 | 通用心智 | 产线 prompt | 角色 prompt | — | ✅ 通用+产线 | +| 记忆 Memory | 通用记忆 | 产线记忆 | — | 项目记忆 | ⏳ 待分域 | +| 模型配置 | 默认 | default_model | 角色模型 | 会话覆盖 | ⚠️ 部分 | +| 子代理定义 | 通用委派 | 产线子代理形态 | 角色子代理 | — | ⏳ delegate 空壳 | +| 工作流 step | — | pipeline_register_step_type | — | — | ✅ 已可插拔 | +| 压缩/隔离策略 | 默认 config | 产线覆盖 | — | — | ✅ 已有 | ## 5. 已落地 vs 待办 | 项 | 状态 | |----|------| -| core 剥离 SDLC（GENERAL_TOOLS + DEFAULT_AGENT_CONFIG） | ✅ 已落地 | -| PipelineAbility 注册表 + 动态挂载 | ✅ 已落地 | -| sdlc_ability.py（SDLC 能力包） | ✅ 已落地 | -| AgentExecutor 按 pipeline_id 挂载（多实例隔离） | ✅ 已落地 | -| 诚实降级 / 能力自省 / ask_user | ✅ 已落地 | -| 通用工具集（terminal/file/search/session/todo/delegate） | ✅ 已落地 | -| 阶段2：slash 命令 + AgentIO 交互对齐 | ⏳ 待办 | -| 阶段3：gateway 服务层（会话生命周期 + 通道抽象） | ⏳ 待办 | +| core 剥离 SDLC（GENERAL_TOOLS + DEFAULT_AGENT_CONFIG） | ✅ | +| PipelineAbility 注册表 + 动态挂载 + 多实例隔离 | ✅ | +| sdlc_ability.py（SDLC 能力包：14 工具+prompt+handler） | ✅ | +| 技能六级隔离（global/org/pipeline/role/project/user） | ✅ | +| slash 命令注册表（通用 6 + SDLC 产线 2） | ✅ | +| 诚实降级 / 能力自省 / ask_user | ✅ | +| 通用工具集（terminal/file/search/session/todo/delegate） | ✅ | +| 角色定义可插拔（RoleSpec） | ⏳ 设计定，实现待做 | +| 记忆分域（通用/产线/项目） | ⏳ 待做 | +| 阶段3：gateway 服务层 | ⏳ 待做 | ## 6. 安全约束