Claude Code产品级代码审查：一个Prompt搞定全项目

五一假期收官的首个工作日，一条消息刷屏——马斯克租赁算力，直接拉爆Claude Code的可用额度。看到这种信号，第一反应就是：不能让这批算力闲置。结合此前多个项目的落地经验，我整理出一套可实操的方案，将「让Claude Code对整个项目执行一次产品级代码审查」封装为完整Prompt。直接上内容：

请对当前项目做一次完整的通篇检测与产品级审查。要求：先不要直接修改代码，除非发现项目无法启动、构建失败或明显阻塞级 Bug。请先完成审查报告，并且所有结论都要尽量给出对应文件路径、页面位置、组件名或复现方式。请按以下步骤执行：

1. 项目基础探查
   - 阅读 package.json、README、路由配置、入口文件、核心页面、组件目录、样式目录、接口封装、状态管理、构建配置。
   - 尝试识别项目类型、技术栈、页面结构、核心业务流程。
   - 如项目支持启动、构建、lint 或 test，请优先运行相关命令，并记录结果。

2. 严重 Bug 检测
   请重点检查：
   - 启动、构建、lint、类型检查是否报错
   - 页面是否存在运行时报错、空值异常、接口异常未兜底
   - 路由跳转、按钮点击、表单提交、数据加载是否存在断点
   - 是否存在重复请求、状态不同步、刷新丢数据、异常状态无提示
   - 权限、环境变量、接口地址、上传下载、文件处理等是否有明显风险

3. 交互体验检测
   请检查：
   - 用户进入页面后是否知道下一步做什么
   - 关键按钮是否有 loading、disabled、成功、失败反馈
   - 弹窗、表单、空状态、错误态、加载态是否完整
   - 移动端、窄屏、不同分辨率下是否存在明显问题
   - 操作链路是否过长、信息是否过载、是否需要新手引导

4. UI 与视觉设计检测
   请检查：
   - 首页、核心功能页、详情页、后台页的信息层级是否清晰
   - 字体、间距、颜色、卡片、按钮、图标、阴影、圆角是否统一
   - 是否存在页面风格不一致、模块边界不清、视觉重心混乱的问题
   - 是否需要统一设计规范、组件规范、页面模板

5. 参考市面成熟产品给建议
   请参考常见 SaaS 官网、AI 工具站、开发者平台、内容社区、后台管理系统的成熟设计方式，判断当前项目可以借鉴哪些方向。建议要具体，避免泛泛而谈，比如：
   - 首页信息架构怎么调整
   - 导航怎么设计
   - 数据看板怎么呈现
   - 功能入口怎么组织
   - AI 问答/工具类页面怎么增强可信度和可用性
   - 登录、空状态、帮助说明、用户引导是否需要补齐

6. 代码结构与工程质量检测
   请检查：
   - 是否存在组件过大、逻辑耦合、重复代码、命名混乱
   - 是否需要拆分 components / hooks / utils / services / constants / types
   - 是否需要统一接口封装、错误处理、日志处理、类型定义
   - 是否存在未来难以扩展的目录结构或数据流问题
   - 是否有性能问题，如无效渲染、大资源、图片未优化、首屏加载慢

最终请输出《项目通篇检测报告》，严格按以下格式：

一、总体结论
用一段话说明当前项目整体质量、主要风险、最优先优化方向。

二、项目结构概览
用表格输出：模块/目录 | 作用 | 当前观察 | 风险点

三、严重 Bug 与阻塞问题
用表格输出：优先级 | 文件/页面 | 问题描述 | 复现方式/证据 | 影响范围 | 修复建议

四、交互与 UI 优化清单
用表格输出：优先级 | 页面/模块 | 当前问题 | 参考方向 | 具体优化建议

五、代码结构与工程质量建议
用表格输出：优先级 | 文件/模块 | 当前问题 | 改造建议 | 改造收益

六、参考成熟产品的设计建议
请按：
- SaaS 官网方向
- AI 工具站方向
- 开发者平台方向
- 后台管理系统方向
分别给出当前项目可借鉴的设计点。

七、优先级路线图
按 P0 / P1 / P2 输出：
- P0：必须优先修复的启动、构建、核心流程、严重 Bug
- P1：明显影响用户体验、转化、交互完整性的优化
- P2：长期可维护性、视觉一致性、性能体验优化

八、可直接交给 Claude Code 执行的任务列表
请输出 10～20 条可执行任务，每条任务必须包含：任务名称 | 修改范围 | 目标效果 | 验收标准

注意：
- 先审查，后建议，暂时不要大规模改代码。
- 不要只给抽象建议，每个问题尽量定位到具体文件、页面、组件或交互流程。
- 如果某些问题需要人工确认，请标记为“待确认”，并说明需要确认什么。

这套Prompt的设计逻辑非常直白：先摸清项目底细，再逐层排查严重Bug、交互体验和视觉风格；随后参考行业成熟产品的做法给出具体建议；最后落到代码质量和可维护性。输出报告格式也做了严格规范——总览结论、结构概览、Bug清单、UI优化、代码建议、竞品参考、路线图、执行任务，层层递进，拿到就能直接开工。 几个关键设计点：一是强调“先审查后动手”，避免一上来大改代码导致混乱；二是每个问题都必须落到具体文件或页面，拒绝抽象方向；三是需要人工确认的地方务必标清，便于团队二次判断。用这份Prompt做一次完整的项目体检，基本够用了。

来源：互联网