在Cursor中通过cursor.json配置userPerspective字段并结合提示词模板,可生成贴合真实用户操作路径的上线检查清单。需严格命名文件、定义具体角色与动宾任务,并支持三种触发方式。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

在Cursor中为上线检查清单添加用户视角提示词,能让AI生成的检查项真正贴合真实用户的操作路径和痛点,避免工程师自嗨式罗列。
明确用户角色与核心任务
打开项目根目录下的 cursor.json 或新建该文件,确保它位于工作区顶层。这个文件是Cursor识别自定义提示词的唯一入口,【文件名必须严格为 cursor.json,大小写不能错】。
在文件中定义 "userPerspective" 字段,值为一个对象,包含 role 和 primaryTask 两个必填键。role 不要写“产品经理”或“测试”,而是具体到人——比如 "刚入职两周的安卓端新用户";primaryTask 必须是动宾短语,如 "完成首次银行卡绑定"。
构建用户视角提示词模板
方法一:直接注入 prompt 字段
在 cursor.json 的 rules 或 prompts 数组中新增一条规则,type 设为 "checklist",prompt 字段写成:「请从 【{role}】 的角度出发,列出他在执行 【{primaryTask}】 时可能卡住、误解或漏做的3个关键动作。每个动作必须可验证、不可抽象,例如‘点击右上角三个点图标’而非‘注意操作引导’。」
Agents 正在你的整个代码库中处理越来越复杂、运行时间更长的任务。本次版本引入了新的 agent 框架改进,以实现更好的上下文管理,并在编辑器和 CLI 中带来了许多提升使用体验的修复。
方法二:用变量引用外部文案
在项目里新建 ./prompts/user-checklist.txt,把上面那段提示词完整粘贴进去。然后在 cursor.json 中写:"prompt": "${file:./prompts/user-checklist.txt}"。这一步能避免 JSON 内嵌引号混乱,【路径必须以 ./ 开头,且文件需真实存在】。
触发检查清单的三种调用方式
第一步:选中某段前端代码 → 右键 → “Ask Cursor” → 输入 “生成上线前用户视角检查清单”
第二步:在编辑器底部状态栏点击 Cursor 图标 → 弹出输入框 → 直接粘贴指令 “/checklist user:安卓新用户 task:绑卡”
第三步:在 Git 提交前,光标停在 commit message 行 → 按 Ctrl+K(Win)或 Cmd+K(Mac)→ 输入 “user-checklist” → 回车。此时 Cursor 会自动提取本次变更涉及的 UI 文件路径,并代入你预设的 userPerspective 生成清单。

















