Windsurf Production Checklist 是面向团队与企业部署的生产就绪检查清单，用于将 Windsurf 正式推广到团队生产环境。整体按四个阶段组织。
用途与前提：适用于将 Windsurf 推广至团队、准备企业部署的场景。前提条件包括：选择 Windsurf 套餐（Pro、Teams 或 Enterprise）；拥有 Windsurf 仪表盘的管理员权限；确定要推广的 Git 仓库；团队就 AI 使用政策达成一致。
第一阶段：部署前配置。工作区配置（按仓库）：创建 .windsurfrules 并写明项目技术栈、模式和约束；.codeiumignore 排除密钥、构建产物和大型二进制文件；.windsurf/rules/ 存放按 glob 触发的、面向特定文件类型的规则；工作区设置提交至 .windsurf/settings.json。安全方面：按公司政策配置遥测；.codeiumignore 覆盖所有密钥文件模式；对含密钥的文件类型（.env、.key）禁用自动补全；企业版需配置并强制 SSO/SAML，并与 Codeium 确认零数据保留。团队政策方面：创建并共享 AI 使用政策文档；为 AI 生成代码建立提交约定（如 [cascade] 前缀）；定义 AI 生成变更的代码审查要求；禁用相互竞争的 AI 扩展（Copilot、TabNine）。
第二阶段：团队入职。逐开发者设置通过脚本 scripts/setup-windsurf.sh 完成，脚本会检查 Windsurf 是否安装（windsurf --version，未安装则提示从 https://windsurf.com/download 安装）、检查 .windsurfrules 与 .codeiumignore 是否存在、安装推荐扩展 esbenp.prettier-vscode 与 dbaeumer.vscode-eslint、禁用冲突扩展 github.copilot，最后提示打开项目文件夹（而非 monorepo 根目录）以获得最佳 AI 上下文。培训清单包括：演示 Supercomplete（Tab）、Cascade（Cmd+L）与 Command（Cmd+I）的区别；演示 Write 模式与 Chat 模式；演示用 @ 提及提供文件上下文；演示 Turbo 模式及允许/拒绝列表；演示 UI 开发的预览功能；演示 Cascade 工作流前使用 Git 检查点；讲解 .windsurfrules；讲解积分系统与模型选择。
第三阶段：监控与优化。管理员仪表盘需每周跟踪指标：采用率（活跃用户数与总席位数，目标 >80%；日活跃用户，趋势上升）、质量（补全接受率，目标 >25%；Cascade 成功率，目标 >70%）、效率（每用户消耗积分，关注异常值；每日完成任务数，作为生产力代理指标）。季度审查包括：审计席位利用率并降级不活跃席位；审阅 .windsurfrules 并根据新模式更新；查看变更日志中的新功能；调查团队满意度与痛点；分析积分使用模式。
第四阶段：回滚流程。如果 Windsurf 引发问题：1）在管理员仪表盘中为团队关闭 Cascade（Admin Dashboard > Features > Cascade > Off）；2）开发者仍可使用非智能体形式的 Supercomplete；3）在调查期间转为手动编码；4）审查近期 Cascade 生成的提交是否存在问题；5）提交支持工单并附调试包（参见 windsurf-debug-bundle）。
错误处理表列出了问题、严重程度与缓解措施：Cascade 生成错误代码（中）——强制合并前测试通过政策；AI 在建议中暴露密钥（高）——审计 .codeiumignore 并轮换已暴露的密钥；团队未采用（低）——开展培训、分享生产力数据；冲刺中途积分耗尽（中）——监控用量并主动购买额外积分。
示例部分提供了推荐扩展集（.vscode/extensions.json，也适用于 Windsurf）：推荐 esbenp.prettier-vscode、dbaeumer.vscode-eslint、biomejs.biome；不推荐 github.copilot、tabnine.tabnine-vscode。快速合规检查脚本（set -euo pipefail）会检查 .windsurfrules、.codeiumignore 是否存在以及 .windsurf/rules 目录是否存在。
资源与后续步骤：提供 Windsurf Admin Guide、Windsurf Enterprise、Windsurf Security 等资源；版本升级参见 windsurf-upgrade-migration。
限制：文档未提供具体价格、套餐费用、平台支持的完整列表或效果承诺；上述指标目标值以原文为准，不构成效果保证。