☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
技术文档应以可验证实体为主语,用场景化动词绑定触发条件与结果,并嵌入版本号、路径、错误码等不可篡改数据锚点,避免“cursor”重复开头削弱专业性。
你在给cursor写sql优化提示词时,反复出现“cursor支持重写join”“cursor可以分析执行计划”“cursor能够生成索引建议”这类句式,导致技术文档像产品说明书,读者一眼扫过去全是“cursor”开头,专业感和可信度直线下降。
把“Cursor”主语替换成真实技术主体
第一步:通读初稿,用荧光笔标出所有以“Cursor”开头的句子。
第二步:对其中60%以上的句子执行主语替换——把“Cursor”换成动作发出者或结果承载者。例如:“Cursor支持多模型切换” → “开发者可在设置中自由切换Claude、GPT与Gemini模型”;“Cursor可以生成SQL” → “该查询逻辑被自动转译为符合PostgreSQL 15语法的SQL语句”。
第三步:保留不超过3处“Cursor”作主语,且仅用于强调产品能力边界的关键陈述,如“Cursor不缓存跨会话的用户代码片段”,这种否定式断言必须由产品主体承担责任。
用被动语态+可验证技术实体替代工具主语
方法一:把“Cursor解析TypeScript类型” → “TypeScript类型声明由AST解析器提取并映射至JSON Schema”。
方法二:直接删除工具主语,用技术动词开头。“Cursor自动补全React Hook” → “useSWR与useMutation调用自动注入依赖数组与错误处理分支”。
【关键点】技术主语必须真实存在且可验证,禁用“系统”“平台”“工具”等模糊指代——读者能对应到具体文件、函数或配置项才算过关。
用场景化动词绑定触发条件和可观测结果
❌ “Cursor支持自定义规则文件”
✅ “你在项目根目录新建.cursorrules后,Next.js API路由生成即刻遵循RLS策略规范”。
这一步要检查每个动词是否绑定明确触发条件(如文件创建、快捷键按下、配置变更)和可观测结果(如代码插入、弹窗出现、终端输出)。没有触发条件的动词属于空泛描述,必须删改。
每段嵌入不可篡改的数据锚点
v0.42.3引入@symbol引用语法
.cursorrules需置于src/app/api/同级目录才生效
当globs匹配失败时返回ERR_CURSOR_GLOB_404
没有数据锚点的句子一律视为待删草稿——它们无法被读者复现,也不构成有效知识传递。










