摘要：Agent不适合做的内容 一、超大型 / 超长上下文项目

单文件数万行、整个项目几十万行以上：索引慢、内存占用高、延迟大。超出模型上下文窗口（如 GPT‑4 128k tokens）：会丢上下文、逻辑断裂、前后矛盾。 Agent 避坑清单 一、绝对不推荐使用 表格

场景分类具体工作内容风险 / 问题推荐替代方式精细视觉 / 图形像素级 Canvas、Shader、图像处理、高精度 UI 还原、复杂动画调参无法直观识别视觉效果，反复试错、对齐偏差VS Code + 插件、Figma 转码工具、专业图形编辑器底层 / 高性能开发系统内核、硬件驱动、嵌入式、高频算法、内存 / 锁极致优化对硬件时序、内存布局理解不足，代码低效、藏 bug原生 IDE、专业调试工具，人工主导编码优化强安全 / 合规系统金融核心、支付网关、医疗系统、加密模块、隐私数据服务易出现安全漏洞、逻辑疏漏，合规风险高人工编码 + 严格代码审计、安全扫描工具超大体量项目单文件万行以上、几十万行级单体应用、巨型遗留系统索引卡顿、上下文丢失、逻辑前后矛盾拆分模块 + 传统 IDE，分段人工维护无监督代码改造无文档祖传代码、核心业务逻辑全自动重构 / 批量修改误改依赖、破坏原有逻辑，问题难排查人工梳理文档 + 小范围迭代修改 二、谨慎使用（需人工全程把控） 表格

场景分类具体工作内容注意要点架构 & 大型重构微服务拆分、技术栈迁移、整体架构设计只用来写局部代码，架构方案、依赖梳理全程人工主导私有 / 闭源依赖重度使用内部自研框架、私有 SDK、未开源组件生成代码大概率失真，必须逐行校验、修正接口极简轻量脚本一次性工具、简单业务逻辑容易过度设计、代码冗余，主动要求精简写法离线 / 弱网环境断网开发、内网隔离环境智能补全、代码生成能力大幅下降，仅作基础编辑器使用 三、优先用Agent 的场景

中小型项目、业务增删改查、接口开发 快速原型、Demo、新功能试错 代码注释、单元测试、简单 bug 排查 通用开源技术栈（Vue/React/Node 等）常规开发

总结 Agent 擅长快速原型、全栈 Demo、中小型项目、日常增删改查、辅助调试； 但不适合超大项目、核心架构、像素级 UI、底层高性能、强安全合规、无监督遗留改造、简单问题复杂化、离线私有依赖。

现在使用Agent 开发项目已经是程序员的必备技能。

我使用Agent 编程的基本理念就是：Agent 能做的Agent 做；Agent不适合做的，我自己做。

因此，知道Agent不适合做什么很重要。

Agent不适合做的内容

一、超大型 / 超长上下文项目

• 单文件数万行、整个项目几十万行以上：索引慢、内存占用高、延迟大。
• 超出模型上下文窗口（如 GPT‑4 128k tokens）：会丢上下文、逻辑断裂、前后矛盾。
• 不适合：超大遗留系统、巨型单体应用、超长配置文件。

二、深度架构设计与复杂系统重构

• 缺乏全局架构视野，容易局部最优、整体混乱。
• 大型重构（如微服务拆分、架构迁移）：易破坏依赖、引入隐藏 bug。
• 代码风格偏 “Demo 化”，中大型项目结构与规范不足。
• 不适合：核心架构设计、大规模重构、复杂分布式系统。

三、强视觉 / 多模态前端精细化调试

• 无法 “看懂” 页面效果、截图、设计稿，只能靠文字描述。
• CSS 像素级对齐、响应式细节、复杂动画调试：效率低、反复试错。
• 不适合：UI 像素还原、复杂交互视觉调试、设计稿转代码（高精度） 。

四、高性能 / 底层与极致优化场景

• 底层内核、驱动、嵌入式开发：对硬件细节、内存布局、时序理解不足。
• 极致性能优化（如高频算法、内存池、锁优化）：易写出低效代码、忽略边界条件。
• 不适合：操作系统内核、驱动、嵌入式、高频交易、极致性能算法。

五、严格安全 / 合规与高风险系统

• 金融、医疗、支付、加密等强合规场景：易引入安全漏洞（如注入、权限绕过）。
• 隐私数据处理：模型可能泄露敏感逻辑或数据。
• 不适合：金融核心、医疗系统、支付网关、加密模块、隐私敏感服务。

六、存量复杂代码的无监督改造

• 老项目、祖传代码、缺乏文档的遗留系统：理解差、易改错。
• 无人工审核的大规模自动修改：风险极高、难以回滚。
• 不适合：无文档遗留系统、高风险自动重构、核心业务逻辑无监督修改。

七、过度工程化与简单问题复杂化

• 倾向用复杂方案解决简单问题（滥用设计模式、装饰器、函数式语法糖）。
• 简单脚本 / 工具类：写出冗余、难维护代码。
• 不适合：极简工具、一次性脚本、简单业务逻辑（追求轻量易维护） 。

八、离线 / 弱网与私有闭源依赖场景

• 离线模式能力大幅缩水，复杂生成 / 调试不可用。
• 内部私有框架、闭源 SDK、自研库：生成准确率低、易编造假代码。
• 不适合：纯离线开发、重度依赖内部私有技术栈的项目。

Agent 避坑清单

一、绝对不推荐使用

表格

二、谨慎使用（需人工全程把控）

表格

三、优先用Agent 的场景

1. 中小型项目、业务增删改查、接口开发
2. 快速原型、Demo、新功能试错
3. 代码注释、单元测试、简单 bug 排查
4. 通用开源技术栈（Vue/React/Node 等）常规开发

总结

Agent 擅长快速原型、全栈 Demo、中小型项目、日常增删改查、辅助调试；

但不适合超大项目、核心架构、像素级 UI、底层高性能、强安全合规、无监督遗留改造、简单问题复杂化、离线私有依赖。