Cursor 与 Agent

Cursor 是基于 VS Code 的 AI IDE：Chat、Composer、Agent 可跨文件读写、跑终端。CodeRoadMap 本站讲义与部分功能开发也常用 Cursor 起草——规则（Rules）与技能（Skills） 用来约束行为，不是替代审查。

学习目标

• 区分 Chat、Composer、Agent 的权限边界
• 会用 .cursor/rules 或项目规则表达工程约定
• 安全使用 Agent（命令、多文件 diff）

三种模式

模式	典型用途	风险
Chat	问答、小片段建议	低，不自动改盘
Composer	多文件编辑、可控 diff	中，需看 diff
Agent	搜索、改码、跑 shell	高，误删/误跑可能

原则：Agent 能做的事越多，合并前人工 diff 越不能省。

Rules 与 Skills

• Rules：持久指令，如「Java 用 Google Style」「不写 .env 进上下文」「改 backend 必跑 mvn test」
• Skills：可复用的任务剧本（写讲义、做 PR 等）

写 CodeRoadMap 课程 draft 时，规则可包含：

• 中文结构、约 50–70 行、含学习目标 / 练习 / 小结
• 交叉链接 testing-essentials、git-essentials
• 禁止 编造仓库中不存在的路径

Rules 减少风格漂移，不能消除幻觉。

负责任地写讲义 draft

推荐流程：

outline.yaml → @ 引用 gha-intro.md 等样例
            → Agent/Composer 生成 ai-*.md draft
            → 人工：事实、链接、代码块、语气
            → git commit（见 git-workflow）

不要 把生产数据库连接串、用户 PII 贴进 Chat。不要 假设 Agent 读过整个 monorepo——显式 @ 相关文件。

Agent 安全清单

• 合并前 全文 diff，尤其删除与 rm -rf
• 终端命令：看清再批准；拒绝不明 curl | bash
• 密钥：用环境变量，prompt 里只用占位符
• 大改分 PR：对齐 git-merge 的小步合并

与 Copilot 的分工