http://localhost:1313/tags/%E4%BB%A3%E7%A0%81%E8%AF%84%E5%AE%A1/ Recent content in 代码评审 on Saiga Hugo zh-cn wuwenzen@outlook.com (wuwj) wuwenzen@outlook.com (wuwj) Mon, 20 Jan 2025 00:00:00 +0000 http://localhost:1313/posts/2025-01-20-ai-engineering-assistant-workflow/ Mon, 20 Jan 2025 00:00:00 +0000wuwenzen@outlook.com (wuwj) http://localhost:1313/posts/2025-01-20-ai-engineering-assistant-workflow/ <h2 id="背景">背景</h2> <p>在中大型前端项目中，效率瓶颈往往不在“写代码”，而在：</p> <ul> <li>理解既有代码与历史决策</li> <li>做变更评审与影响面分析</li> <li>将经验沉淀为可复用的规范与模板</li> </ul> <p>AI 更适合作为“工程助手”，在不改变既有流程的前提下，降低理解成本与重复劳动。</p> <hr> <h2 id="适用场景与边界">适用场景与边界</h2> <h3 id="适合让-ai-介入的事情">适合让 AI 介入的事情</h3> <ul> <li>读代码：梳理模块关系、数据流、关键入口</li> <li>查影响：对改动点做潜在影响面清单</li> <li>写评审：生成 code review 的检查项与风险点</li> <li>做沉淀：把零散讨论转成可检索的技术记录</li> </ul> <h3 id="不适合直接交给-ai-的事情">不适合直接交给 AI 的事情</h3> <ul> <li>关键逻辑的“正确性判定”</li> <li>业务规则的决策与归因</li> <li>以 AI 输出作为唯一结论（必须可验证）</li> </ul> <hr> <h2 id="一套可落地的使用流程">一套可落地的使用流程</h2> <h3 id="1代码理解先结构化再总结">1）代码理解：先结构化，再总结</h3> <p>输入给 AI 的材料建议是“可验证的事实”，例如：</p> <ul> <li>目录结构（关键模块）</li> <li>入口文件（router/store/bff client）</li> <li>关键类型定义与接口契约</li> <li>相关提交 diff（而非整仓库）</li> </ul> <p>期望 AI 输出的格式建议固定为：</p> <ul> <li>模块职责清单（What）</li> <li>调用链路（How）</li> <li>关键假设与隐含约束（Why）</li> <li>潜在风险点（Risk）</li> </ul> <p>这样更像“工程笔记”，而不是泛泛解释。</p> <hr> <h3 id="2变更评审用清单化替代口头经验">2）变更评审：用“清单化”替代口头经验</h3> <p>对每个变更（PR/commit）生成一份固定结构的评审清单：</p> <ul> <li>影响页面/模块</li> <li>影响数据结构/接口</li> <li>兼容性（旧字段/旧接口/旧路由）</li> <li>性能点（渲染、列表、长任务）</li> <li>观测点（埋点、错误、关键链路）</li> <li>回滚策略（开关/版本/兜底）</li> </ul> <p>AI 的价值在于“补盲”，而不是“替代审查”。</p> <hr> <h3 id="3知识沉淀把对话变成可检索资产">3）知识沉淀：把对话变成可检索资产</h3> <p>建议把以下内容自动化沉淀（写入 Markdown）：</p> <ul> <li>模块说明（README）</li> <li>常见问题与排查路径（FAQ）</li> <li>关键决策记录（ADR：Architecture Decision Record）</li> <li>发布与回滚手册（Runbook）</li> </ul> <p>沉淀策略：少而精，优先覆盖高频问题与关键链路。</p> <hr> <h2 id="工程化落地建议">工程化落地建议</h2> <ul> <li>统一 Prompt 模板：减少输出风格漂移</li> <li>强制输出引用：引用文件路径、函数名、类型名</li> <li>结果可回退：AI 不可用时流程不受影响</li> <li>记录输入与输出：便于复盘与持续改进（注意脱敏）</li> </ul> <hr> <h2 id="总结">总结</h2> <p>AI 在前端工程中的价值，更像“放大镜 + 清单生成器”：</p>