Files
marqdo/doc/roadmap/ext-agent-optimize.md
T
cflmyandCursor 0f72173d08 feat(ext/ai): land Agent/LLM optimize waves O1–O5
Wire opt-in sandbox trial into agent, require sandbox proof before OKF
promote, add step_route/EFI/cost surfaces, style lint + quarantine, and
offline policy optimize script—keeping GFM tables over json glue.

Co-authored-by: Cursor <cursoragent@cursor.com>
2026-10-16 11:47:28 +08:00

3.6 KiB
Raw Permalink 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
后续 优化波次 O1–O5 见 ext-ai-optimize.md(沙盒证明 · Skill Lift · 路由/成本 · lint · 隔离)

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。