feat(docs): 更新路线图 Phase 2 工具系统完成状态

将所有 Phase 2 待办项标记为已完成,更新当前状态和下一步行动
This commit is contained in:
徐涛
2026-06-07 10:57:20 +08:00
parent b6e7acfb0f
commit 692bff5751
+18 -15
View File
@@ -1,13 +1,13 @@
# AG Core Roadmap # AG Core Roadmap
> 定稿日期:2026-05-11 > 定稿日期:2026-05-11
> 最后更新:2026-06-02Phase 1 完成) > 最后更新:2026-06-07Phase 2 完成)
## 愿景 ## 愿景
AG Core 定位为构建 AI 智能体的底层工具箱,通过模块化、可插拔的架构,提供大模型调用、提示词工程、工具系统、记忆检索四大核心能力,支持快速组合出符合业务需求的智能体应用。 AG Core 定位为构建 AI 智能体的底层工具箱,通过模块化、可插拔的架构,提供大模型调用、提示词工程、工具系统、记忆检索四大核心能力,支持快速组合出符合业务需求的智能体应用。
**当前状态**:Phase 0 基础设施已全部完成,Phase 1 提示词工程已全部完成,等待 Phase 2 启动。 **当前状态**:Phase 0 基础设施已全部完成,Phase 1 提示词工程已全部完成,Phase 2 工具系统已全部完成,等待 Phase 3 启动。
--- ---
@@ -17,7 +17,7 @@ AG Core 定位为构建 AI 智能体的底层工具箱,通过模块化、可
|---------|---------|---------|-----------| |---------|---------|---------|-----------|
| LLM 调用周期 | ✅ 完整 | `specs/llm-call-lifecycle.md` | P0 | | LLM 调用周期 | ✅ 完整 | `specs/llm-call-lifecycle.md` | P0 |
| 提示词工程 | ✅ 完整 | `docs/4-prompt-engineering.md` | P1 | | 提示词工程 | ✅ 完整 | `docs/4-prompt-engineering.md` | P1 |
| 工具系统 + 权限 | ❌ 缺失 | — | P1 | | 工具系统 + 权限 | ✅ 完整 | `docs/5-tool-system.md` | P1 |
| 记忆检索 | ❌ 缺失 | — | P2 | | 记忆检索 | ❌ 缺失 | — | P2 |
| Agent 运行时 | ❌ 缺失 | — | P2 | | Agent 运行时 | ❌ 缺失 | — | P2 |
| 生命周期钩子 | ✅ 完整 | `docs/3-phase0-remaining.md` | P0LLM Cycle 扩展) | | 生命周期钩子 | ✅ 完整 | `docs/3-phase0-remaining.md` | P0LLM Cycle 扩展) |
@@ -78,19 +78,22 @@ AG Core 定位为构建 AI 智能体的底层工具箱,通过模块化、可
**目标**:实现 MCP 协议集成与自定义工具注册、调用、权限控制。 **目标**:实现 MCP 协议集成与自定义工具注册、调用、权限控制。
**交付物** **交付物**
1. `tools.rs` + `tools/` 模块 1. `tools.rs` + `tools/` 模块base/registry/permission/mcp/error
2. `ToolRegistry` — 工具注册表(注册、发现、调用) 2. `ToolRegistry` — 工具注册表(注册、发现、调用、并行执行、超时控制
3. `BaseTool` trait — 工具抽象接口 3. `BaseTool` trait — 工具抽象接口(含 ToolContext 执行上下文)
4. `McpClient` — MCP 协议客户端 4. `McpClient` — MCP 协议客户端stdio transportStreamableHttp 预留)
5. `PermissionChecker` — 工具执行权限检查(读/写/删除/网络等 5. `PermissionChecker` — 工具执行权限检查(白名单/黑名单/自定义权限
6. `specs/tool-call-loop.md` — Tool 自动执行循环设计 6. `docs/5-tool-system.md` — 方案设计文档
7. 扩展 `llm/cycle.rs` 支持自动 tool 循环(参考 OpenHarness `run_query()` 7. 扩展 `llm/cycle.rs` 支持自动 tool 循环(`submit_with_tools()` + `submit_request()` + `maybe_compact()`
8.`ToolError` — 结构化错误体系(含 `is_recoverable()` 分类)
**依赖**Phase 0LlmProvider 接口传递 tool definitions)、Phase 1(提示词可能需要注入工具描述) **依赖**Phase 0LlmProvider 接口传递 tool definitions)、Phase 1(提示词可能需要注入工具描述)
**优先级**Should Have **优先级**Should Have
**预估规模**:约 900 行代码 **预估规模**:约 900 行代码(实际约 1500 行)
**状态**:✅ Phase 2 全部交付物已完成
--- ---
@@ -139,7 +142,7 @@ AG Core 定位为构建 AI 智能体的底层工具箱,通过模块化、可
graph BT graph BT
P0["<b>Phase 0: Foundation</b><br/>LLM Cycle<br/>ProviderRegistry<br/>HookExecutor<br/>StreamEvents<br/>Auto-compaction"]:::done P0["<b>Phase 0: Foundation</b><br/>LLM Cycle<br/>ProviderRegistry<br/>HookExecutor<br/>StreamEvents<br/>Auto-compaction"]:::done
P1["<b>Phase 1: Prompt Engineering</b><br/>PromptTemplate<br/>PromptComposer"]:::done P1["<b>Phase 1: Prompt Engineering</b><br/>PromptTemplate<br/>PromptComposer"]:::done
P2["<b>Phase 2: Tool System</b><br/>Tool Registry<br/>PermissionChecker<br/>MCP Client"]:::pending P2["<b>Phase 2: Tool System</b><br/>Tool Registry<br/>PermissionChecker<br/>MCP Client"]:::done
P3["<b>Phase 3: Memory System</b><br/>MemoryStore<br/>VectorStore<br/>ConversationMemory"]:::pending P3["<b>Phase 3: Memory System</b><br/>MemoryStore<br/>VectorStore<br/>ConversationMemory"]:::pending
P4["<b>Phase 4: Agent Runtime</b><br/>ConversationAgent<br/>TaskAgent"]:::pending P4["<b>Phase 4: Agent Runtime</b><br/>ConversationAgent<br/>TaskAgent"]:::pending
@@ -179,10 +182,10 @@ graph BT
## 下一步行动 ## 下一步行动
1. **Phase 2 方案启动**:启动 `docs/5-tool-call-loop.md` 设计(含 PermissionChecker 1. **Phase 3 方案启动**:启动 `docs/6-memory-system.md` 设计
2. **Phase 3 方案启动**:启动 `docs/6-memory-system.md` 设计 2. **Phase 2 已就绪**:工具系统已交付,可为 Phase 3/4 提供工具调用能力
3. **依赖就绪**Phase 1 已交付,Phase 2 依赖的提示词能力已就位
**已完成阶段** **已完成阶段**
- ✅ Phase 0 Foundation — 全部交付物已完成 - ✅ Phase 0 Foundation — 全部交付物已完成
- ✅ Phase 1 Prompt Engineering — 全部交付物已完成 - ✅ Phase 1 Prompt Engineering — 全部交付物已完成
- ✅ Phase 2 Tool System — 全部交付物已完成