Files
marqdo/doc/roadmap/ext-agent-optimize.md
T
cflmyandCursor 0ed57b6d54 feat(agent): ext APIs, goldens, and docs for MCP/resume/small-llm routing
Wire mcp_connect/list/call, resume_*, and demote Jev in author docs.
Offline goldens cover MCP client, resume, and small-llm/jev-alias route.

Co-authored-by: Cursor <cursoragent@cursor.com>
2026-09-24 20:26:55 +08:00

3.5 KiB
Raw Blame History

ext/agent 深入优化(调研驱动)

状态 A0–A4 完成;Wave B Active(宪法优先:代码即文档 / call_site / OKF)
日期 2026-09-04
调研 agent-frameworks-and-marqdo.md · agent-framework-gaps-after-a4.md · agent-framework-2026-09.md
设计 ext-agent.md · ext-agent-plan.md · ext-agent-parent.md · okf.md
邻近 agent-streaming.md · okf-near-match.md

1. 优化原则(来自调研)

  1. 强化差异化,不向 LangChain 薄循环回退(禁止隐藏 TOOL: 主路径、禁止整文件 LLM 重写工作簿)。
  2. 把资源砸在:工作簿质量、写回、固化、OKF 命中、过程可视、源码/调用位置注入。
  3. 外部 RAG/MCP 只作工具,不升为权威真相源。

自评四问见调研 §9。A0–A4 之后的缺口见 agent-framework-gaps-after-a4.md。2026-09 Wave B 锁定见 agent-framework-2026-09.md。


2. A0–A4(已完成)

波次 主题 验收线索
A0 工作簿补丁 / 固化可靠性 done — 金样 agent-workbook-patch-a0
A1 OKF 复用飞轮 done — 金样 agent-kb-plan-hit
A2 过程可见 done — events + view plan 卡
A3 上下文预算 done — source_brief / READ:;金样 agent-context-budget-a3
A4 RAG/MCP 证据工具 done — 金样 agent-tools-rag-a4

3. Wave B(Active — 宪法优先)

波次 主题 状态
B0 官方示例演示 call_site/源码/OKF;Skill/文档;上下文管道可读 done
B0.5 本机 live(.env → 开发模型)验证「模型用上了文档」 done(AGENT_LIVE / AGENT_HARNESS_LIVE)
B1 评测 harness 锁差异化指标(constitution / dump / writeback 遮蔽) Active
B1.5 Skill Compilation v2(Phase 1–3):episode → maybe_learn → compile → llm_free;agent.run / resolve / metrics;ABI 在 plugins/agent(memory.rs);金样 agent-v2-learn done
B1.6 / P4 Adaptive Routing(原 Jev Router 更名):route backends = marqdo | small-llm | jev? | llm | auto;Policy Compilation → policies/router.mq.md;金样 agent-p4-route;设计 004.md done
L0 LLM semantic surface(005):ask / stream / collect / create;complete 降为兼容;统一方案 ai-stack.md done
B2 真 MCP stdio client(agent_mcp_client + fixture 仍作离线证据) done
B3 resume checkpoint(.marqdo/agent-resume/;HITL view 仍暂缓) done(HITL 暂缓)
B4–B5 stats / 并行;小模型 live 路由金样(无 key skip) 部分
— LLM named models / prompt-document done

示例:examples/agent-pong/ · examples/agent-okf-flywheel/。v2 设计:doc/next/002.md · doc/next/003.md · P4:doc/next/004.md · LLM:doc/next/005.md。