Claude Code一个Prompt实现项目产品级代码审查

五一假期结束后的首个工作日，一则消息迅速刷屏——马斯克通过租赁算力大幅提升了Claude Code的使用额度。这则消息让不少开发者为之振奋。 额度放开后，我的第一反应就是：绝不能浪费这份资源。于是，结合此前多个项目的实战经验，我整理出一套完整的提示词（Prompt），专门用于让Claude Code对项目进行一次产品级的代码审查。具体内容如下：

请对当前项目做一次完整的通篇检测与产品级审查。要求：先不要直接修改代码，除非发现项目无法启动、构建失败或明显阻塞级 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 条可执行任务，每条任务必须包含：任务名称 | 修改范围 | 目标效果 | 验收标准

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

这套提示词的设计逻辑非常清晰：先全面了解项目底细，再逐一排查严重错误、交互体验与视觉设计问题，然后参考行业成熟产品给出具体改进方向，最后聚焦代码质量与工程可维护性。最终输出的报告格式也做了明确规定——总体结论、结构概览、Bug清单、UI优化建议、代码改进建议、竞品参考、优先级路线图、可执行任务清单，层层递进，拿到即可落地执行。 几个值得关注的重点：一是强调“先审查后动手”，避免未经分析就大规模改代码造成混乱；二是每个问题都要求落实到具体文件或页面，杜绝空泛建议；三是需要人工确认的地方要明确标记，便于团队二次判断。这份提示词拿去给项目做一次全面的质量体检，非常实用。