如何让 Claude Code 给整个项目做一次“产品级代码审查”?一个 prompt 搞定

五一节后回来,看到马斯克租赁算力,助力 Claude Code 额度增加,大喜!

既然额度放开了,那第一反应肯定是:不能浪费。

对于之前的多个项目进行梳理总结,形成一个「让 Claude Code 给整个项目做一次"产品级代码审查"」 的 prompt,如下:

markdown 复制代码
请对当前项目做一次完整的通篇检测与产品级审查。

要求:先不要直接修改代码,除非发现项目无法启动、构建失败或明显阻塞级 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 条可执行任务,每条任务必须包含:
任务名称 | 修改范围 | 目标效果 | 验收标准

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

我是安东尼(tuaran.me),一名专注于前端与 AI 工程化的独立开发者。

我在建设 「博主联盟」------连接AI产品方与技术博主的品牌增长平台,帮AI产品精准触达开发者,也帮博主拿到推广资源与成长机会。

同时也在做 「前端下一步」------一个聚焦前端、AI Agent 与大模型的技术情报站,帮你从技术革新焦虑中解脱,得到技术转向判断。

希望以上内容对你有所启发。

相关推荐
198******126346 小时前
2026深度解读:Work Agent长程任务的技术机制与落地能力
人工智能
老金带你玩AI6 小时前
别只让AI解释,让它做个你能看懂的东西
人工智能
iffy16 小时前
Deepseek hardness 桌面版 + ollama
人工智能
Xiaofeng36936 小时前
知漫剧入门科普:一站式工作台一句话生成漫剧
人工智能
“AI国潮设计-小江”7 小时前
《Python+SDXL实战:用ControlNet精准控制“英歌舞翻糖吐司”构图,附批量生成脚本》
开发语言·人工智能·python·prompt·aigc
MobotStone7 小时前
万物皆插件:DeepSeek Harness 底层揭秘,脚手架如何蜕变为产品
人工智能
youdexiang7 小时前
Android录音软件时间关键词检索功能分析
java·人工智能
WUYOUGYLU8 小时前
大模型时代:人与智能的共同进化
人工智能
netkiller-BG7NYT8 小时前
基于图像识别的人工智能中医望诊方案
人工智能·百度
W***25928 小时前
Work Agent深度解读:AI长程任务的执行机制与落地形态
人工智能