Cursor 和 Codex 改网页检查清单

这份清单用于判断网页修改任务该用 Cursor、Codex，还是先暂缓。完整解释见 Cursor 和 Codex 改网页有什么区别。你可以把它当成项目前的自检表，逐项填写后再报价或回复客户。

清单的目标不是证明某个工具一定更好，而是避免三个新手常见问题：没看清范围就动手、没确认权限就部署、没验证就交付。

适合谁

适合准备做网页修改小单、练习作品集、整理客户需求的新手。你可以用它判断任务是局部样式、组件修改、构建检查，还是需要客户权限的部署事项。

也适合已经有一个仓库但不确定从哪里开始的人。先填清单，再决定用 Cursor 边看边改，还是用 Codex 做项目级排查。

不适合谁

不适合没有仓库、没有截图、没有验收标准却要求马上报价的情况。信息太少时，清单只能帮你列问题，不能替你确认最终范围。

也不适合高风险项目。只要涉及生产数据、支付、账号安全、域名、环境变量或客户私密后台，就要先暂停，把权限和责任写清楚。

任务信息

• 客户原始需求：
• 页面链接：
• 截图或录屏：
• 设计稿或参考站：
• 需要改的页面：
• 需要改的组件：
• 是否有仓库权限：
• 是否需要部署：

如果这些信息缺失，不要急着给最终报价。可以先回复客户要材料，或者只给一个诊断范围。

工具选择

适合 Cursor 的信号：

• 已经知道目标文件
• 主要是 CSS、文案、组件局部调整
• 你希望边看代码边问问题
• 改动可以在一个页面或少数文件内完成
• 你需要快速理解一段代码

适合 Codex 的信号：

• 不知道问题在哪个文件
• 需要搜索整个仓库
• 可能要修改多个文件
• 需要运行 lint、build 或测试
• 需要形成可复查的改动记录

如果两个工具都能做，优先按风险选。低风险局部修改可以在编辑器里完成；跨文件任务最好保留更完整的检查记录。

范围确认

在动手前确认这些问题：

• 只改桌面端，还是桌面和移动端都要改？
• 是否允许调整组件结构？
• 是否允许新增依赖？
• 是否需要保留现有配色和设计系统？
• 是否要兼容旧浏览器？
• 是否需要提交 PR？
• 是否由客户自己部署？

范围越模糊，越要先写清楚“不包含什么”。例如：本次只调整首页按钮样式，不包含重做整站设计、不包含后台配置、不包含生产部署。

权限检查

网页修改经常碰到权限边界。下面这些事项需要客户确认：

• GitHub 仓库协作者权限
• Vercel、Netlify 或服务器部署权限
• 域名管理权限
• 环境变量查看或修改权限
• CMS 后台权限
• 表单收件邮箱或 API key
• 生产数据访问权限

没有授权时，不要尝试替客户操作。可以把它写成明日待办：等待客户添加仓库权限；等待客户确认部署平台由谁操作；等待客户提供测试环境链接。

具体步骤

按顺序执行：先收集任务信息，再选择工具，然后确认范围和权限，接着做修改前检查，最后小步修改并验证。不要跳过权限检查直接部署，也不要在没有验收标准时扩大改动范围。

修改前检查

先运行或记录：

git status
npm install
npm run build

命令要按项目实际脚本调整。不是每个项目都有 build，也不是每个项目都用 npm。看到 pnpm-lock.yaml、yarn.lock 或项目 README 时，要按项目约定来，不要混用包管理器。

如果 git status 显示已有修改，先判断是不是用户或其他协作者的改动。不要为了让自己清爽而覆盖别人改过的文件。

修改中检查

• 每次只改一个明确问题
• 不做无关重构
• 不删除看不懂的代码
• 不随便升级依赖
• 不把调试截图、密钥、客户信息写进仓库
• 不把 AI 输出直接当最终答案

如果 AI 建议大范围重写，先要求它解释原因。解释不清，就缩小修改范围。

修改后验证

至少确认：

• 页面能打开
• 目标问题已经变化
• 桌面端没有明显错位
• 移动端没有文字溢出
• 导航和按钮还能点击
• lint 或 build 通过
• diff 里没有无关文件

如果你没有本地运行环境，交付时要写明“未能本地验证”的原因。不要把未验证内容说成已验证。

交付记录

建议按这个格式写：

Changed:
- Updated the hero button spacing on the homepage.
- Adjusted the mobile card layout to prevent overflow.

Verified:
- Ran npm run build.
- Checked desktop and mobile viewport locally.

Needs client confirmation:
- Deployment should be handled from the client's Vercel account.

这个格式能把已经完成的事情和客户侧待办分开。对新手来说，清楚记录比漂亮措辞更重要。

风险提醒

这份清单不能替代真实测试。即使 AI 工具给出看似合理的修改，也要人工确认 diff、移动端效果和构建结果。客户未授权的平台设置、账号操作和部署动作，都要单独列为待确认事项。

暂缓信号

遇到下面情况，先暂停：

• 客户要求先完成完整测试再谈范围
• 需求包含生产数据库、支付或账号安全
• 客户只给一句话但要求固定时间交付
• 需要你登录客户私人账号
• 需要修改域名、DNS、环境变量但没有授权说明
• 你无法复述验收标准

暂停不是放弃，而是避免把不清楚的风险带进交付。

CTA：下一步

把这份清单复制到你的项目记录里，先填写任务信息、工具选择和权限检查。需要拆客户需求时用 Proposal 生成器，需要估算范围时用 项目报价助手。

免责声明

本文只用于学习和项目前自查，不构成职业、法律、安全或收入承诺。真实项目需要遵守客户平台规则、工具官方说明和代码仓库要求，并经过人工复核。