AI-NEWS

Appearance

Agent IDE 全景 ​

🎯 学习目标

  • 理解「编程 Agent 工具」与「自建 Agent 应用」的边界
  • 掌握 Rule、Skill、MCP、Subagent 四类配置的共性
  • 能按团队场景选型 Cursor / Claude Code / Codex / Trae

引言 ​

前八章解决的是：如何用代码搭 Agent。第九章解决的是：如何在 IDE 里用好 Agent——让模型遵守团队规范、调用工具、拆分任务，而不是每次从零 prompt。

四类工具形态略有不同，但配置层可抽象为：

层次作用典型载体
Rule持久约束：风格、目录、禁止事项.cursor/rules/、AGENTS.md（Codex）、CLAUDE.md
Skill可复用工作流：检索资讯、写 PR、跑评测.agents/skills/（Codex）、.cursor/skills/、SKILL.md 插件包
MCP外部工具协议：数据库、浏览器、内部 APImcp.json、MCP Server 配置
Multi-Agent分工：探索 / 实现 / 审查Subagent、Background Agent、Builder 模式

章节正文 ​

第 1 步：选型建议 ​

场景优先考虑
日常全栈开发、深度 IDE 集成Cursor
终端优先、仓库级自动化、CI 友好Claude Code
OpenAI 生态、Codex CLI / 云端 AgentCodex
国内网络、字节系工作流、Builder 模式Trae

多数团队会 组合使用（例如 Cursor 写代码 + Claude Code 跑批量重构），关键是 规则与 Skill 仓库化，避免每人一套口头约定。

第 2 步：推荐仓库结构（通用） ​

text
your-repo/
├── .agents/              # Codex（及跨平台）Skill
│   └── skills/
├── .cursor/              # Cursor 专用
│   ├── rules/
│   └── skills/
├── AGENTS.md             # Codex 持久规则（也可放子目录）
├── CLAUDE.md             # Claude Code 项目记忆
└── docs/
    └── agent-playbook.md # 团队 Agent 使用手册

原则：Rule 写「不能做什么」和「默认怎么做」；Skill 写「某类任务的标准步骤」；MCP 接「真实系统」；Multi-Agent 写「谁负责哪一段」。

第 3 步：Multi-Agent 配置思路 ​

  1. 主 Agent：与用户对话、拆任务、汇总结果。
  2. 探索 Agent：只读搜索代码库，不改文件。
  3. 实现 Agent：按 spec 改代码、跑测试。
  4. 审查 Agent：只读 diff，输出 review 意见。

在 Cursor 中对应 Subagent / Task；在 Claude Code 中对应 --agent 或子会话策略；在 Codex 中对应 AGENTS.md 角色 + .agents/skills/ 工作流；在 Trae 中对应 Builder 与 SOLO / 多 Agent 模式。

第 4 步：安全与治理 ​

  • Secrets 永不写入 Rule / Skill，走环境变量或密钥管理。
  • 写操作 默认需确认；生产仓库启用保护分支。
  • MCP 最小权限：只暴露必要 tool，审计依赖来源（见第三章 MCP 安全课）。

小结 ​

  • Agent IDE 是「Harness」的成品形态，与第五章 Agent 架构、第七章生产化直接呼应。
  • 后续四课分别展开 Cursor、Claude Code、Codex、Trae 的目录与配置示例。