← 返回博客
作者:Harness Academy

老程序员 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 CodeAnthropic 官方产品,npm i -g @anthropic/claude-code最先推动终端编码 agent 概念的产品,社区最活跃
opencode181knpm i -g opencode-ai开源首选,中文 README,社区最大
openai/codex95knpm i -g @openai/codexOpenAI 官方终端 agent,Codex 生态

第一周的任务:

  1. opencode "给我写一个 Python CLI 工具,读 CSV 做统计"
  2. 看它怎么读你的项目、怎么写代码、怎么跑命令
  3. 学会这个循环:说清楚需求 → 看它计划 → approve → 看结果 → 不满意就回退重来
  4. 试第二个项目:"把这个 Express 项目加上 TypeScript 类型定义"

这个阶段不需要任何技能、配置、方法论。 老程序员最擅长的是"先跑起来再说"。

唯一要练的"提示词"能力:把需求讲清楚。 不是玩措辞技巧,而是像给一个不熟悉你项目的新同事派活——四件事说全:

  • 背景:这是什么项目、改哪块、为什么改
  • 约束:用什么语言/框架/版本、要遵守哪些既有规范、不许动什么
  • 例子:贴一段现有代码当范式,或给个输入/输出样例
  • 验收标准:怎么算做完(跑通哪个测试、满足什么行为)

需求越糊,Agent 越会自由发挥、越容易跑偏。这一条贯穿后面所有 Level,且比任何技巧都值钱。


Level 2:技能(第 2 周)

现在 Agent 能写代码了,但它不懂你的工程标准。技能就是「给 Agent 看的说明书」。

你的 Agent ──加载技能──→ 懂 TDD、懂代码评审、懂 commit 规范
技能包安装量技能包介绍怎么用
mattpocock/skills159k6.9M个人 .claude 目录开源版,低仪式感高实用。含 grill-me(代码评审)、tddimplementto-prdcode-review 等 20+ 工程技能主力——全装
addyosmani/agent-skills71k179k谷歌工程师出品,工程规范覆盖最广。含安全审计、CI/CD、性能分析、可观测、迁移等技能补充——抽 security-and-hardeningci-cd-and-automationobservability-and-instrumentationperformance-optimizationdocumentation-and-adrscontext-engineering(这些 mattpocock 没有)
anthropics/skills159k2.4MAnthropic 官方技能仓,偏向创意/文档处理参考——学 SKILL.md 标准格式
multica-ai/andrej-karpathy-skills186k单文件 CLAUDE.md,按 Karpathy 观察改进 LLM 编码行为可选——一条命令装上,不费事
Egonex-AI/Understand-Anything70k把任意代码转成交互式知识图谱按需——遇到陌生代码库时装
safishamsi/graphify75k代码/文档目录转知识图谱按需——大仓需要可视化时
DietrichGebert/ponytail71k让 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 工具全景榜排名用途
1punkpeye/awesome-mcp-servers90k#15MCP server 精选清单,找现成工具先翻这里
2modelcontextprotocol/servers88k#16MCP 官方参考实现合集,学怎么写 MCP server
3ChromeDevTools/chrome-devtools-mcp45k#45浏览器调试、性能分析
4microsoft/playwright-mcp35k#64Agent 控制浏览器做 E2E 测试
5github/github-mcp-server31k#67Agent 直接操作 GitHub(Issues / PR / Code Review)
6GLips/Figma-Context-MCP15k#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 先出计划 → 你审计划 → 同意后再执行

      关键转变在这里
#框架分类核心思想
1obra/superpowers244k技能Socratic 需求反推 → 子 Agent 开发 → TDD → 2 轮评审。社区最大方法论框架
2github/spec-kit118k方法论GitHub 官方出品。Spec-Driven Development——先写 spec 再编码,spec/ 目录 + PRD 模板 + 阶段实现
3gsd-build/get-shit-done65k技能轻量元提示 + 上下文工程 + 规范驱动开发系统。本库 GSD 的社区独立分支
4Yeachan-Heo/oh-my-claudecode37k编排受 oh-my-zsh 启发的 Claude Code 多 Agent 编排——插件框架 + 并行执行 + 角色分工
5openai/symphony26k编排OpenAI 出品。把项目拆成隔离的自治实现单元,并行推进
6OthmanAdi/planning-with-files24k技能基于文件的持久化规划——语境丢失也不丢进度,长任务场景利器
7SuperClaude-Org/SuperClaude_Framework23k技能用命令/人格/方法论增强 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 能"看见"整个项目
#工具全景榜排名分类解决什么问题
1claude-mem85k#18记忆Agent 跨会话记住上下文
2repomix27k#83检索整个仓库打包成单文件喂给 Agent
3codebase-memory-mcp24k#102检索大仓代码检索,不用把整个项目塞进去
4context-mode18k#125记忆把工具输出压缩 98%,省 token
5zilliztech/claude-context12k#164检索语义级别的代码检索
# 典型场景:项目太大,Agent 开始忘记前面的内容
repomix --style markdown --output /tmp/context.md
# 然后把 /tmp/context.md 告诉 Agent

路线 B:方法论内置 —— 方法论框架自带上下文方案

有些方法论把上下文工程作为一等特性内置在架构里,不需要额外装记忆/压缩工具:

#方法论全景榜排名上下文方案
1obra/superpowers244k#1子 Agent 独立会话 + subagent-driven-development,每个子 Agent 从干净 200k 窗口开始
2gsd-core(GSD)65k#28三支柱之一就是 context engineering——STATE.md / CONTEXT.md 产物跨会话 + fresh-context subagent
3Yeachan-Heo/oh-my-claudecode37k#55多 Agent 编排框架,每个 Agent 独立上下文 + 插件级生命周期管理
4openai/symphony26k#89任务拆成隔离自治单元,每个单元独立上下文,互不污染
5OthmanAdi/planning-with-files24k#98task_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
#框架全景榜排名适合场景
1agentscope27k#78分布式多 Agent,看得见每个 Agent 在干什么
2mastra-ai/mastra25k#90TypeScript 全栈 Agent 框架
3openai/swarm22k#114学习多 Agent 编排原理(教学框架)
4pydantic-ai18k#125类型安全的 Agent 框架,Python 生态首选

⚠️ 未核对——全景榜 编排 分类项目较多,此表可能不全。

先学 swarm 理解概念,再用 pydantic-ai 写第一个多 Agent 应用。

Level 6 的完整清单看全景榜 编排 分类。


Level 7:生产化(按需进入)

当你的 Agent 要从"自己用"变成"团队用":

关注点工具
评测 — Agent 干得好不好?deepeval17k
可观测 — Agent 每一步在干什么?tensorzero12k
安全 — 装的技能有没有后门?NVIDIA/SkillSpector12k
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 排序可查详细数据。

← 返回博客