如何让 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 与大模型的技术情报站,帮你从技术革新焦虑中解脱,得到技术转向判断。

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

相关推荐
豪气的程序猿1 小时前
电商图片工作流怎么选?Lingko AI 对比折叠键盘主图与详情页
人工智能
小刘快学习2 小时前
把 AI 账单拆到部门:企业 AI 网关的精准分账思路
人工智能
米小虾2 小时前
你让监控模型读的思维链,可能是攻击者写好的剧本
人工智能
deepseek232 小时前
Iris 开源搜索智能体拆解:35B 与 397B 中文仅差 0.3 分,上下文管理胜过堆参数
人工智能·ai agent·开源模型
ai小陈2 小时前
CUDA Stream实战:让数据传输与GPU计算真正重叠
人工智能·深度学习·ai·pdf·云计算·gpu算力
residual_fan2 小时前
【学术论文】航空发动机故障诊断智能体:基于持续对比强化学习的动态优化方法
人工智能·算法·数据挖掘·数据分析
东风破_2 小时前
从 RAG 到 Agentic RAG:第二步,把复杂问题拆开再检索
人工智能
dehuisun2 小时前
第07篇:RAG+Agent 部署架构、资源评估与私有化方案
人工智能
米小虾2 小时前
拆给 8 个子智能体,只拿回 2.3 倍信息:多智能体分解的产出守恒律
人工智能·agent
虹科网络安全3 小时前
Redis 安全公告:CVE-2026-81934 TLS 处理漏洞及修复建议
网络·人工智能·网络安全