Free Preview
先试读：Claude Code上线前检查清单
用 Claude Code 做上线前检查，最重要的不是让它说“可以上线”，而是让它尽可能找出不能上线的理由。比如链接 404、移动端按钮被挡、搜索索引没同步、付费页面没接权限、静态资源路径错、登录状态下展示不一致。
一个可靠的上线检查，应该覆盖三个层面：代码有没有改对、用户能不能正常用、线上环境能不能稳定访问。
这篇能解决什么问题
- 把一句模糊需求改成 AI 能执行、你能验收的任务卡。
- 知道执行前要先检查哪些文件、风险点和验证命令。
- 避免 AI 顺手改无关内容，最后只交付可审、可回退的改动。
付费后能看到哪些内容
- 上线前检查不是求安心，而是找出“还不能上线”的证据
- 先查文件清单：你不能上线自己都说不清的改动
- 链接、图片、CSS、JS、搜索索引，都要按正式路径检查
- 只在电脑上看一遍，不算上线前检查
可以先照着试的一句话
这是我要改的功能：___。请先阅读项目结构，列出会动哪些文件、风险点和验证命令；等我确认范围后，再开始做最小改动。
试读到这里先判断是否对你的任务有用；完整文章会继续展开步骤、案例、模板和避坑细节。
上线前检查不是求安心，而是找出“还不能上线”的证据
如果检查只是在确认自己想上线，那它就失去了意义。
用 Claude Code 做上线前检查，最重要的不是让它说“可以上线”，而是让它尽可能找出不能上线的理由。比如链接 404、移动端按钮被挡、搜索索引没同步、付费页面没接权限、静态资源路径错、登录状态下展示不一致。
一个可靠的上线检查，应该覆盖三个层面：代码有没有改对、用户能不能正常用、线上环境能不能稳定访问。
代码层
语法、构建、测试、文件同步、改动范围。
体验层
页面可访问、按钮可点、移动端不遮挡、内容不溢出。
线上层
正式域名、静态资源、缓存、备份节点、回滚路径。
先查文件清单：你不能上线自己都说不清的改动
上线前第一张表，应该是本次实际改动文件表。
假设模拟项目本次新增了 3 篇文章，同时更新入口页和搜索索引。那么检查清单至少应该包含：文章 HTML、入口页、搜索索引、共享样式是否变化、是否动了登录或付费脚本。
| 文件类型 | 检查重点 | 常见问题 |
|---|---|---|
| 文章页 | 标题、描述、TOC、正文、付费墙、脚本位置 | TOC 锚点缺失、正文没有放进付费区、路径写相对地址 |
| 入口页 | 卡片标题、链接、统计数字、分类导航 | 文章写好了，但入口仍然是旧弹窗或旧链接 |
| 搜索索引 | 标题、摘要、URL、分类、标签 | 新增文章搜索不到，或 URL 写错 |
| 共享脚本 | 登录、权限、支付、统计 | 为了修单页问题误改全站逻辑 |
请在上线前只读检查当前模拟项目：
1. 列出本次实际改动文件
2. 按文章页、入口页、搜索索引、共享样式、共享脚本分类
3. 说明每个文件为什么需要改
4. 标出是否触碰登录、权限、支付、数据库、部署脚本
5. 如果有不属于本次任务的改动，请单独列出链接、图片、CSS、JS、搜索索引，都要按正式路径检查
很多上线事故不是逻辑错，而是路径错。
静态网站或内容型网站最容易出现的问题，是本地能打开，线上路径错。比如本地用相对路径 ../js/paywall.js 看似能跑，但线上目录层级变化后就失效。工具专项文章尤其要检查 /cc/shared.css、/cc/tools/tool-article.css、/js/auth.js、/js/paywall.js 这类绝对路径。
文章直链
每篇新文章都要能直接打开，而不是只从入口页能点进去。
入口页链接
卡片点击应进入正式文章，不保留占位弹窗。
搜索索引
新增文章必须能被搜索到，URL 必须是正式站内路径。
静态资源
CSS、JS、图片、备案图标都要线上 200。
只在电脑上看一遍，不算上线前检查
移动端会暴露很多桌面端看不出来的问题。
如果用户大部分时间用手机访问，移动端检查就不是附加项。Claude Code 可以帮你列出需要用浏览器验证的交互：导航是否关闭、分类栏是否遮挡、按钮是否可点、长标题是否换行、卡片是否撑破、付费弹窗是否挡住返回入口。
登录、付费、发送、上传，必须单独列为高风险检查
这些功能一旦出错，影响通常比页面样式严重得多。
如果本次改动触碰会员权限、支付、邮件发送、数据同步、外部 API，就不能只做普通页面检查。你要让 Claude Code 明确说明：这次是否改了这些文件；如果改了，是否需要测试账号、沙盒环境、人工确认；如果没改，也要确认页面有没有依赖它们。
不要为了让页面能看，绕过登录判断；不要为了调试方便，把付费内容直接放到免费区域；不要在测试时向真实用户发送邮件或消息；不要把真实密钥、真实客户数据写进示例。
请检查本次上线是否涉及高风险能力：
- 登录 / 注册
- 会员权限 / 付费墙
- 支付 / 订单
- 数据库写入 / 删除 / 迁移
- 邮件、短信、Webhook、外部消息发送
- 文件上传、同步、部署脚本
请逐项说明：
1. 是否被本次改动触碰
2. 如果触碰，风险是什么
3. 需要哪些验证
4. 哪些操作必须人工确认后才能执行上线完成后，还要证明线上真的更新了
部署命令执行成功，不等于用户访问到的页面已经正确。
部署后要验证正式域名，而不是只看本地文件。对于有备份节点、缓存或多台服务器的项目，还要确认每个线上入口都能访问。你可以让 Claude Code 输出线上验证 URL 清单，包括入口页、文章直链、CSS、JS、搜索索引和关键页面。
- 本次改动文件已经按类型列清楚。
- 入口页、文章页、搜索索引已经同步。
- 桌面端和移动端关键交互已经验证。
- 登录、权限、付费、支付、外部发送没有被误改。
- 正式域名和必要备份节点已经返回正确内容。
- 知道如果出问题应该回滚哪一次提交或哪一组文件。