老程序员 AI 编码 Agent 学习路线
你会写代码,只是不熟悉 AI。这张路线图告诉你——先碰什么、后碰什么、每步解决什么问题。图里每个项目都能在全景榜里找到详细数据。
Level 0 认知 ──── 什么是 AI 编码 Agent
Level 1 上手 ──── 装一个,跑通第一个项目
Level 2 技能 ──── 让 Agent 懂工程规范
Level 3 工具链 ─── 让 Agent 操作真实世界(MCP)
Level 4 方法论 ─── 从聊天到规范驱动
Level 5 上下文 ─── 解决 Agent "记不住"
Level 6 多智能体 ── 多个 Agent 协作
Level 7 生产化 ─── 评测、安全、CI/CD
───────────────────────────── 以上是 Agent 专项
───────────────────────────── 以下是通用工程提示词能力不单列一级,它横切在整条路线里——藏在技能(L2,复用的提示词)、方法论(L4,结构化提示)、上下文(L5,喂对信息)中。别去背"咒语",对老程序员真正稀缺、且直接决定代码质量的,是把需求讲清楚(见 Level 1)。
Level 0:认知(半天)
先明白 Agent 是什么、不是什么。
| 你要搞懂的事 | 看什么 |
|---|---|
| Agent 不是 ChatGPT——它能读写文件、跑命令、操作你的代码库 | 什么是智能体工程(库里有) |
| 整个生态分成哪几块 | Agent 能力增强开源生态分类图——看 5 分钟就懂 |
| Agent 工作的核心循环:读上下文 → 想 → 调用工具 → 看结果 → 再想 | 运行机制骨架 |
| 关键概念:LLM、token、上下文窗口、system prompt、工具调用 | 不需要深入原理,知道这些词就够了 |
出来混的第一步,是出来。
Level 1:上手(第 1 周)
选一个宿主,直接跑起来,不要配任何东西。
你 → 终端里输入需求 → Agent 理解代码库 → 写代码、跑命令 → 你 review → 继续| 宿主 | ⭐ | 怎么装 | 为什么选它 |
|---|---|---|---|
| Claude Code | — | Anthropic 官方产品,npm i -g @anthropic/claude-code | 最先推动终端编码 agent 概念的产品,社区最活跃 |
| opencode | 181k | npm i -g opencode-ai | 开源首选,中文 README,社区最大 |
| openai/codex | 95k | npm i -g @openai/codex | OpenAI 官方终端 agent,Codex 生态 |
第一周的任务:
opencode "给我写一个 Python CLI 工具,读 CSV 做统计"- 看它怎么读你的项目、怎么写代码、怎么跑命令
- 学会这个循环:说清楚需求 → 看它计划 → approve → 看结果 → 不满意就回退重来
- 试第二个项目:
"把这个 Express 项目加上 TypeScript 类型定义"
这个阶段不需要任何技能、配置、方法论。 老程序员最擅长的是"先跑起来再说"。
唯一要练的"提示词"能力:把需求讲清楚。 不是玩措辞技巧,而是像给一个不熟悉你项目的新同事派活——四件事说全:
- 背景:这是什么项目、改哪块、为什么改
- 约束:用什么语言/框架/版本、要遵守哪些既有规范、不许动什么
- 例子:贴一段现有代码当范式,或给个输入/输出样例
- 验收标准:怎么算做完(跑通哪个测试、满足什么行为)
需求越糊,Agent 越会自由发挥、越容易跑偏。这一条贯穿后面所有 Level,且比任何技巧都值钱。
Level 2:技能(第 2 周)
现在 Agent 能写代码了,但它不懂你的工程标准。技能就是「给 Agent 看的说明书」。
你的 Agent ──加载技能──→ 懂 TDD、懂代码评审、懂 commit 规范| 技能包 | ⭐ | 安装量 | 技能包介绍 | 怎么用 |
|---|---|---|---|---|
| mattpocock/skills | 159k | 6.9M | 个人 .claude 目录开源版,低仪式感高实用。含 grill-me(代码评审)、tdd、implement、to-prd、code-review 等 20+ 工程技能 | 主力——全装 |
| addyosmani/agent-skills | 71k | 179k | 谷歌工程师出品,工程规范覆盖最广。含安全审计、CI/CD、性能分析、可观测、迁移等技能 | 补充——抽 security-and-hardening、ci-cd-and-automation、observability-and-instrumentation、performance-optimization、documentation-and-adrs、context-engineering(这些 mattpocock 没有) |
| anthropics/skills | 159k | 2.4M | Anthropic 官方技能仓,偏向创意/文档处理 | 参考——学 SKILL.md 标准格式 |
| multica-ai/andrej-karpathy-skills | 186k | — | 单文件 CLAUDE.md,按 Karpathy 观察改进 LLM 编码行为 | 可选——一条命令装上,不费事 |
| Egonex-AI/Understand-Anything | 70k | — | 把任意代码转成交互式知识图谱 | 按需——遇到陌生代码库时装 |
| safishamsi/graphify | 75k | — | 代码/文档目录转知识图谱 | 按需——大仓需要可视化时 |
| DietrichGebert/ponytail | 71k | — | 让 AI 像懒工程师,遏制过度生成 | 按需——Agent 写太多无用代码时 |
策略:一个主力 + 按需补充,不要全装。
# 第一步:装 mattpocock 打底(6.9M 安装量验证过的最好用主力)
opencode "安装 mattpocock/skills"
# 第二步:从 addyosmani 单独抽 mattpocock 没有的技能
opencode "安装 addyosmani/agent-skills 里的 security-and-hardening"
opencode "安装 addyosmani/agent-skills 里的 ci-cd-and-automation"
opencode "安装 addyosmani/agent-skills 里的 observability-and-instrumentation"
opencode "安装 addyosmani/agent-skills 里的 performance-optimization"
opencode "安装 addyosmani/agent-skills 里的 documentation-and-adrs"
opencode "安装 addyosmani/agent-skills 里的 context-engineering"
# 第三步:其他技能遇到场景再装
opencode "装一个帮我理解这个陌生代码库的技能"然后试:
opencode "对我的代码做一次 grill-me 评审"
opencode "用 TDD 方式给我的工具函数写测试"社区共识:mattpocock 做主力(低仪式感高实用)→ addyosmani 做补充(工程规范、安全审计)→ 其他按需。
以上都来自全景榜前 30 名。主力 1 个 + 按需 2-3 个就够了,装多了技能互相干扰反而不如不装。
Level 3:工具链 / MCP(第 2 周)
MCP 就是给 Agent 的"USB 接口"——插上什么工具,Agent 就能操作什么。这是最简单的概念之一,装好立刻见效。
Agent ──MCP──→ GitHub(提 Issue / review PR)
├──→ 浏览器(做 E2E 测试)
├──→ 数据库(查数据)
└──→ Figma(设计稿转代码)| # | MCP 工具 | ⭐ | 全景榜排名 | 用途 |
|---|---|---|---|---|
| 1 | punkpeye/awesome-mcp-servers | 90k | #15 | MCP server 精选清单,找现成工具先翻这里 |
| 2 | modelcontextprotocol/servers | 88k | #16 | MCP 官方参考实现合集,学怎么写 MCP server |
| 3 | ChromeDevTools/chrome-devtools-mcp | 45k | #45 | 浏览器调试、性能分析 |
| 4 | microsoft/playwright-mcp | 35k | #64 | Agent 控制浏览器做 E2E 测试 |
| 5 | github/github-mcp-server | 31k | #67 | Agent 直接操作 GitHub(Issues / PR / Code Review) |
| 6 | GLips/Figma-Context-MCP | 15k | #141 | 设计稿转代码 |
# 装一个试试
opencode "安装 GitHub MCP server,让我能通过你操作仓库"学习路径: 先翻 awesome-mcp-servers 看有什么现成的 → 读 modelcontextprotocol/servers 的源码学写法 → 装 github-mcp-server 开始用 → 用 fastmcp 写自己的。
# 自己写 MCP 最快方式
pip install fastmcp
fastmcp init my-tool参考库里的 MCP 生态开源项目 Top 100 排行榜 找更多。前三个 MCP 最有价值:GitHub + Playwright + 你自己写的那个。
Level 4:方法论(第 3-4 周)
从"聊天式开发"升级为规范驱动开发——让 Agent 先规划再执行,而不是直接写代码。
方法论 ≠ 工作流。 方法论是"该遵循什么原则"(如先写 spec、先规划再执行、TDD),工作流是把这套原则固化成 Agent 一步步执行的具体步骤编排。一个方法论可以派生出多条工作流——下表各框架的"核心思想"其实就是它把方法论落地成的工作流。
你提需求 → Agent 先出计划 → 你审计划 → 同意后再执行
↑
关键转变在这里| # | 框架 | ⭐ | 分类 | 核心思想 |
|---|---|---|---|---|
| 1 | obra/superpowers | 244k | 技能 | Socratic 需求反推 → 子 Agent 开发 → TDD → 2 轮评审。社区最大方法论框架 |
| 2 | github/spec-kit | 118k | 方法论 | GitHub 官方出品。Spec-Driven Development——先写 spec 再编码,spec/ 目录 + PRD 模板 + 阶段实现 |
| 3 | gsd-build/get-shit-done | 65k | 技能 | 轻量元提示 + 上下文工程 + 规范驱动开发系统。本库 GSD 的社区独立分支 |
| 4 | Yeachan-Heo/oh-my-claudecode | 37k | 编排 | 受 oh-my-zsh 启发的 Claude Code 多 Agent 编排——插件框架 + 并行执行 + 角色分工 |
| 5 | openai/symphony | 26k | 编排 | OpenAI 出品。把项目拆成隔离的自治实现单元,并行推进 |
| 6 | OthmanAdi/planning-with-files | 24k | 技能 | 基于文件的持久化规划——语境丢失也不丢进度,长任务场景利器 |
| 7 | SuperClaude-Org/SuperClaude_Framework | 23k | 技能 | 用命令/人格/方法论增强 CC 的配置框架。给 Claude Code 套方法论外骨骼 |
怎么选:
你想先写清楚 spec 再编码 → spec-kit(GitHub 官方)
你想最大程度放手 → superpowers(subagent-driven dev)
你想要标准化的阶段流程 → GSD(规范驱动开发)
你需要多个 Agent 分工 → oh-my-claudecode(多 Agent 编排)
你要并行拆任务 → symphony(隔离自治单元)
你怕 Agent 丢上下文 → planning-with-files(文件级持久规划)
你想给 CC 配方法论骨架 → SuperClaude_Framework建议路径:
# 先试 spec-kit(门槛最低,和传统开发习惯最像)
opencode "用 spec-kit 给这个项目加用户登录功能,先写 spec"
# 熟悉后试 superpowers
opencode "用 superpowers 方法论重构这个模块"
# 大任务用 GSD
opencode "用 GSD 方法论拆分这个功能并执行"
# 多任务并行用 oh-my-claudecode
opencode "用 oh-my-claudecode 同时修三个 bug"社区经验: 大多数人在 Level 4(方法论)会停下来——因为已经够用了。方法论的核心价值不是让 Agent 更强,而是让 Agent 不乱来。
以上全部来自全景榜(superpowers #1、GSD #28、oh-my-claudecode #55、symphony #89、planning-with-files #98、SuperClaude_Framework #104)。只有 spec-kit(118k⭐)不在全景榜中但值得收入。这些方法论之间不冲突——可以组合用。
Level 5:上下文工程(第 2 个月)
Agent 最大的瓶颈不是智商,是记不住——上下文窗口有限,项目一大它就丢三落四。
解决这个问题有两条路线,看你 Level 4 选了哪套方法论:
路线 A:独立工具 —— 给 Agent 外挂记忆/检索
你的项目 → 压缩 / 索引 / 记忆 → Agent 能"看见"整个项目| # | 工具 | ⭐ | 全景榜排名 | 分类 | 解决什么问题 |
|---|---|---|---|---|---|
| 1 | claude-mem | 85k | #18 | 记忆 | Agent 跨会话记住上下文 |
| 2 | repomix | 27k | #83 | 检索 | 整个仓库打包成单文件喂给 Agent |
| 3 | codebase-memory-mcp | 24k | #102 | 检索 | 大仓代码检索,不用把整个项目塞进去 |
| 4 | context-mode | 18k | #125 | 记忆 | 把工具输出压缩 98%,省 token |
| 5 | zilliztech/claude-context | 12k | #164 | 检索 | 语义级别的代码检索 |
# 典型场景:项目太大,Agent 开始忘记前面的内容
repomix --style markdown --output /tmp/context.md
# 然后把 /tmp/context.md 告诉 Agent路线 B:方法论内置 —— 方法论框架自带上下文方案
有些方法论把上下文工程作为一等特性内置在架构里,不需要额外装记忆/压缩工具:
| # | 方法论 | ⭐ | 全景榜排名 | 上下文方案 |
|---|---|---|---|---|
| 1 | obra/superpowers | 244k | #1 | 子 Agent 独立会话 + subagent-driven-development,每个子 Agent 从干净 200k 窗口开始 |
| 2 | gsd-core(GSD) | 65k | #28 | 三支柱之一就是 context engineering——STATE.md / CONTEXT.md 产物跨会话 + fresh-context subagent |
| 3 | Yeachan-Heo/oh-my-claudecode | 37k | #55 | 多 Agent 编排框架,每个 Agent 独立上下文 + 插件级生命周期管理 |
| 4 | openai/symphony | 26k | #89 | 任务拆成隔离自治单元,每个单元独立上下文,互不污染 |
| 5 | OthmanAdi/planning-with-files | 24k | #98 | task_plan.md / findings.md / progress.md 持久化在磁盘,明确声明让 agent 扛住 context loss、/clear 和崩溃 |
选哪条路:
你 Level 4 选了 superpowers → 不需要路线 A,subagent 机制已经解决
你 Level 4 选了 GSD → 不需要路线 A,context engineering 是内置特性
你 Level 4 选了 spec-kit → 路线 A 对你有用,spec-kit 不做上下文管理
你 Level 4 选了 oh-my-claudecode → 路线 A 对你有用
你没用方法论 → 路线 A,先试 repomix + claude-mem 就够了全景榜里
检索和记忆两类就是路线 A 会用到的工具。先试 repomix,不够再加别的。
Level 6:多智能体(第 3 个月)
当任务复杂到一个人搞不定时,你需要多个 Agent 分工协作。
一个项目经理 Agent ──拆任务──→ 前端 Agent
├──→ 后端 Agent
├──→ 测试 Agent
└──→ 运维 Agent| # | 框架 | ⭐ | 全景榜排名 | 适合场景 |
|---|---|---|---|---|
| 1 | agentscope | 27k | #78 | 分布式多 Agent,看得见每个 Agent 在干什么 |
| 2 | mastra-ai/mastra | 25k | #90 | TypeScript 全栈 Agent 框架 |
| 3 | openai/swarm | 22k | #114 | 学习多 Agent 编排原理(教学框架) |
| 4 | pydantic-ai | 18k | #125 | 类型安全的 Agent 框架,Python 生态首选 |
⚠️ 未核对——全景榜
编排分类项目较多,此表可能不全。
先学 swarm 理解概念,再用 pydantic-ai 写第一个多 Agent 应用。
Level 6 的完整清单看全景榜
编排分类。
Level 7:生产化(按需进入)
当你的 Agent 要从"自己用"变成"团队用":
| 关注点 | 工具 | ⭐ |
|---|---|---|
| 评测 — Agent 干得好不好? | deepeval | 17k |
| 可观测 — Agent 每一步在干什么? | tensorzero | 12k |
| 安全 — 装的技能有没有后门? | NVIDIA/SkillSpector | 12k |
| CI/CD — Agent 自动跑流水线 | cline 的 headless 模式或 opencode 的 SDK | — |
这个阶段不是必须的。 大多数个人开发者到 Level 4 就已经满足日常需求了。
路线总结
Level 0: 认知(半天)
Level 1: Claude Code / opencode(第 1 周)
Level 2: mattpocock(主力) → addyosmani(补充) → 按需(第 2 周)
Level 3: MCP — awesome-mcp-servers(90k) → modelcontextprotocol/servers(88k) → chrome-devtools-mcp(45k) → playwright-mcp(35k) → github-mcp-server(31k) → Figma-Context-MCP(15k)(第 2 周,很快)
───────────────────────────── Agent 专项结束
Level 4: 方法论 — superpowers(244k) → spec-kit(118k) → GSD(65k) → oh-my-claudecode(37k) → symphony(26k) → planning-with-files(24k) → SuperClaude_Framework(23k)(第 3-4 周)
───────────────────────────── 大多数人停在这里就够了
Level 5: 上下文 — 路线 A(独立工具) claude-mem(85k) → repomix(27k) → codebase-memory(24k) → context-mode(18k) → claude-context(12k) / 路线 B(方法论内置)(第 2 个月)
───────────────────────────── 以下是通用工程
Level 6: 多智能体 — agentscope(27k) → mastra(26k) → swarm(22k) → pydantic-ai(18k)(第 3 个月+)
Level 7: 生产化 — deepeval → tensorzero → SkillSpector(按需)关键原则:
- 不要跳级——Level 1 没跑通就不要碰 Level 4
- 不要贪多——每个 Level 选一个工具就够了
- 不要焦虑——大部分人在 Level 4 就已经能 2 倍速开发了
- 全景榜是这个路线的地图——走到哪一步,就去全景榜找对应的分类看
路线图里的每个项目都收录在全景榜中,按 star 排序可查详细数据。