一、核心框架6 段式 Prompt 结构Cursor 的 Agent 对结构化指令的解析远优于段落式描述。官方推荐的 Prompt 遵循以下 6 段式模板 模块作用示例写法Goal一句话定义产出可衡量Goal: 为 /invoices API 添加分页保留现有筛选和排序Context指向相关文件/当前行为用锚定Context: 后端逻辑在 src/api/invoices.ts当前无分页参数Constraints必须遵守的边界库、风格、安全、兼容Constraints: 使用现有 Zod 校验不改数据库 Schema不引入新依赖Examples给 1-2 个输入/输出示例消除歧义Example: 请求 ?page2limit20 应返回第 21-40 条Output Format明确要 diff / 文件列表 / 计划 / 测试报告Output: 每个改动文件提供 unified diff附测试用例Verify要求自测、边缘 case 覆盖、运行命令Verify: 运行 pnpm test列出 5 个 edge cases 并确认覆盖黄金公式社区总结版具体任务 技术要求 上下文引用() 预期结果二、上下文工程符号体系Cursor 的上下文精度直接决定输出质量。不要把整段代码贴进聊天框而是用精确引用 类型适用场景注意事项file/folder指向具体文件或目录最常用优先于codebasecodebase全局语义搜索高风险——等于把排序交给 Cursor 的 reranker建议配合具体文件使用docs引用外部文档如框架官方文档对训练数据少的框架如 Svelte 5必用git引用 Git 历史 / diff用于对比变更或追溯notepad跨 Composer 共享上下文适合记录项目关键信息、API 约定最佳实践这是后端 /backend.py这是前端 /frontend.js现在去 __________远比codebase去 __________精准 。三、项目级规则.cursorrules Custom Commands1..cursorrules项目根目录这是 Cursor 的“持久系统提示词”一次配置全项目生效。官方建议保持精简聚焦核心约定 # 代码规范 - 新模块放在 src/features/ 下按功能域组织 - 错误处理统一使用现有 ResultT, E 模式不抛裸异常 - 命名函数 camelCase类型 PascalCase常量 SCREAMING_SNAKE_CASE # 安全护栏 - 禁止修改公共函数签名除非附带迁移方案 - 禁止新增依赖除非用户明确要求 - 不得记录 secretstoken 必须哈希存储 # 命令手册完成前必须执行 - 运行 pnpm lint pnpm test 通过后再标记完成 - 修改后更新相关文档标注日期引用代码行号进阶技巧对训练数据少的框架先把官方文档喂给 Cursor让它生成.cursorrules实现“AI 教 AI” 。2. Custom Commands设置 → Commands把高频 Prompt 固化为/命令效率提升约 80% 命令Prompt 内容/reviewReview selected code, focus on: performance, security, standards, potential bugs. Provide specific fixes./testGenerate unit tests for selected function using existing framework, 80% coverage, include edge cases./refactorRefactor selected code to optimize time complexity and readability. No behavior change. Add tests to prove equivalence./docsGenerate JSDoc for selected function/class: description, params, return value, usage examples.四、工作流模式Plan → Implement → VerifyCursor 官方支持Plan Mode对非 trivial 的改动强制“先计划、后执行” Step 1: Plan only. No code. → 输出步骤清单 涉及文件 风险点 Step 2: Implement the approved plan. → 输出按文件组织的 diff 测试 简要验证说明 Step 3: Verify and iterate. → 运行测试、检查集成点、清理临时文件关键原则Chain of Prompts Chain of Thought拆成“计划 → 代码 → 测试 → 文档”多轮比单轮大 Prompt 更稳定任务链闭环Task A 暴露问题 B → 理解 B → 修复 B → 再标记完成不要停在第一个问题用词精确用Rewrite触发全量重写用Change容易得到补丁式修改五、可复用 Prompt 模板库以下模板直接复制可用按场景分类 场景Prompt 模板预期产出功能规划Plan only. Goal: {目标}. Context: 文件 目录. Constraints: {约束}. Output: 步骤计划 改动文件 风险点.60 秒内可审阅的计划功能实现Implement the approved plan. Follow existing patterns in 参考文件. Output: unified diffs per file tests testing notes.可编译、有测试、风格一致安全重构Refactor 文件 to reduce complexity. Constraints: no behavior change. Add/adjust tests to prove equivalence. Output: diffs before/after explanation.更简洁 测试证明等价Bug 调试Reproduce the bug based on: {复现步骤}. Instrument with logs if needed. Propose 2 likely root causes, then implement fix with tests.根因明确、修复最小、防回归测试生成Add tests for 文件. Cover happy path and edge cases: {列表}. Use existing test framework. Output: diffs only.聚焦、匹配现有工具链API 文档Generate API docs for 文件. Output: Markdown with endpoints, request/response examples, error cases.teammate 无需再问六、模型选择策略成本控制Cursor 支持多模型切换按任务复杂度选择可显著降本 模型适用场景成本定位GPT-4复杂架构设计、关键 Bug 修复、新功能规划高Claude Sonnet日常编码、Code Review、重构、生成测试中推荐主力GPT-3.5 / Cursor-small简单修改、代码格式化、生成注释、文本翻译低七、3 周渐进上手路线社区验证版周次目标每日动作Week 1快捷键 符号用CmdI(Composer) 处理至少 1 个多文件任务练习 8 种用法每日 3 次Week 2上下文管理写 1 份.cursorrules用 Notepad 记录关键约定复杂任务强制走 Plan ModeWeek 3Prompt 优化 成本控制创建 3-5 个 Custom Commands按“黄金公式”写 Prompt简单任务切 GPT-3.5总结Cursor 的 Prompt 工程是“明确目标 精准上下文() 刚性约束 计划先行 验证闭环”的工程系统。先把.cursorrules和 Custom Commands 配好再按 6 段式模板写 Prompt效率和质量会显著区别于“随便聊”的使用方式。