每周推进计划 · AI Agent

Agent 学习每周推进计划

执行原则

每周只追一个主目标,但必须交付四样东西:

代码块TEXT · 1 行收起展开
1 篇高质量笔记 + 1 个可运行 demo + 1 组测试/验收 + 1 次复盘

不要把学习变成看资料。Agent 工程必须靠“实现 -> 失败 -> 复盘 -> 改进”推进。

12 周主计划

gantt
    title AI Agent 12 周推进计划
    dateFormat  YYYY-MM-DD
    section 基础闭环
    W1 LLM API / Streaming       :w1, 2026-07-05, 7d
    W2 Prompt / Gateway          :w2, after w1, 7d
    section 执行能力
    W3 Tool Calling              :w3, after w2, 7d
    W4 Tool Security / Audit     :w4, after w3, 7d
    section 知识与协议
    W5 MCP Readonly Server       :w5, after w4, 7d
    W6 MCP + Tool Integration    :w6, after w5, 7d
    W7 Obsidian RAG Index        :w7, after w6, 7d
    W8 RAG Eval / Citation       :w8, after w7, 7d
    section Agent 化
    W9 Workflow State Machine    :w9, after w8, 7d
    W10 Memory / Planner         :w10, after w9, 7d
    W11 Trace / Eval Runner      :w11, after w10, 7d
    W12 Demo / Deploy / README   :w12, after w11, 7d
每周时间分配建议 概念理解 20% 读文档 / 画图 动手实现 40% 写代码 / 跑 demo 测试评测 20% 验收 / eval 复盘整理 20% 笔记 / 待办

周计划表

主线学什么做什么验收
1LLM APImessages、模型参数、streaming/chat/chat/stream连续 20 问稳定
2Prompt / Gatewaysystem prompt、版本、错误归一ModelGateway可切模型、可查 token
3Tool Callingschema、tool call、tool result3 个本地工具参数错不执行
4Tool 安全权限、白名单、审计、确认ToolExecutor危险操作被拦截
5MCP 基础client/server/tools/resources只读 Notes MCP能 list/search/read
6MCP 工程化transport、错误、目录限制MCP + Spring API越权路径被拒绝
7RAG 索引Markdown parse、chunk、embedding索引 AI Agent 笔记正确笔记进 top5
8RAG 质量hybrid search、引用、拒答20 问 eval无资料时拒答
9Workflow状态机、最大步数、失败恢复学习计划 Agenttrace 可复盘
10Memoryprofile、event、reflection记忆写入/更新不无限 append
11Trace/Evaltrace event、judge、debug reportEval runner改 prompt 可对比
12产品化README、配置、部署、安全最终演示可运行、可讲清

每周固定节奏

flowchart TD
    Mon["周一 定目标"] --> Tue["周二 学概念"]
    Tue --> Wed["周三 写 demo"]
    Wed --> Thu["周四 补边界"]
    Thu --> Fri["周五 验收 eval"]
    Fri --> Sat["周六 整理笔记"]
    Sat --> Sun["周日 复盘计划"]
动作禁止
周一明确本周唯一主目标和验收同时开多个大坑
周二读文档、画流程图、列对象只收藏链接
周三写最小可运行链路追求完美架构
周四补权限、错误、日志只跑 happy path
周五跑验收问题和失败样例凭感觉说完成
周六写笔记和图表只写流水账
周日复盘、删减、定下周下周计划过大

每日记录模板

代码块MARKDOWN · 21 行收起展开
## 日期

### 今日目标

- 只写一个目标。

### 做出的东西

- 文件 / 接口 / demo / 图表。

### 关键理解

- 用自己的话解释一个概念。

### 失败和原因

- 哪一步失败;是概念、代码、工具、数据还是评测问题。

### 明天继续

- 一个最小下一步。

每周产出模板

代码块MARKDOWN · 17 行收起展开
# Week N - 主题

## 本周目标

## 架构/流程图

## 核心代码对象

| 对象 | 职责 | 输入 | 输出 |
|---|---|---|---|

## 验收结果

| Case | 结果 | 问题 |
|---|---|---|

## 下周风险

每周 Definition of Done

一周结束时,不按“看了多少资料”算完成,只按证据算完成。

证据必须有不合格表现
运行证据一个能复现的命令、接口或脚本只说“本地跑过”
代码证据至少一个核心对象或接口落地只有笔记,没有实现
失败证据至少一个失败样例和处理结果只跑 happy path
评测证据固定 case、期望、实际结果只凭感觉判断效果
Trace 证据输入、检索、模型、工具、输出可串起来只保存最终回答
笔记证据写清概念、对象、失败、验收只摘抄资料
下周证据一个最小下一步和一个要删掉的范围下周继续开大坑

如果本周只有笔记,没有可运行产物,本周最多算 40 分;如果只有 demo,没有失败样例和复盘,最多算 60 分。

周末评分表

维度0 分1 分2 分
主目标目标频繁变化目标明确但过大目标单一且能交付
Demo没有运行入口能跑但依赖手工操作命令/API 可复现
工程对象只有概念有类/表但职责不清字段、输入、输出清楚
边界无权限/超时/错误处理只处理部分错误有失败样例和降级
Eval无固定 case有少量手工问题有期望、实际、结论
Trace只看终端输出记录部分步骤能复盘完整链路
笔记流水账有总结但缺证据能指导下一次实现

总分解释:

分数判断下一步
0-5本周主要是输入,没有形成工程产物下周缩小到一个接口或一个工具
6-9有进展,但闭环不完整补失败样例、trace、eval
10-12可继续迭代在同一切片上加边界或质量
13-14高质量完成进入下一周主题

滚动计划规则

flowchart TD
    Review["周末复盘"] --> Score["评分"]
    Score --> Done{"达标?"}
    Done -->|yes| Next["进入下周"]
    Done -->|partial| Patch["补缺口"]
    Done -->|no| Cut["砍范围"]
    Patch --> Next
    Cut --> Retry["重做最小闭环"]
情况处理
本周 demo 没跑通下周不开新主题,先缩小到可运行链路
本周没有失败样例下周第一天补失败 case
本周 eval 缺失下周不改 prompt/模型,先建立基线
本周范围过大删除 50% 功能,只保留纵向切片
本周概念不清回到 05-AI工程基础入门到精通 写对象表
本周源码看不懂回到 06-21 找主循环、工具、上下文、trace

学习方法矩阵

主题正确学法反模式
Prompt用固定问题比较版本收藏 prompt 模板
Tool Calling先写 schema 和权限让模型执行任意命令
MCP先做只读 server一开始暴露写入/删除
RAG用自己的笔记做数据集只跑网上 demo
Workflow状态机控制步骤让模型无限自循环
Memory明确写入/更新/删除什么都 append
Eval固定问题集回归凭感觉判断效果
Trace记录每一步证据只保存最终答案

风险控制

本周卡住时的排查顺序 卡住 概念 画图 代码 缩 demo 模型 固定输入 检索 看 score 工具错误 参数/权限 写复盘
风险触发信号处理
看太多不动手两天没有 demo缩到一个接口
架构过大画了很多模块但不能运行砍到单链路
RAG 质量差找到资料但答不准先看 chunk 和引用
Agent 失控多步循环停不下加 max steps 和 stop reason
记忆污染旧错误反复影响答案加 update/delete 和审计
评测缺失改了不知道好坏固定 20 个问题

Week 1 细化样例

Day任务产出
Day 1建 Spring Boot 项目,配置模型 key/chat
Day 2加 streaming/chat/stream
Day 3ModelGateway统一模型接口
Day 4错误归一超时/key 错/限流
Day 5trace loglatency/token/prompt
Day 6写笔记LLM API 工程化要点
Day 7复盘下周 Tool Calling 计划

每周验收问题

  1. 本周跑通的最小闭环是什么?
  2. 哪个概念已经能用代码解释?
  3. 哪个模块现在仍然只有名词,没有实现?
  4. 哪个失败样例最有价值?
  5. 下周如果只能做一件事,应该做什么?

12 周结束标准

标准必须达到
功能能基于 Obsidian 回答,能调用工具,能生成学习任务
协议至少有一个只读 MCP Server
质量有 20+ eval cases
复盘每次回答有 trace
安全工具有权限边界
展示README 能讲清架构、运行、限制

核心结论

每周都要把“我学了什么”变成“我做出了什么、怎么验证、失败怎么复盘”。