现在使用Agent 开发项目已经是程序员的必备技能。
我使用Agent 编程的基本理念就是：Agent 能做的Agent 做；Agent不适合做的，我自己做。
因此，知道Agent不适合做什么很重要。
Agent不适合做的内容
一、超大型 / 超长上下文项目
- 单文件数万行、整个项目几十万行以上：索引慢、内存占用高、延迟大。
- 超出模型上下文窗口（如 GPT‑4 128k tokens）：会丢上下文、逻辑断裂、前后矛盾。
- 不适合：超大遗留系统、巨型单体应用、超长配置文件。
二、深度架构设计与复杂系统重构
- 缺乏全局架构视野，容易局部最优、整体混乱。
- 大型重构（如微服务拆分、架构迁移）：易破坏依赖、引入隐藏 bug。
- 代码风格偏 "Demo 化"，中大型项目结构与规范不足。
- 不适合：核心架构设计、大规模重构、复杂分布式系统。
三、强视觉 / 多模态前端精细化调试
- 无法 "看懂" 页面效果、截图、设计稿，只能靠文字描述。
- CSS 像素级对齐、响应式细节、复杂动画调试：效率低、反复试错。
- 不适合：UI 像素还原、复杂交互视觉调试、设计稿转代码（高精度） 。
四、高性能 / 底层与极致优化场景
- 底层内核、驱动、嵌入式开发：对硬件细节、内存布局、时序理解不足。
- 极致性能优化（如高频算法、内存池、锁优化）：易写出低效代码、忽略边界条件。
- 不适合：操作系统内核、驱动、嵌入式、高频交易、极致性能算法。
五、严格安全 / 合规与高风险系统
- 金融、医疗、支付、加密等强合规场景：易引入安全漏洞（如注入、权限绕过）。
- 隐私数据处理：模型可能泄露敏感逻辑或数据。
- 不适合：金融核心、医疗系统、支付网关、加密模块、隐私敏感服务。
六、存量复杂代码的无监督改造
- 老项目、祖传代码、缺乏文档的遗留系统：理解差、易改错。
- 无人工审核的大规模自动修改：风险极高、难以回滚。
- 不适合：无文档遗留系统、高风险自动重构、核心业务逻辑无监督修改。
七、过度工程化与简单问题复杂化
- 倾向用复杂方案解决简单问题（滥用设计模式、装饰器、函数式语法糖）。
- 简单脚本 / 工具类：写出冗余、难维护代码。
- 不适合：极简工具、一次性脚本、简单业务逻辑（追求轻量易维护） 。
八、离线 / 弱网与私有闭源依赖场景
- 离线模式能力大幅缩水，复杂生成 / 调试不可用。
- 内部私有框架、闭源 SDK、自研库：生成准确率低、易编造假代码。
- 不适合：纯离线开发、重度依赖内部私有技术栈的项目。
Agent 避坑清单
一、绝对不推荐使用
表格
| 场景分类 | 具体工作内容 | 风险 / 问题 | 推荐替代方式 |
|---|---|---|---|
| 精细视觉 / 图形 | 像素级 Canvas、Shader、图像处理、高精度 UI 还原、复杂动画调参 | 无法直观识别视觉效果，反复试错、对齐偏差 | VS Code + 插件、Figma 转码工具、专业图形编辑器 |
| 底层 / 高性能开发 | 系统内核、硬件驱动、嵌入式、高频算法、内存 / 锁极致优化 | 对硬件时序、内存布局理解不足，代码低效、藏 bug | 原生 IDE、专业调试工具，人工主导编码优化 |
| 强安全 / 合规系统 | 金融核心、支付网关、医疗系统、加密模块、隐私数据服务 | 易出现安全漏洞、逻辑疏漏，合规风险高 | 人工编码 + 严格代码审计、安全扫描工具 |
| 超大体量项目 | 单文件万行以上、几十万行级单体应用、巨型遗留系统 | 索引卡顿、上下文丢失、逻辑前后矛盾 | 拆分模块 + 传统 IDE，分段人工维护 |
| 无监督代码改造 | 无文档祖传代码、核心业务逻辑全自动重构 / 批量修改 | 误改依赖、破坏原有逻辑，问题难排查 | 人工梳理文档 + 小范围迭代修改 |
二、谨慎使用（需人工全程把控）
表格
| 场景分类 | 具体工作内容 | 注意要点 |
|---|---|---|
| 架构 & 大型重构 | 微服务拆分、技术栈迁移、整体架构设计 | 只用来写局部代码，架构方案、依赖梳理全程人工主导 |
| 私有 / 闭源依赖 | 重度使用内部自研框架、私有 SDK、未开源组件 | 生成代码大概率失真，必须逐行校验、修正接口 |
| 极简轻量脚本 | 一次性工具、简单业务逻辑 | 容易过度设计、代码冗余，主动要求精简写法 |
| 离线 / 弱网环境 | 断网开发、内网隔离环境 | 智能补全、代码生成能力大幅下降，仅作基础编辑器使用 |
三、优先用Agent 的场景
- 中小型项目、业务增删改查、接口开发
- 快速原型、Demo、新功能试错
- 代码注释、单元测试、简单 bug 排查
- 通用开源技术栈（Vue/React/Node 等）常规开发
总结
Agent 擅长快速原型、全栈 Demo、中小型项目、日常增删改查、辅助调试；
但不适合超大项目、核心架构、像素级 UI、底层高性能、强安全合规、无监督遗留改造、简单问题复杂化、离线私有依赖。