文档教程【免费下载链接】learn-opencodeOpenCode 中文实战课源码与内容仓库一课一页覆盖入门到实战工作流。项目地址https://gitcode.com/gh_mirrors/le/learn-opencode点击查看免费下载用OpenCode 写代码你是否遇到过这种情况AI 一上来就动手改文件结果改错了方向还得反复撤销重来答案就藏在本教程仓库learn-opencode的核心工作流里——Plan 规划模式负责先想清楚Build 执行模式负责再动手做。本文带你用Tab 键一键切换这两种模式搭建一套先分析、后执行的 AI 编程工作流让 AI 干活不跑偏。 为什么 AI 会跑偏大多数新手用 AI 编程工具的通病是一个模式走天下。AI 还没理解你的意图就直接改了 3 个文件想让 AI 先分析却不知道从哪里下手按住它复杂任务做到一半不知道 AI 执行到哪一步了。其实问题不在模型不够聪明而在于你没用对模式。OpenCode 内置了两个主要助手Primary Agent专门解决这个矛盾。 Plan 与 Build 双模式一分钟搞懂OpenCode 默认提供两个可直接对话的主助手用Tab键即可来回切换模式定位权限适合场景Plan规划者只读分析禁止修改源代码分析结构、方案设计、理解陌生代码库Build执行者读写全开所有工具可用写新功能、修 Bug、重构、创建/修改文件 Plan 模式只动脑子不动手Plan Agent 采用权限隔离机制保护你的代码✅ 可以读文件、搜索代码、列出目录✅ 只能编辑.opencode/plans/*.md计划文件规划成果会落盘成 Markdown❌ 禁止编辑任何项目源代码。简单说你让 Plan 改一下这个函数它也会乖乖不改——这是设计如此不是 bug。 Build 模式放心动手边做边看Build Agent 默认全权限可以创建文件、修改文件、执行 Shell 命令。适合在方案已经明确后让 AI 快速落地实现。一句口诀记牢不确定 → 先用 Plan确定了 → 直接 Build。⚡ Tab 一键切换最快模式切换方法切换成本几乎为零只需两个动作看状态栏界面右侧状态栏会实时显示当前是Plan还是Build按Tab在两个模式之间来回切换ShiftTab反向切换。 如果你更习惯别的键位还可以在配置文件中自定义agent_cycle快捷键详见 docs/5-advanced/06b-keybinds.md。️ 场景速查表什么时候该用哪个模式你的需求推荐模式原因写新功能Build需求明确直接开发效率最高修简单 BugBuild影响范围小快速迭代重构核心模块先 Plan 后 Build先摸清影响面再动手更安全学习陌生代码库Plan只读探索零风险不确定改动影响Plan分析完再决定动不动手团队协作任务先 Plan 后 Build计划可审核、执行可追溯代码审查Plan只读分析不产生任何变更 高效搭配工作流三步先想后做第 1 步Plan 分析约 2 分钟切到 Plan 模式用引用文件发起分析例如src/main.ts 分析这个文件的结构列出所有函数和它们的作用AI 会用read、grep等只读工具拆解代码产出分析报告——你的一个文件都没被改动。第 2 步人工确认关键花 30 秒扫一眼分析结论方向对不对影响面是不是你想的范围这一步是防止跑偏的最重要闸门。第 3 步Build 执行秒级落地按Tab切回 Build 模式下达执行指令给 src/main.ts 添加详细的 JSDoc 注释AI 会真正修改文件你可以逐项审核不满意就用/undo一键撤销。 实战场景重构核心模块怎么组合拳以重构用户认证模块为例把双模式和 TODO 进度跟踪结合起来Plan 模式分析 auth 模块的所有调用方评估重构影响面→ AI 输出影响清单 计划文件人工审核确认计划无误后切 BuildBuild 模式按 .opencode/plans 里的计划重构用 TODO 跟踪进度→ AI 创建任务清单逐项执行并实时更新状态✅ 已完成 / 进行中 / ⏳ 待处理。中途离开回来直接问一句当前进度怎么样AI 会汇报每一项任务的状态。这套测试先行 → Plan 分析 → Build 小步重构 → 验证的完整打法可以参考 docs/4-scenarios/coder-refactor.md。 三个进阶技巧让工作流更丝滑计划文件自动落盘Plan 模式产出的计划会存到项目.opencode/plans/有 Git 时或全局目录随时可以打开复查、甚至随仓库共享给队友AI 自动切换模式实验功能开启实验模式后AI 可以调用plan_enter/plan_exit工具主动申请切换你只需点确认全程不用碰 Tab组合子 Agent 专家团队Plan 定方向后Build 执行时还能用explore快速摸清项目结构、用general做复杂调研详见 docs/3-workflow/02-agents.md。⚠️ 避坑指南新手最常踩的 3 个坑现象原因解决办法让 AI 改文件却没改还停留在 Plan 模式按 Tab 切到 BuildAI 改错了不该改的文件Build 权限全开/undo撤销下次先 Plan 分析Plan 模式不让编辑代码权限隔离设计如此属正常行为切 Build 再执行✅ 小结Plan 只读分析Build 读写执行Tab一键切换黄金工作流Plan 分析 → 人工确认 → Build 执行 → /undo 兜底复杂任务加一句用 TODO 跟踪进度执行过程全程可见完整课程见 docs/3-workflow/index.md核心知识点出自 docs/3-workflow/01-plan-build.md。掌握先想后做你的 AI 编程效率和质量都会再上一个台阶——去打开一个项目按Tab试起来吧 赞分享文档教程【免费下载链接】learn-opencodeOpenCode 中文实战课源码与内容仓库一课一页覆盖入门到实战工作流。项目地址https://gitcode.com/gh_mirrors/le/learn-opencode点击查看免费下载相关推荐learn-claude-code s05 深解TodoWrite 计划工具让 Agent「先计划再执行」而不跑偏learn claude code s05 深解TodoWrite 计划工具让 Agent「先计划再执行」而不跑偏 本文基于 learn claude co示例工程AI Agent人工智能Claude Code 如何用 /plan 规划模式先出实施计划再执行claude-howto 的激活方式与计划修改Claude Code 如何用 /plan 规划模式先出实施计划再执行claude howto 的激活方式与计划修改 面对跨多文件的重构、新系统功能实现或数据教程文档Crystal Grafast深度指南Operation Plan规划与执行引擎是如何工作的Crystal Grafast深度指南Operation Plan规划与执行引擎是如何工作的 Grafast 是 Crystal 单体仓库中的 GraphQL后端API网关创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 learn-opencode 高效工作流：Plan 规划 + Build 执行双模式如何搭配，让 AI 先想后做不跑偏
文档教程【免费下载链接】learn-opencodeOpenCode 中文实战课源码与内容仓库一课一页覆盖入门到实战工作流。项目地址https://gitcode.com/gh_mirrors/le/learn-opencode点击查看免费下载用OpenCode 写代码你是否遇到过这种情况AI 一上来就动手改文件结果改错了方向还得反复撤销重来答案就藏在本教程仓库learn-opencode的核心工作流里——Plan 规划模式负责先想清楚Build 执行模式负责再动手做。本文带你用Tab 键一键切换这两种模式搭建一套先分析、后执行的 AI 编程工作流让 AI 干活不跑偏。 为什么 AI 会跑偏大多数新手用 AI 编程工具的通病是一个模式走天下。AI 还没理解你的意图就直接改了 3 个文件想让 AI 先分析却不知道从哪里下手按住它复杂任务做到一半不知道 AI 执行到哪一步了。其实问题不在模型不够聪明而在于你没用对模式。OpenCode 内置了两个主要助手Primary Agent专门解决这个矛盾。 Plan 与 Build 双模式一分钟搞懂OpenCode 默认提供两个可直接对话的主助手用Tab键即可来回切换模式定位权限适合场景Plan规划者只读分析禁止修改源代码分析结构、方案设计、理解陌生代码库Build执行者读写全开所有工具可用写新功能、修 Bug、重构、创建/修改文件 Plan 模式只动脑子不动手Plan Agent 采用权限隔离机制保护你的代码✅ 可以读文件、搜索代码、列出目录✅ 只能编辑.opencode/plans/*.md计划文件规划成果会落盘成 Markdown❌ 禁止编辑任何项目源代码。简单说你让 Plan 改一下这个函数它也会乖乖不改——这是设计如此不是 bug。 Build 模式放心动手边做边看Build Agent 默认全权限可以创建文件、修改文件、执行 Shell 命令。适合在方案已经明确后让 AI 快速落地实现。一句口诀记牢不确定 → 先用 Plan确定了 → 直接 Build。⚡ Tab 一键切换最快模式切换方法切换成本几乎为零只需两个动作看状态栏界面右侧状态栏会实时显示当前是Plan还是Build按Tab在两个模式之间来回切换ShiftTab反向切换。 如果你更习惯别的键位还可以在配置文件中自定义agent_cycle快捷键详见 docs/5-advanced/06b-keybinds.md。️ 场景速查表什么时候该用哪个模式你的需求推荐模式原因写新功能Build需求明确直接开发效率最高修简单 BugBuild影响范围小快速迭代重构核心模块先 Plan 后 Build先摸清影响面再动手更安全学习陌生代码库Plan只读探索零风险不确定改动影响Plan分析完再决定动不动手团队协作任务先 Plan 后 Build计划可审核、执行可追溯代码审查Plan只读分析不产生任何变更 高效搭配工作流三步先想后做第 1 步Plan 分析约 2 分钟切到 Plan 模式用引用文件发起分析例如src/main.ts 分析这个文件的结构列出所有函数和它们的作用AI 会用read、grep等只读工具拆解代码产出分析报告——你的一个文件都没被改动。第 2 步人工确认关键花 30 秒扫一眼分析结论方向对不对影响面是不是你想的范围这一步是防止跑偏的最重要闸门。第 3 步Build 执行秒级落地按Tab切回 Build 模式下达执行指令给 src/main.ts 添加详细的 JSDoc 注释AI 会真正修改文件你可以逐项审核不满意就用/undo一键撤销。 实战场景重构核心模块怎么组合拳以重构用户认证模块为例把双模式和 TODO 进度跟踪结合起来Plan 模式分析 auth 模块的所有调用方评估重构影响面→ AI 输出影响清单 计划文件人工审核确认计划无误后切 BuildBuild 模式按 .opencode/plans 里的计划重构用 TODO 跟踪进度→ AI 创建任务清单逐项执行并实时更新状态✅ 已完成 / 进行中 / ⏳ 待处理。中途离开回来直接问一句当前进度怎么样AI 会汇报每一项任务的状态。这套测试先行 → Plan 分析 → Build 小步重构 → 验证的完整打法可以参考 docs/4-scenarios/coder-refactor.md。 三个进阶技巧让工作流更丝滑计划文件自动落盘Plan 模式产出的计划会存到项目.opencode/plans/有 Git 时或全局目录随时可以打开复查、甚至随仓库共享给队友AI 自动切换模式实验功能开启实验模式后AI 可以调用plan_enter/plan_exit工具主动申请切换你只需点确认全程不用碰 Tab组合子 Agent 专家团队Plan 定方向后Build 执行时还能用explore快速摸清项目结构、用general做复杂调研详见 docs/3-workflow/02-agents.md。⚠️ 避坑指南新手最常踩的 3 个坑现象原因解决办法让 AI 改文件却没改还停留在 Plan 模式按 Tab 切到 BuildAI 改错了不该改的文件Build 权限全开/undo撤销下次先 Plan 分析Plan 模式不让编辑代码权限隔离设计如此属正常行为切 Build 再执行✅ 小结Plan 只读分析Build 读写执行Tab一键切换黄金工作流Plan 分析 → 人工确认 → Build 执行 → /undo 兜底复杂任务加一句用 TODO 跟踪进度执行过程全程可见完整课程见 docs/3-workflow/index.md核心知识点出自 docs/3-workflow/01-plan-build.md。掌握先想后做你的 AI 编程效率和质量都会再上一个台阶——去打开一个项目按Tab试起来吧 赞分享文档教程【免费下载链接】learn-opencodeOpenCode 中文实战课源码与内容仓库一课一页覆盖入门到实战工作流。项目地址https://gitcode.com/gh_mirrors/le/learn-opencode点击查看免费下载相关推荐learn-claude-code s05 深解TodoWrite 计划工具让 Agent「先计划再执行」而不跑偏learn claude code s05 深解TodoWrite 计划工具让 Agent「先计划再执行」而不跑偏 本文基于 learn claude co示例工程AI Agent人工智能Claude Code 如何用 /plan 规划模式先出实施计划再执行claude-howto 的激活方式与计划修改Claude Code 如何用 /plan 规划模式先出实施计划再执行claude howto 的激活方式与计划修改 面对跨多文件的重构、新系统功能实现或数据教程文档Crystal Grafast深度指南Operation Plan规划与执行引擎是如何工作的Crystal Grafast深度指南Operation Plan规划与执行引擎是如何工作的 Grafast 是 Crystal 单体仓库中的 GraphQL后端API网关创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考