工具匹配与选型
前端团队在 AI 协作上最常见的误区,不是工具太少,而是任务形状不同却仍然用同一种入口。页面还原、组件重构、浏览器复现、设计系统治理、内容页扩写,这些任务对上下文的要求完全不同。
工具入口决策图
先看这张图,再看后面的表格。它把前端最常见的四类任务直接收成“入口 + 证据包”的组合,适合拿来做带教或 task kickoff。
一个先行结论
- 设计稿落地优先“设计上下文 + 终端或执行栈”,不要只靠文本。
- 浏览器问题优先“真实页面 + 录屏 + 最小 patch”,不要只看源码。
- 共享组件或设计系统重构优先“计划 + 目录边界 + 验证闭环”。
- 文档和规范类任务优先“仓库文本结构 + 链接校验 + build 验证”。
- issue 和验收条件已经很清楚时,再考虑平台型入口,不要反过来让平台替你补上下文。
按任务形状选工具
| 任务形状 | 更适合的入口 | 代表工具 / 先读页面 | 为什么 | 最少要交什么证据 | 推荐搭配 |
|---|---|---|---|---|---|
| 设计稿转页面骨架 | 终端入口或执行栈 + Figma 上下文 | Claude Code、OpenAI Codex、VS Code Agents | 需要同时读代码、设计输入和 token | 关键断点截图、节点说明、实现范围 | 设计到代码、Skills 与 MCP |
| 小步 UI 修复 | 终端入口 | Claude Code、Gemini CLI | 适合快速读文件、改局部、跑最小验证 | 变更范围、最小验证命令、前后截图 | 质量门禁 |
| 页面交互 bug 复现 | 浏览器能力 + 终端入口 | 浏览器能力、Cursor、Claude Code | 先在真实页面里证明问题,再回源码修复 | 复现步骤、录屏、修复后 smoke path | 测试与交付 |
| 组件库 / 设计系统重构 | 执行栈或更计划化入口 | OpenAI Codex、VS Code Agents、Windsurf | 需要跨目录推进并保留阶段验证 | 计划、受影响页面列表、断点截图、风险说明 | 仓库结构 |
| 长文档与训练资产扩写 | 终端入口 | Claude Code、Gemini CLI | 更适合大规模文本重组、链接更新与 build 校验 | 变更摘要、链接检查、build 结果 | 规则与规范文档 |
| issue 已很清楚且目标是 draft PR | 平台型入口 | GitHub Copilot | 适合直接衔接任务系统与 review 流程 | issue 链接、验收项、draft PR 说明 | 工作流教程首页 |
| 多个低耦合 lane 并行推进 | 执行栈或终端入口 + worktree | OpenAI Codex、Claude Code | 需要 owner 控边界并把 lane 结果重新收口 | lane 列表、owner 说明、统一验证结果 | Parallel Worktrees / Multi-Agent |
对前端最值钱的入口组合
设计到代码
- 设计输入:Figma 或等价设计上下文
- 实现主入口:终端入口或执行栈
- 验证:浏览器截图、必要时 Playwright
- 什么时候升级:如果组件抽取、token 回写、多个页面共用骨架同时发生,先补计划再推进
浏览器问题定位
- 复现主入口:浏览器能力
- 修复主入口:终端入口
- 收口:截图、录屏、最小 smoke path
- 不要跳过:先证明问题发生在哪个断点、哪个状态、哪个浏览器上下文,再回源码
设计系统或共享组件治理
- 计划与拆步:更适合保留计划的入口
- 代码推进:终端或执行栈
- 验证:受影响页面列表、断点截图、交互录屏
文档与规范补强
- 发现问题:终端入口先读现有 docs、索引页和相邻页面
- 改稿:终端入口持续补结构、链接和模板资产
- 收口:
npm run build、相关页跳转检查、变更摘要
不同入口最少要交什么证据
| 入口类型 | 最少证据 | 为什么不能省 |
|---|---|---|
| 终端入口 | 命令结果、受影响文件、最小截图或 diff 摘要 | 否则 reviewer 只能靠代码猜 UI 或行为变化 |
| 浏览器入口 | 复现步骤、录屏、修复后截图 | 否则无法证明修掉的是用户真正看到的问题 |
| 执行栈 / 计划化入口 | 计划、阶段产物、最终验证结果 | 否则跨目录改动会在中途失控 |
| 平台型入口 | issue 链接、验收项、draft PR 说明 | 否则平台只是在搬运模糊任务 |
| 文档补强任务 | 链接更新说明、相关页联动、build 结果 | 否则内容可能局部变厚但导航关系变差 |
工具选择要和 workflow 一起看
| 任务形状 | 更顺的入口组合 | 更适合配的 workflow |
|---|---|---|
| 小步前端修复 | 终端入口 | Terminal-First Repo Pairing |
| 中型 bugfix / refactor | 终端或执行栈 | Bugfix / Refactor / Test |
| 需要计划和阶段交付的重构 | 执行栈或控制面 | Spec-First |
| 本地 discovery 后后台继续执行 | 控制面 + 执行栈 | Local -> Background -> Cloud |
| issue 很清楚并要接 到 PR | 平台型入口 | Issue -> Draft PR |
前端团队常见误选
误选一:设计任务不用设计上下文
结果通常是:
- 只会产出“看起来像”的页面。
- 组件边界和 token 映射靠猜。
- review 时才发现状态和断点全漏。
误选二:浏览器问题只在代码里推理
这会导致你修的不是用户真正看到的问题,而是源码里最显眼的一段问题。
误选三:共享组件重构不用计划
短期看像是提速,长期看最容易把共享层改成“任何页面都能塞东西的地方”。
误选四:文档和规则任务还走“页面实现式”入口
这会让你把结构治理问题误当成单页写作问题,最后正文变长了,但目录关系、模板资产和站内跳转反而更乱。
前端训练建议
| 阶段 | 默认入口 | 目标 |
|---|---|---|
| 入门阶段 | 终端入口 | 先学会在仓库里读文件、改局部、跑验证 |
| 页面实现阶段 | 终端或执行栈 + Figma | 先学会把设计输入和代码边界接起来 |
| 浏览器验证阶段 | 浏览器 + 终端 | 先学会用真实页面复现和收口 |
| 共享层治理阶段 | 计划化入口 + 终端 | 先学会拆步、控范围、交证据 |
| 文档与机制阶段 | 终端入口 + build 验证 | 先学会改结构、保链接、交变更摘要 |
工具入口案例地图
如果只看上面的工具表,读者仍然可能停在“知道有哪些入口”。更有效的做法是直接把入口类型映射到真实交接链:
| 任务形状 | 先看哪篇案例 | 为什么值得搭配本页 |
|---|---|---|
| 小步 bugfix 或局部 UI 修复 | Claude Code Bugfix 闭环案例 | 最适合看终端入口如何做最小修复、最小验证和快速收口 |
| 本地 discovery 后,再转长执行段 | VS Code Agents 本地到后台交接案例 | 最适合看控制面与执行栈怎么分工,而不是混在一次对话里 |
| issue 和验收条件已经清楚,重点是尽快形成 draft PR | GitHub Copilot Draft PR 交接案例 | 适合看平台型入口什么时候真正比终端更顺 |
| 多 lane 并行推进,最后统一 owner 收口 | Cline 并行 Worktree 收口案例 | 适合看终端入口和 worktree 组合什么时候优于单线程推进 |
读这些案例时,建议重点看四件事:
- 为什么这个任务先选这个入口,而不是团队最熟的那个入口。
- 入口切换发生在任务哪一段,是 discovery、执行还是交付。
- 交付证据是否和入口选择匹配,比如浏览器入口必须有录屏,文档入口必须有 build 结果。
- 是否存在“本来该升级入口,却一直硬扛在单一入口里”的信号。
入口选择的媒体联动表
这页最适合用于 kickoff 或带练前的入口判断。为了避免只停在概念层,建议直接给团队下面这种“视频 + 案例 + workflow + 证据”组合:
| 任务形状 | 先看哪个视频 | 再看哪篇案例 | 接回哪个 workflow | 最少要交什么证据 |
|---|---|---|---|---|
| 设计稿落地 | Claude Code + Figma 工作流 | VS Code Agents 本地到后台交接案例 | Local -> Background -> Cloud | 设计节点说明、断点截图、brief |
| 小步 UI 修复或浏览器 bug | Claude Code + Playwright 浏览器自动化 | Claude Code Bugfix 闭环案例 | Bugfix / Refactor / Test | 复现步骤、录屏、修复后 smoke path |
| 组件或共享层重构 | 使用 OpenAI Codex 构建精美前端界面 | OpenAI Codex 重构与验证案例 | Spec-First | 计划、影响面清单、阶段验证 |
| 仓库结构或 lane 收口 | Claude Code 实战:搭建 Vue3 工程级项目脚手架 | Cline 并行 Worktree 收口案例 | Parallel Worktrees / Multi-Agent | lane 列表、owner 说明、统一验证结果 |
案例与视频入口
- 想看终端入口如何做仓库 pairing:去 Claude Code 工作方式 和 Terminal-First Repo Pairing。
- 想看计划型入口和长链路执行:去 OpenAI Codex、VS Code Agents。
- 想把工具选型接回真实案例:去 实战案例首页。
- 想找演示视频:去 全部视频 搜
frontend、playwright、figma、codex、claude code。 - 想直接看不同入口的真实交接链:去 Claude Code Bugfix 闭环案例、VS Code Agents 本地到后台交接案例、GitHub Copilot Draft PR 交接案例、Cline 并行 Worktree 收口案例。
下一步
- 想先固定规则文件和任务模板:去 规则与规范文档。
- 想先确定 skill 与 MCP 应该怎么配:去 Skills 与 MCP。
- 想回到前端机制总览:去 上下文与规则。