核心内容摘要
黄品汇MBA智库旧版本2025：穿越时空的智慧宝藏，点亮您的商业远见
目录核心概念理解 Agent Harness工作流基础从规划开始上下文管理艺术扩展 AgentRules 与 Skills多模态能力图片与浏览器六大实战工作流模式代码审查与质量控制高级技巧并行 Agent 与自动化[补充] 实战进阶技巧](#九补充实战进阶技巧)[补充]
常见问题排查](#十补充
常见问题排查)
核心概念理解 Agent Harness
1 什么是 Agent HarnessAgent Harness智能体调度框架是支撑 Cursor Agent 运行的核心架构由三个关键组件构成组件作用示例Instructions系统级指令与规则代码风格要求、项目结构约定Tools可调用工具集文件编辑、代码搜索、终端执行、浏览器控制User Messages用户指令与反馈功能需求、修改建议、问题澄清关键洞察Cursor 会为不同模型GPT-
Claude、Gemini 等单独优化Instructions 和 Tools。
这意味着在 Shell 环境训练的模型更偏好使用grep而非专用搜索工具某些模型需要明确指令才会在编辑后调用 LinterCursor 自动处理这些差异你只需专注于构建软件
工作流基础从规划开始
1 为什么要先规划芝加哥大学研究发现有经验的开发者更倾向于在生成代码前进行规划。
规划的价值✅ 迫使你清晰思考构建内容✅ 为 Agent 提供明确的实现目标✅ 减少返工和方向性错误
2 Plan 模式实操开启方式在 Agent 输入框中按Shift Tab切换 Plan/Act 模式Plan 模式的工作流程
分析代码库 → 查找相关文件
提出澄清问题 → 明确需求细节
生成详细计划 → 包含文件路径和代码引用
等待人工确认 → 审查后可编辑计划实战技巧计划以 Markdown 形式打开可直接编辑调整点击“Save to workspace”保存到.cursor/plans/便于团队协作和断点续作简单任务可跳过规划小改动或重复性任务可直接进入 Act 模式
3 从计划重新开始 vs 修补当 Agent 输出不符合预期时❌低效做法通过后续提示词不断修补✅高效做法回滚改动 → 重新细化计划 → 更具体地描述需求 → 重新运行
上下文管理艺术
1 让 Agent 自主获取上下文不要在提示中手动标记每一个文件。
Cursor Agent 具备即时 Grep毫秒级代码库搜索语义搜索理解身份验证流程等概念性查询智能加载自动找到相关文件即使提示词中没有完全匹配的词汇最佳实践知道确切文件 → 直接引用如file.tsx不确定文件 → 描述需求让 Agent 查找避免包含不相关文件会造成噪声降低 Agent 注意力
2 利用上下文工具Branch提供当前分支的 Git 上下文示例提示“Review the changes on this branch” 或 “What am I working on?”Past Chats引用历史对话的关键信息Commit/PR引用特定的代码版本
3 对话生命周期管理何时开始新对话切换到不同任务或功能模块Agent 表现困惑或重复犯同类错误已完成一个逻辑完整的工作单元何时继续当前对话对同一功能进行迭代优化需要利用先前讨论的上下文正在调试刚生成的代码⚠️ 重要过长的对话会积累噪声Agent 容易失去焦点。
当效果下降时果断开启新对话。
扩展 AgentRules 与 Skills
1 Rules静态上下文配置Rules 是始终生效的指令放在.cursor/rules/目录下Markdown 格式。
Rule 文件结构示例# Commands - npm run build: Build the project - npm run typecheck: Run typechecker (always run after changes) - npm run test: Run tests (prefer single test file for speed) # Code Style - Use ES modules (import/export), not CommonJS (require) - Prefer destructuring: import { foo } from bar - Reference components/Button.tsx for component structure standards # Workflow - Always typecheck after making changes - API routes go in app/api/ following existing patternsRule 编写原则✅ 聚焦命令、模式、指向规范示例的引用✅ 引用文件而非复制内容避免过时❌ 避免复制完整风格指南用 Linter、记录所有命令、添加罕见边缘情况进阶技巧将 Rules 提交到 Git全团队共享发现 Agent 犯错时立即更新 Rule在 GitHub Issue/PR 中cursor让 Agent 帮你更新 Rule
2 Skills动态能力与工作流Skills 是 Agent按需调用的能力定义在SKILL.md中包括Custom Commands/触发的可复用工作流HooksAgent 动作前后运行的脚本如自动测试Domain Knowledge特定领域的专业知识库与 Rules 的区别Rules始终加载提供基础上下文Skills动态加载保持上下文窗口整洁提供专业能力
3 实战案例长时间运行的 Agent 循环使用 Hooks 创建自动迭代直到目标达成的 Agent配置.cursor/hooks.json{version:1,hooks:{stop:[{command:bun run .cursor/hooks/grind.ts}]}}Hook 脚本.cursor/hooks/grind.tsimport{readFileSync,existsSync}fromfs;interfaceStopHookInput{conversation_id:string;status:completed|aborted|error;loop_count:number;}constinput:StopHookInputawaitBun.stdin.json();constMAX_ITERATIONS5;// 超过最大迭代次数则停止if(input.status!completed||input.loop_countMAX_ITERATIONS){console.log(JSON.stringify({}));process.exit(
;}// 检查是否完成标记constscratchpadexistsSync(.cursor/scratchpad.md)?readFileSync(.cursor/scratchpad.md,utf-
:;if(scratchpad.includes(DONE)){console.log(JSON.stringify({}));}else{// 继续迭代console.log(JSON.stringify({followup_message:[迭代${input.loop_count1}/${MAX_ITERATIONS}] 继续工作。
修复测试失败后更新 .cursor/scratchpad.md 标记为 DONE。
}));}适用场景持续修复直到所有测试通过反复迭代 UI 直到与设计稿一致任何目标可验证的任务注意Agent Skills 目前仅在Nightly版本可用设置 → Beta → 更新通道 → Nightly
4 MCP 集成Model Context Protocol通过 MCP 将 Agent 连接到外部工具读取 Slack 消息、分析 Datadog 日志调试 Sentry 错误、查询数据库连接 Figma API 等设计工具
多模态能力图片与浏览器
1 设计稿到代码操作方式直接粘贴设计稿截图拖拽 Figma 导出图引用本地图片路径Agent 能识别布局结构Flex/Grid颜色值自动提取 CSS 变量间距大小计算 padding/margin字体样式进阶使用Figma MCP Server直接获取设计 tokens
2 可视化调试比文字描述更高效的方式对报错界面截图 → 粘贴给 Agent 分析异常 UI 状态截图 → 让 Agent 定位问题对比前后状态 → 让 Agent 识别差异
3 浏览器控制Agent 可控制浏览器进行自动化测试自行截图验证 UI 变更测试交互流程验证响应式布局
六大实战工作流模式模式 1测试驱动开发TDD四步法
编写测试 → 明确定义输入/输出告知 Agent 这是 TDD避免写 mock
运行确认失败 → 明确要求此时不要写实现代码
提交测试代码 → 作为基准快照
实现功能 → 指示不修改测试持续迭代直到全通过
提交实现代码价值Agent 有清晰的迭代目标可自我评估并逐步改进模式 2代码库探索向 Agent 提问的方式像问资深同事“这个项目的日志系统是如何工作的”“添加新 API endpoint 的标准流程是什么”“CustomerOnboardingFlow处理了哪些边界情况”“为什么第 1738 行调用setUser()而不是createUser()”Agent 会同时使用 Grep 和语义搜索这是上手新项目的最高效方式。
模式 3Git 工作流自动化创建 Custom Command保存到.cursor/commands/Markdown 格式示例创建 PR 命令/pr为当前更改创建 Pull Request。
使用 git diff 查看已暂存和未暂存的更改
根据更改内容编写清晰的提交信息遵循 conventional commits
提交并推送到当前分支
使用 gh pr create 创建 Pull Request提供标题和描述
返回 PR URL其他实用命令/fix-issue [number]读取 issue → 定位代码 → 修复 → 创建 PR/review运行 linter → 检查
常见问题 → 生成审查报告/update-deps检查过时依赖 → 逐个更新 → 测试验证模式 4代码审查工作流三层审查机制阶段方式操作实时代码生成边生成边审查观察 Diff 视图发现方向错误按Esc中断Agent ReviewAI 辅助审查点击Review→Find Issues逐行分析潜在问题Bugbot自动化审查推送到仓库后自动为 PR 提供高级分析和改进建议模式 5架构可视化用于重大变更前的设计验证提示词示例Create a Mermaid diagram showing the data flow for our authentication system, including OAuth providers, session management, token refresh, and database interactions.价值提前发现架构设计缺陷作为技术文档的一部分代码审查前的架构对齐模式 6多模型对比验证并行运行策略下拉菜单选择多个模型如 GPT-4 Claude Opus提交同一提示词并排比较结果Cursor 会标记推荐方案最佳实践用于复杂逻辑或架构决策通过对比发现不同模型的思维盲点选择最符合项目风格的实现
代码审查与质量控制
1 实时审查生成阶段操作Diff 视图实时显示变更随时打断和纠正干预时机文件修改方向偏离需求使用了不期望的技术方案即将删除重要代码
2 Agent Review本地审查入口Source Control 标签页 → Agent Review对比主分支适用场景批量改动后的统一审查发现潜在的逻辑漏洞检查安全敏感代码
3 Bugbot远程审查触发推送代码到 GitHub/GitLab 后自动运行能力高级静态分析模式匹配发现反模式提出具体改进建议含代码示例
高级技巧并行 Agent 与自动化
1 原生 Git Worktree 支持原理每个并行 Agent 运行在独立的 Git Worktree 中文件系统完全隔离使用方式Agent 下拉菜单选择 “Worktree” 选项Agent 在独立分支和工作目录中运行完成后点击Apply合并回当前分支优势零干扰并行实验可同时尝试不同解决方案安全的隔离测试环境
2 多模型并行对比设置步骤在 Agent 输入框下拉菜单勾选多个模型输入提示词并提交查看分屏对比结果决策建议关注 Cursor 的推荐有 标记对比各方案的代码量和复杂度选择与项目现有风格最一致的方案
[补充] 实战进阶技巧
1 Prompt 工程优化高效提示词结构## 任务背景 [项目类型、当前阶段、相关技术栈] ## 具体需求 [明确的功能描述避免模糊词汇] ## 输入/输出示例 [提供具体的数据格式或界面示例] ## 约束条件 - 必须遵循[具体规则] - 禁止操作[明确禁止的事项] - 性能要求[时间/空间复杂度要求] ## 验证标准 [如何确认任务完成测试条件]避免的陷阱❌ “优化这段代码” → ✅ “将查询时间从 O(n²) 优化到 O(n log n)内存使用不超过 100MB”❌ “修复这个 bug” → ✅ “修复用户登录时的 401 错误复现步骤1… 2… 3…”
2 代码库索引优化Cursor 通过索引加速代码搜索优化建议排除大文件在.cursorignore中加入*.min.js *.bundle.js node_modules/ dist/ build/关键文件置顶在 Rules 中引用核心文件路径帮助 Agent 建立锚点定期重建索引Command Palette → “Rebuild Index”当文件结构大幅变更后
3 安全最佳实践敏感信息处理使用.cursorignore排除.env文件在 Rules 中明确“Never commit API keys or secrets”使用 MCP 集成专门的 Secrets 管理工具危险操作防护# 在 Rules 中添加 - 执行 rm -rf 或数据库删除操作前必须要求人工确认 - 修改生产环境配置前必须双重确认 - 禁止使用 eval() 或动态代码执行
4 性能调优加速 Agent 响应开启 “Fast Mode”牺牲部分质量换取速度适合简单任务限制上下文窗口定期开启新对话使用特定的小模型处理简单任务如 Sonnet 处理文档Opus 处理架构大规模重构策略分阶段按模块拆分而非一次性全改快照策略每个模块完成后提交便于回溯验证穿插每改
个文件运行一次测试而非全部完成后再测试
[补充]
常见问题排查Q1: Agent 频繁陷入循环或重复修改解决方案立即开启新对话用Past Chats引用关键上下文将任务拆分为更小的子任务在 Plan 阶段明确设定 “停止条件”Q2: Agent 修改了不该改的文件预防措施使用.cursorignore锁定关键文件在提示中明确“只允许修改src/components/下的文件”使用 Worktree 模式进行危险操作Q3: 生成的代码不符合项目风格长期解决在 Rules 中引用项目内的规范示例文件添加 Prettier/ESLint 配置让 Agent 遵循提供 “Before/After” 示例供 Agent 学习Q4: Agent 无法理解复杂的业务逻辑沟通策略使用 “类比”比如 “这个流程就像购物车结账”提供流程图或状态机图图片输入引用之前的类似实现file 之前类似的实现.tsxQ5: 如何处理 Agent 生成的低级错误反馈循环不要只是修复要告诉 Agent 错误原因更新 Rules 防止同类错误如果是模型固有限制记录到项目文档的 “Known Issues”
总结Agent 思维模式转变传统开发Agent 协作开发亲自编写每一行代码设计任务和验证结果查阅文档和源码自然语言提问获取答案线性编码流程并行实验和快速迭代人工代码审查AI 辅助 人工把关核心心法Cursor Agent 不是替代开发者而是放大你的决策能力。
你的新角色是架构师、审查者和任务规划者而非单纯的代码编写者。
下一步行动在项目中配置.cursor/rules/basic.md尝试用 Plan 模式完成下一个功能创建你的第一个 Custom Command如/pr相关资源Cursor 官方文档MCP 协议规范GitHub:cursor/rules示例仓库搜索