diff --git "a/Agent\344\272\244\344\272\222\345\261\202\350\267\257\347\272\277\345\233\276.md" "b/Agent\344\272\244\344\272\222\345\261\202\350\267\257\347\272\277\345\233\276.md" new file mode 100644 index 0000000..262b5eb --- /dev/null +++ "b/Agent\344\272\244\344\272\222\345\261\202\350\267\257\347\272\277\345\233\276.md" @@ -0,0 +1,89 @@ +# Agent 交互层路线图 + +> 策略:保留测试核心,渐进补齐 Agent 交互层 +> ⚠️ 临时文档,全部完成后删除 + +--- + +## 图例 + +- `[✓]` 已完成 · `[ ]` 待完成 · `[WIP]` 进行中 + +--- + +## P0 · 基础修复 + +| # | 功能 | 状态 | +|---|------|:--:| +| 1 | REPL 自然语言路由修复(`_handle_natural_language` Kernel API) | [✓] | +| 2 | 友好错误引导(`_diagnose_error` 分类提示) | [✓] | +| 3 | 首次使用引导(`_check_first_run` 3 步上手) | [✓] | +| 4 | `/model` 分离 provider + model | [✓] | + +--- + +## P1 · 体感层 + +| # | 功能 | 状态 | +|---|------|:--:| +| 5 | 流式输出(execute_sync → generator yield) | [ ] | +| 6 | MEMORY.md 持久化(跨会话记忆) | [ ] | +| 7 | Tab 补全增强(agent/skill 名) | [ ] | +| 8 | 错误交互全覆盖(所有 /command 友好提示) | [ ] | +| 9 | 启动欢迎动画 | [ ] | + +--- + +## P2 · 能力层 + +| # | 功能 | 状态 | +|---|------|:--:| +| 10 | IM 多渠道接入(Telegram / Discord / 飞书 webhook) | [ ] | +| 11 | Sub-agent 对话触发("帮我测试 X"→ 自动启编排) | [ ] | +| 12 | MCP client 完善(`runtime/mcp/` 已有基础) | [ ] | +| 13 | 定时主动任务(自检 + 报告推送) | [ ] | +| 14 | 模型自动路由(轻量分类 + 重量执行) | [ ] | +| 15 | 多行输入(代码块、长文本粘贴) | [ ] | + +--- + +## P3 · 深度层 + +| # | 功能 | 状态 | +|---|------|:--:| +| 16 | 会话全文搜索(SQLite FTS5) | [ ] | +| 17 | 上下文智能压缩(长对话自动总结) | [ ] | +| 18 | 技能自进化(自动创建/评分 Skill) | [ ] | +| 19 | 7×24 daemon 模式(`tagent serve --daemon`) | [ ] | +| 20 | 用户画像(自动学习偏好) | [ ] | +| 21 | 智能审批(学习信任命令,减少打断) | [ ] | +| 22 | 插件热加载(`plugins/` 目录 drop-in) | [ ] | +| 23 | 语音交互 | [ ] | + +--- + +## 架构原则 + +``` +不改测试核心(16 Experts + 32 Skills + 79 Utils + Prefect 编排) +只在上面加 Agent 交互层。 + + ┌──────────────────────────┐ + │ Agent 交互层 (新增) │ ← P1-P3 + │ REPL · IM · Memory │ + ├──────────────────────────┤ + │ 测试编排层 (已有) │ ← 不动 + │ test-coordinator · DAG │ + ├──────────────────────────┤ + │ 执行引擎层 (已有) │ ← 不动 + │ runtime · utils · CLI │ + └──────────────────────────┘ +``` + +## 修改纪律 + +每次修改遵守 Karpathy 四纪律: +1. 先想再写 — 查根因、列假设 +2. 简单优先 — 最小代码,不复用不抽象 +3. 手术修改 — 只改必须改,匹配现有风格 +4. 目标驱动 — 每行可追溯到任务