学习路线
每条路线解决一类问题，按推荐顺序阅读。先选适合的环境，再沿相关步骤推进；个别步骤是可选分支，跳过不影响主线。
Codex：从安装到并行改动
先选环境完成安装与登录，再用一个小任务跑通权限、调试和项目上下文。Windows 是可选分支；不需要 Windows 时直接进入第一次任务，其余步骤按顺序阅读。
- 步骤
- 8
- 预计阅读
- 47 分钟
- Codex CLI 安装与登录：把第一条命令跑成只读验收 安装与登录：先确认能读不能写
- Windows 上的 Codex 环境：PowerShell、路径与换行符 Windows 环境：PowerShell 里的路径与换行
- Codex 权限：沙箱和审批是两个开关 权限与沙箱：先只读，再允许写入
- Codex CLI 第一次任务：从一条指令到测试验收 第一次任务：从指令到测试验收
- 让 Codex 修一个失败的测试：先复现，再限定改动 调试与测试：先复现失败再改代码
- Codex 项目上下文：AGENTS.md 写什么、config.toml 边界在哪 项目上下文：AGENTS.md 与配置边界
- Codex 非交互模式：结果、事件流和退出码要分开看 非交互运行：codex exec 与结构化输出
- 用 Git worktree 隔离两个 Codex 任务 worktree：隔开两条并行改动
Claude Code：把日常协作固定下来
从安装登录和项目记忆开始，依次进入日常工作流、权限、MCP 接入、独立评审与子代理；最后用故障排查把前面几步串起来。目标是一条每次都能复跑的协作路径。
- 步骤
- 8
- 预计阅读
- 47 分钟
- Claude Code 安装：按平台用原生安装器，再验证登录 安装与登录：验证命令可用
- CLAUDE.md 与规则文件：让 Claude Code 记住项目约定 项目记忆：CLAUDE.md 写什么
- Claude Code 日常流程：/init、plan 模式与一次干净的提交 工作流：从需求到一次干净的提交
- Claude Code 权限：模式、规则和拒绝的优先级 权限：允许范围与拒绝排查
- 把本地 stdio MCP 服务器接到 Claude Code 接入 MCP：检查工具是否真的可用
- Claude Code 代码评审：用 /review 和 hooks 做成独立工序 评审：把检查做成独立工序
- 给 Claude Code 加一个只读评审子代理 子代理：一个只读评审角色
- Claude Code 故障排查：先只读检查，再做最小修复 故障排查：按现象定位一层
MCP：把外部工具接进来
先弄清 host、client、server 与工具调用的边界，再判断该给多少权限；随后写一个只做一件事的 server，设计可维护的工具契约，并学会在协议层排错。
- 步骤
- 5
- 预计阅读
- 28 分钟
- MCP 架构概念：Host、Client、Server 与一次工具调用 概念：一次请求经过哪些角色
- MCP 安全边界：接一个 server 前要确认的四类权限 信任边界：接 server 前确认四类权限
- 写第一个 MCP Server：stdio 工具、Inspector 验证与注册 第一个 server：stdio、Inspector 与注册
- MCP 工具设计：把 count_words 的契约写窄 工具设计：名称、参数与业务错误
- MCP 协议排错：从进程启动到 tools/call 的四层定位 协议排错：启动、列表与调用分层定位
Skills：把重复做法变成可复用能力
从第一个可移植的 Skill 开始，判断哪些内容该留下、哪些该放到资源文件；再用三道闸门验证触发与内容，最后把团队共用的 Skill 纳入版本管理和交接。
- 步骤
- 5
- 预计阅读
- 34 分钟
- 第一个 Agent Skill：写一份可被发现的 change-summary 第一个 Skill：最小可触发结构
- Agent Skill 设计：什么该写成 Skill，什么不该 设计：什么该写成 Skill
- Skill 资源拆分：references、scripts 与按需加载 资源与脚本：把长内容移出正文
- Skill 验证：格式、触发与内容三道闸门 验证：格式、触发与内容三道闸门
- 团队 Skill 分发：版本固定、兼容矩阵与可回滚交接 团队流程：版本、兼容与回滚
Agent：从形态选择到可评估的循环
先判断问题该用固定 workflow 还是模型决策的 Agent，再约束工具契约、控制工具循环的失败预算；最后用追踪定位失败，用评估证明改动没有变坏。
- 步骤
- 5
- 预计阅读
- 35 分钟
- 固定工作流还是 Agent 循环：用发布说明分流做决策 形态选择：workflow 还是 Agent
- Agent 工具契约：输入、授权、错误与输出校验 工具契约：校验、授权与业务错误
- Agent 工具循环：重复调用、超时与失败预算怎么停 工具循环：观察、决策、行动的停止条件
- Agent 运行追踪：trace、run、step 与脱敏日志 运行追踪：把失败定位到具体一步
- Agent 评测：用可复跑的状态断言代替“看起来不错” 评估：用可复跑的断言衡量 Agent
自动化：把验证过的步骤接成流水线
先把检查放进 CI，再串联成有失败处理的流水线；随后收紧密钥与权限、处理重复事件和重试，最后在不可逆动作前保留人类检查点。
- 步骤
- 5
- 预计阅读
- 34 分钟
- 用 GitHub Actions 给静态站点加检查与构建门禁 CI 检查：先让验证自动跑起来
- Agent 自动化流水线：接入 CI 的四个环节 流水线：触发、准备、执行、复盘
- GitHub Actions 密钥边界：注入、脱敏与产物卫生 密钥与权限：作用域和泄露边界
- 自动化幂等：重复事件、状态机与有界重试 幂等与重试：重复事件不重复执行
- 自动化人工检查点：放在哪、怎么拦、失效会怎样 检查点：不可逆动作前停下来