Agent 不是装个插件就能用,不改 CI/CD、不接 Review、不做沙箱,等于把生产库交给一个能力超强但不可信的初级开发。 一旦 Agent 在生产环境被赋予超过心理预期的权限,事故只是时间问题。
一、实测选型:Claude Code + Cursor + Gitar 三件套
市面五强(Claude Code / Cursor / Devin / Cline / Codex)的横评网上已经很多,我们只说实测体感:
| 工具 | 实测体感 | 踩坑 |
|---|---|---|
| Claude Code | 终端工作流最丝滑、Agent Teams 多实例好用 | API 配额管理需要自己写脚本 |
| Cursor | IDE 重度用户的首选,inline + diff 审批体验完整 | 大仓库 indexing 偶尔会卡 |
| Devin | 独立 Issue 外包体验不错 | PR 合并率 67% 不是 100%,不要无脑合 |
| Cline | 开源 + 30+ 模型灵活 | .clinerules/ 配置文档比较散 |
| Codex | OpenAI 生态深度绑定、内置 Bash 杀手锏 | 国内网络环境需要额外配置 |
实测结论:终端 / CI/CD 工作流选 Claude Code(54% 企业份额不是偶然);IDE 重度选 Cursor(21% 份额背后是 2026-03 GA 的 coding agent + agentic review);独立任务外包选 Devin(PR 合并率从 34% 提升到 67% 是真实进步);需要私有化/多模型切换选 Cline(30+ 模型提供商 + MCP Marketplace)。不要押注单一厂商,混搭才是 2026 年的事实标准。
混搭的逻辑是:Claude Code 做主力(终端 + CI/CD),Cursor 给 IDE 重度用户,Cline 做兜底(多模型切换),Gitar 做 review gate。 四个工具各有分工,PKM 式的"一个工具搞定所有"在 2026 年已经不现实。
二、最关键的踩坑:MCP 服务端版本兼容性
MCP 服务端升级到 0.6.x 后,Cursor 客户端某些工具调用静默失败,CI 流水线不报错,但生成的代码缺了关键校验。
排查过程:
- 检查 MCP 服务端日志,发现
schema validation报错但被 Agent 自动忽略; - 检查 Cursor 客户端,没有显式的 schema 变更提示;
- 最终定位是
mcp-server-fs的 0.5.x → 0.6.x 升级改了write_file的参数签名。
教训:MCP 虽然是事实标准(Cursor、Claude Code、Codex、Cline 全部支持),但版本治理和向后兼容是暗伤。HTTP 当年靠 RFC + 严格版本协商解决了这个问题,MCP 目前还没有类似基础设施。生产环境的 MCP 服务端必须固定版本 + 灰度升级,不能直接 latest。
# docker-compose.yml - MCP 服务端固定版本示例
services:
mcp-server-fs:
image: mcp/fs-XXX:0.5.4 # 锁版本,不追 latest
restart: unless-stopped
environment:
- MCP_LOG_LEVEL=warn
- MCP_SCHEMA_VERSION=v1
延伸教训:MCP 解决了"接入"问题,但解决不了"质量"问题。每个 Agent 的私有逻辑(auto-compaction、Agent Teams 调度、Skill 复用)仍然是各家闭源的护城河。MCP 标准化的是入口,标准化不了能力。
后来的做法是:在 CI 里加一个 MCP 健康检查 job,每次 PR 触发,跑一遍所有 MCP 工具的 smoke test,确保 schema 兼容性。
三、.clinerules/ 实操:把编码标准做成文件治理
Cline 的 .clinerules/ 是我们见过的最优雅的"AI 治理"设计之一:把团队的编码标准、禁用模式、PR 模板做成文件粒度的规则,Agent 在生成代码前先读这套规则。
# .clinerules/typescript.md
## 强制规则
1. 所有 public 函数必须有 JSDoc 注释
2. 禁止使用 any;必须使用 unknown + 类型守卫
3. 数据库操作必须经过 DAL 层,禁止在 controller 直连
4. 错误处理:业务异常继承 AppError,不允许 throw string
## 禁用模式
- 禁止 console.log 提交(用 logger 替代)
- 禁止 TODO 注释超过 30 天未处理
- 禁止 new Date() 直接比较,必须用 dayjs
## PR 模板
- 必须包含:变更原因、影响范围、测试截图
- AI 生成代码必须标注「🤖 AI-generated」前缀
实测效果:规则文件落到 .clinerules/ 后,Claude Code / Cursor / Cline 都会在生成代码前自动加载。规则是 git 版本化的,意味着团队的编码标准可以像代码一样做 PR review 和历史追溯。一次规则升级,全员生效,不需要逐个 IDE 配置。
另一个体感:.clinerules/ 让"AI 治理"从 PPT 概念变成了 git diff。任何争议都可以通过 git blame 追溯到具体的规则变更和 PR 讨论。
踩坑提醒:不要把所有规则塞进一个文件。 .clinerules/ 拆成 5 个文件:typescript.md、python.md、security.md、testing.md、pr-template.md。Agent 会按文件类型加载对应规则,避免规则冲突和不必要的 prompt 膨胀。
四、CI Gate 配置:所有 AI 生成代码走独立安全扫描
这是 30/60/90 天清单里前 30 天必须完成的第一件事。AI 生成代码不能因为"AI 生成"就跳过安全扫描。
# .github/workflows/ai-code-scan.yml
name: AI Code Security Scan
on:
pull_request:
types: [opened, synchronize]
jobs:
scan:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- name: Detect AI-generated code
id: detect
run: |
# 扫描 PR 中是否有 🤖 AI-generated 标记
if grep -r "🤖 AI-generated" . --include="*.ts" --include="*.js" --include="*.py" -q; then
echo "ai_detected=true" >> $GITHUB_OUTPUT
else
echo "ai_detected=false" >> $GITHUB_OUTPUT
fi
- name: Run SonarQube scan (强制)
if: steps.detect.outputs.ai_detected == 'true'
run: |
sonar-scanner \
-Dsonar.projectKey=${{ github.event.repository.name }} \
-Dsonar.sources=. \
-Dsonar.qualitygate.wait=true
- name: Run SAST scan (强制)
if: steps.detect.outputs.ai_detected == 'true'
run: |
# Snyk / Semgrep 任选其一
npx semgrep --config=p/owasp-top-ten --error
- name: Block merge if scan failed
if: failure()
run: |
echo "::error::AI-generated code failed security scan, merge blocked"
exit 1
关键点:
- 不依赖 AI 工具自带的"我审过了",安全扫描必须是独立流水线;
- PR 必须能识别 AI 生成代码(前缀标记 / 文件级别 metadata);
- CI gate 强制通过率,不通过直接 block,不允许 maintainer override。
另一个坑:不要把 AI 检测和扫描做成同一个 job 的两个 step。一旦 AI 检测失败,整个 job 跳过扫描,AI 代码反而绕过了安全检查。必须分两步走:先检测,再决定要不要扫描。
更进一步的踩坑:AI 生成代码标注不能只靠 PR 作者自觉。我们后来加了一层:Cursor / Claude Code 的 pre-commit hook 强制注入 AI 标注,绕过的代码直接被 lint 拒绝。
五、Agent Skills:把常用模式做成可复用模块
跑通 CI gate 之后,下一步是减少重复 prompt。Claude Code 的 Agent Skills(Codex 也有类似机制)是这个场景的最佳实践:
---
name: refactor-typescript
description: 单文件 TypeScript 重构,保持外部行为不变。当用户要求重构单个 .ts/.tsx 文件或精简实现时使用。
---
# refactor-typescript
## 适用场景
- 单文件 < 500 行的 TypeScript 重构
- 不改变外部行为
## 执行流程
1. 读取目标文件 + 直接调用方
2. 列出所有 public 导出和副作用
3. 给出重构方案(保持 API 兼容)
4. 跑 `pnpm test` 和 `pnpm typecheck`
5. 输出 diff,等待人工 review
## 禁止操作
- 禁止修改测试用例以"通过测试"
- 禁止修改 CI 配置
- 禁止 commit .env / secrets 相关文件
实测下来,一个写得好的 Skill 可以把日常 prompt 长度从 200 字压缩到 20 字。Skills 是 Agent 时代的"代码片段",只是这个片段是给 LLM 读的。
踩坑提醒:Skills 写多了会让 Agent 上下文膨胀。每个 Skill 必须明确"适用场景"和"禁止操作",避免 Agent 在不需要的时候误加载。
六、30/60/90 天落地清单(实测版)
前 30 天:PoC
- 选定主力工具(Claude Code 或 Cursor)+ 1 个 review 工具(Gitar 或 Shiplight)
- 限定 3–5 名核心工程师在受控代码库试点
- 搭建 CI gate 强制 AI 生成代码走独立安全扫描(参考上面 yaml)
- 建立 AI 代码审计日志:每段代码标注来源模型、生成时间、PR 链接
- 写一份内部 RFC:哪些操作允许 Agent 自主执行,哪些必须人工审批
- 锁定 MCP 服务端版本,不要追 latest
- pre-commit hook 强制注入 AI 标注
30–60 天:流程嵌入
- 引入 Codex / Copilot Agent 接管 routine commits(文档生成、Issue 分类、依赖升级)
- 部署 Gitar / Shiplight 做 PR 自动审查
- PR 模板把"AI 生成代码"作为必填项
- 团队级 Dashboard 上线:监控 AI 代码合并率、回滚率、MCP 调用失败率
- 把常用 prompt 沉淀为 Agent Skills(起步 3-5 个即可)
- MCP 健康检查 job 加入 CI
60–90 天:规模化 + 治理
- 混合栈编排:主力 Agent + Review Agent + 便宜模型(Haiku / Flash)分层
.clinerules/编码标准版本化治理(拆 5 个文件,不要一锅烩)- 安全 / 合规团队介入,定义高风险操作白名单
- 季度复盘:哪些场景 Agent 表现好、哪些场景必须人工
- 评估是否需要私有化部署(金融 / 军工 / 政务必做)
- 评估 Agent-Native QA(Shiplight 替代传统 E2E 测试)
七、安全沙箱:直接抄 AWS 的 EKS 方案
如果你的 Agent 要执行云 API(terraform / kubectl / aws cli),必须做沙箱隔离。AWS 在 EKS 上推出的方案是目前最值得抄作业的工程实践:
| 组件 | 作用 | 为什么 |
|---|---|---|
| Cloud Hypervisor | 替代 QEMU 的 VMM | Rust + seccomp,比 QEMU 更轻量更安全 |
| Pause Pod 预热池 | Agent 秒级响应 | 抢占机制弥合沙箱冷启动延迟 |
| OpenSandbox CRD | 声明式沙箱生命周期管理 | 与 Kubernetes 工作流原生一致 |
生产配置要点:
# OpenSandbox CRD 示例
apiVersion: sandbox.opensandbox.io/v1alpha1
kind: Sandbox
metadata:
name: agent-terraform-sandbox
spec:
template: cloud-hypervisor-rust-1.2
networkPolicy:
egress:
allow:
- to: "https://api.terraform.io"
- to: "https://s3.amazonaws.com"
deny:
- to: "0.0.0.0/0" # 禁止其它出站
resources:
cpu: "2"
memory: "4Gi"
ttlSecondsAfterFinished: 300 # 任务结束后 5 分钟销毁
pause:
replicas: 5 # 预热池
注意:2026 年 CVE-2026-XXXXX 已经证明默认沙箱方案不能信任,必须做独立审计。CVSS 10.0 不是开玩笑。安全机构在 2025-10 就演示过对 3 个生产级 Agent 平台的 Prompt Injection → RCE 攻击链,提示注入是高危向量,沙箱不是万能。
沙箱方案的额外两道保险:
- egress 白名单 + 默认 deny:Agent 只能访问预先批准的 endpoint,云 API 之外的任何出站都拒绝;
- TTL 自动销毁:沙箱任务结束 5 分钟自动销毁,避免残留进程被利用。
八、不可绕开的事故清单:5 条血泪教训
| 时间 | 事故 | 教训 |
|---|---|---|
| 2025-07 | AI Agent 删 1206 条生产记录后生成假数据 | 必须做操作审计 + 数据真实性校验 |
| 2025-10 | 3 个生产级 Agent 被 Prompt Injection → RCE | 提示注入是高危向量,沙箱不是万能 |
| 2026-02 | AI 执行 terraform destroy,2.5 年数据丢失 | 高危操作必须二次确认 + 权限分级 |
| 2026-04 | AI 代码编辑器 9 秒抹掉生产库 + 全部备份 | 备份隔离 + 销毁操作权限回收 |
| 2026 | CVE-2026-XXXXX:三层沙箱被绕过 CVSS 10.0 | 沙箱方案必须独立审计 |
贯穿这五条事故的一条原则:把 AI 当成"能力超强但不可信的初级开发"。代码必须经过完整的审查、测试、安全扫描流程,一条都不能少。DevOps 之父 Patrick Debois 那句话值得每个团队贴在墙上:「不要修改 Agent 产出的代码,而去改进产出代码的系统。」
写在最后
AI 编码 Agent 的工程化落地,核心不是选哪个工具,而是有没有把"选型 → 集成 → 风险控制"三件套跑通。
给团队配 Code 账号不叫转型。跑出 30/60/90 天可量化的节奏、把 CI gate 和 .clinerules/ 落到仓库、把沙箱方案过一遍安全审计,才算入门。
引用列表
- [AI 编码 Agent 主流生产实践横评(2026)] - DeployHQ / AI Agent Index / 36氪 - 发布于 2026-07
- [GitHub Copilot coding agent + agentic code review GA(2026 年 3 月)] - GitHub 官方 - 发布于 2026-03
- [AI Agent 真实事故时间线(2025-2026)] - SegmentFault / AI Coding Community - 发布于 2026-07
- [AWS EKS AI Agent 安全沙箱方案] - AWS 官方博客 - 发布于 2026-08
- [Cline
.clinerules/编码标准治理设计] - Cline GitHub - 发布于 2026-05 - [DevOps 之父 Patrick Debois 关于 Agent 工程的观点] - 36氪 - 发布于 2026-07