SuperAPI AI 工具集

windsurf-known-pitfalls

办公与效率

查看项目

更新于 10-15 23:30

技能介绍

用途:帮助开发者识别并规避 Windsurf IDE 使用中的常见错误,适用于新人上手、AI 工作流审查和使用审计。

前提:已安装配置 Windsurf,理解 Cascade 与 Supercomplete 的区别,了解工作区索引行为。

主要能力(十类陷阱):一、简单任务误用 Cascade(Cmd+L),应改用 Supercomplete(Tab)做行内补全、Cmd+I 做选区编辑;二、在单体仓库根目录打开工作区,应打开具体服务目录以减少噪音;三、Cascade 提示含糊,应写明文件路径、约束与预期输出;四、不审查直接接受全部改动,应阅读 diff、检查错误处理与签名、提交前跑测试;五、运行 Cascade 前未做 Git 检查点,应先 git add -A && git commit;六、与 GitHub Copilot、TabNine、Cody 等扩展冲突,应在设置中禁用;七、忽略 .windsurfrules 字符上限(单文件 6000、全局 6000、合计 12000、工作区规则单个 12000),超限会被静默截断;八、单次 Cascade 会话过长导致上下文退化,应一任务一会话并善用 Memories;九、在对话中粘贴密钥;十、未配置 deny 列表就开启 Turbo 模式,可能自动执行 rm -rf、git push --force 等命令,应在 cascadeCommandsDenyList 中添加危险命令。

用法:提供预 Cascade 检查清单脚本及功能、修复、重构三类提示模板,强调指定路径、约束、错误处理与不改动公共 API。

限制:资料未说明各功能的收费标准、具体版本要求或平台支持范围,相关信息暂未提供。