Cursor AI生成Button组件文档前,必须先输出5项以上结构化判断标准,包括技术栈兼容性、Props分组要求、TypeScript注解强制性、JSX语法限制及语言规范,确认无误后才进入文档编写阶段。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

你需要让Cursor AI在生成组件使用文档前,先明确判断标准,避免它直接跳进写文档的流程却遗漏关键约束条件,比如是否要包含Props表格、是否需标注必填项、是否要示例代码块、是否适配当前项目技术栈。
让AI先输出判断标准再写文档
第一步:在Chat窗口中输入指令,强制AI暂停执行、先做判定。
输入:/judge-doc-requirements for React component "Button"
第二步:等待AI返回结构化判断清单,它必须列出5项以上具体标准,例如:
• 是否需兼容Next.js App Router(根据当前项目路径自动识别)
• Props是否需按 required/optional 分组
• 示例代码是否必须含 TypeScript 类型注解
• 是否禁用 JSX 语法糖(如 Fragment 缩写)
• 文档语言是否限定为中文且禁用英文术语混排
第三步:核对AI返回的标准是否覆盖你的真实需求。若某条缺失(如没提“是否要截图演示”),立即追加提问:“补充判断:是否需要插入Figma设计稿截图链接?”
【AI不会主动补全未被触发的判断维度,漏问=默认不执行】
用规则文件固化判断逻辑
方法一:在项目根目录创建 .cursorconfig.json,写入自动触发判断的规则:
"rule": "当用户请求生成组件文档时,必须先输出 '判断标准' 小节,列出当前项目技术栈、文件位置、TSX/JSX类型、团队文档模板URL、是否启用JSDoc继承这五项判定依据,禁止直接写正文"
方法二:用 .cursor/rules.json 全局配置匹配逻辑(仅限 macOS/Linux):
在 ~/.cursor/rules.json 的 rules 数组中添加:
{"match": "**/src/components/**", "prompt": "你正在为React组件写文档。第一步:输出5条必须验证的判断标准,每条以'✓'开头;第二步:仅当用户回复'确认'后,才开始写文档正文"}
手动触发双阶段提示词
选中组件文件 → Ctrl+K → 输入“Write doc with judgment first” → 回车 → 在提示框中粘贴以下内容:
请分两阶段响应:
阶段一:输出「判断依据」,严格按以下顺序检查并陈述:
① 当前文件路径是否属于 /src/components/ 或 /app/components/
② 文件扩展名是 .tsx 还是 .jsx
③ 组件是否导出 default,还是具名导出
④ 项目 package.json 中 react 版本是否 ≥18
⑤ 当前光标所在行是否含 JSDoc 注释块
阶段二:收到我回复‘执行’后,再按团队文档模板生成 Markdown 文档


















