主题
第1章 转型认知与岗位模型
1.1 问题场景
前端开发转向 AI Agent 工程时，最常见的问题不是“不会写代码”，而是不清楚企业到底愿意为哪类能力付费。 很多人会直接堆技术名词，但面试官更关心的是：你能不能把模型能力变成稳定业务结果，能不能从页面交付升级成目标交付。
转型初期最容易出现几个问题：
- 学了很多框架，但不知道和目标岗位有什么关系。
- 想做项目，却选不出最值得做的主项目。
- 简历和作品集里写了很多经历，但和 AI Agent 岗位对不上。
- 讲不清“我为什么适合这个方向、我还缺什么、下一步怎么补”。
所以这一章真正解决的问题，不是“告诉你有哪些岗位”，而是帮助你建立一张从当前能力到目标岗位的可执行迁移地图。
前端迁移提示
前端背景不是转型障碍，关键在于你能不能把已有经验重新组织成岗位价值：
- 组件与状态管理经验 -> Agent UI / UX、任务工作台和多步骤状态设计。
- 接口契约与联调经验 -> Tool Calling、Workflow 和系统集成能力。
- 工程化上线经验 -> 评测、监控、灰度、回滚和发布治理能力。
- 与产品、后端协作经验 -> 场景抽象、交付推进和岗位匹配表达能力。
转型路径图
最小项目目标
本章建议先完成一个“岗位能力地图最小闭环”项目，例如：
- 收集目标岗位 JD，提炼高频能力要求。
- 建立“能力项 -> 证据项 -> 行动项”映射表。
- 选定 1 条主项目主线，明确未来 12 周的证据沉淀节奏。
参考入口：
1.2 核心原理
这一章最关键的，不是了解“有哪些岗位名词”，而是理解一个转型决策如何真正落地：
- 目标岗位到底要求什么。
- 你当前能力中哪些可以迁移。
- 哪些是必须补齐的新能力。
- 未来 8 到 12 周应该围绕哪些证据去建设。
一、岗位本质：从页面交付升级为业务目标交付
前端岗位通常更强调：
- 页面体验。
- 交互与状态。
- 接口联调与工程效率。
AI Agent 工程岗位则更强调：
- 场景理解和业务抽象。
- 模型 / 检索 / 工具 / 工作流的组合设计。
- 评测、上线和治理能力。
- 可量化结果与闭环交付。
这不是“抛弃前端”，而是把前端能力升级为更完整的问题解决能力。
二、能力结构：至少分成三层
建议先把目标能力拆成三层：
- 基础层：模型调用、Prompt / Context、结构化输出。
- 系统层：RAG、Tool Calling、Workflow、Multi-Agent。
- 工程层：Eval、Observability、上线、权限、安全、作品集与表达。
如果只盯其中一层，例如只学模型调用或只学前端接入，转型会非常不稳。
三、证据优先：能力必须能被项目证明
企业不会仅凭“我学过这些概念”判断你适不适合岗位。 更有说服力的是：
- 你做过什么项目。
- 结果如何验证。
- 你负责了什么。
- 你如何复盘和改进。
因此转型路径的核心，不是知识点清单，而是证据材料清单。
四、主线优先：先选一个主项目，而不是同时铺太多方向
最常见的失败做法，是同时做很多很浅的项目。 更推荐的做法是先选一条主线，例如：
- 企业知识库问答 Agent。
- 浏览器 / 办公自动化 Agent。
- 多步骤业务工作流 Agent。
然后围绕这条主线逐步补：
- 模型调用。
- RAG。
- Workflow。
- Eval。
- 监控与上线。
- 作品集与面试表达。
五、节奏感：转型需要有阶段目标
如果没有时间节奏，转型很容易停留在“学了很多、产出很少”。 这也是为什么仓库里同时提供：
因为真正有效的转型，应该是按周推进、持续沉淀证据，而不是临近投递才临时拼材料。
1.3 实操步骤
推荐做法不是马上开始写代码，而是先把“岗位 -> 能力 -> 项目 -> 证据”这条路径画清楚。 先让方向对，再做投入，效率会高很多。
步骤 1：收集 20 条目标岗位 JD
建议尽量覆盖：
- 目标城市或地区。
- 不同公司规模。
- 不同侧重点岗位。
然后提炼高频关键词，例如：
- RAG。
- Tool Calling。
- Workflow。
- Eval。
- Observability。
- Agent UI / UX。
步骤 2：建立能力差距表
建议至少分成三类：
- 已具备：前端已有经验可直接迁移。
- 需补齐：未来 4 到 12 周内必须补的能力。
- 暂不优先：不是当前主线重点的能力。
参考入口：
docs/examples/assets/samples/chapter-01-role-gap-map.json
步骤 3：选定主项目主线
从岗位高频要求里选一个最值得做的方向，明确：
- 服务谁。
- 解决什么问题。
- 怎么验证效果。
- 为什么对目标岗位有价值。
步骤 4：定义证据材料清单
建议一开始就想清楚后面要沉淀什么：
- 样本输入输出。
- 评测结果。
- 截图。
- 架构图。
- 项目卡片。
- 面试讲述稿。
步骤 5：制定 12 周节奏
按模块拆开推进：
- 第 1-3 章：单 Agent。
- 第 4-7 章：RAG、Workflow、多 Agent。
- 第 8-10 章：Eval、上线、安全。
- 第 11-12 章：作品集和面试表达。
步骤 6：同步开始简历和自我介绍整理
这一步不要留到最后。 越早整理：
- 越容易发现项目证据缺口。
- 越容易校正岗位方向。
建议直接参考：
- 简历与自我介绍模板
docs/examples/assets/screenshots/README.mddocs/examples/assets/diagrams/chapter-01-role-map.svg
1.4 常见坑
坑 1：只学框架，不做业务映射
这样很容易“知识很多，但岗位不认”。
坑 2：过早追求复杂架构
基础单 Agent、RAG、评测都还没打稳就直接上多 Agent，往往会把自己绕进去。
坑 3：没有指标意识
如果讲不清“做完后提升了什么”，项目价值就会很弱。
坑 4：没有主项目主线
项目太散、太碎，最终无法形成作品集和面试叙事。
坑 5：转型表达里把前端背景完全抹掉
这样反而失去差异化优势。
坑 6：只做学习，不沉淀证据
没有评测、截图、项目卡片和复盘，很难形成岗位竞争力。
1.5 验证方式
这一章做完后，不应只看“方向是不是听起来不错”，而要看你是否真正形成了可执行的转型路线。
一、岗位理解是否清晰
- 你是否能说出目标岗位最常见的能力要求。
- 你是否知道哪些是高频硬要求，哪些是加分项。
二、能力差距是否可执行
- 你是否把能力分成已具备 / 待补齐 / 暂不优先。
- 你是否知道接下来 4 到 12 周重点补什么。
三、主项目是否明确
- 是否已经选定 1 条主项目主线。
- 是否定义了最小业务目标和验证指标。
四、证据材料是否有规划
- 是否知道后续要沉淀哪些截图、结果样本、评测和项目卡片。
- 是否已经有最小样本结构。
五、表达是否站得住
- 能否用 2 分钟讲清为什么转型、为什么选这个方向、下一步怎么补齐。
六、证据材料
- 能力差距样本：
docs/examples/assets/samples/chapter-01-role-gap-map.json - 截图清单：
docs/examples/assets/screenshots/README.md - 图解配图：
docs/examples/assets/diagrams/chapter-01-role-map.svg - 周计划入口
1.6 面试表达
我从前端转向智能体工程时，先做了岗位能力拆解，再围绕一个主项目主线持续迭代证据材料。 我关注的不只是功能能跑，而是如何用项目、指标和复盘证明我已经从“页面交付”升级到了“业务目标交付”。
实战案例：岗位能力地图构建
- 背景：转型初期投递反馈少，不清楚能力缺口到底在哪里。
- 动作：拆解目标岗位 JD，建立“能力项 - 证据项 - 行动项”映射表，并选定主项目主线。
- 结果：学习路径更聚焦，作品集和面试准备效率显著提升。
推荐答题框架
如果面试官问“你为什么这样规划转型路径”，可以按下面顺序回答：
- 先讲目标岗位的高频能力要求。
- 再讲前端经验中哪些可迁移。
- 再讲你为什么选这个主项目主线。
- 最后讲你如何通过证据材料和 12 周节奏逐步补齐能力。
1.7 练习任务
- 收集 20 条目标岗位 JD，并提炼高频能力关键词。
- 建立个人能力差距表，至少分为“已具备 / 待补齐 / 暂不优先”三类。
- 选定 1 条主项目主线，并写出 3 条可量化目标。
- 列出未来 12 周你准备沉淀的证据材料清单。
- 基于
docs/examples/assets/samples/chapter-01-role-gap-map.json，整理出属于你的第一版转型能力地图。
1.8 验收清单
- 任务完成率 >= 85%
- 关键指标达标率 >= 90%
- 异常场景通过率 >= 90%
- 至少完成 1 份岗位能力差距表和 1 条主项目主线定义。
- 至少保留 1 份转型能力地图样本、1 份周计划入口和 1 组后续证据清单。
- 至少能用 2 分钟讲清楚“为什么你的转型路径不是泛学技术，而是岗位对齐后的系统规划”。