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

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

相关推荐
来让爷抱一个2 小时前
MonkeyCode 多模型切换技巧:什么时候用 Claude/GPT/DeepSeek
人工智能·ai编程
李白你好2 小时前
AI Agent 架构的自动化渗透测试工具
运维·人工智能·自动化
2601_949499942 小时前
8 大工业光模块供应商选型:芯瑞科技 400G OSFP 助力 AI 算力集群升级
人工智能·科技
温柔只给梦中人2 小时前
NLP学习:注意力机制
人工智能·学习·自然语言处理
广州灵眸科技有限公司3 小时前
瑞芯微RV1126B开发板(EASY-EAI-PI2) Easy-Eai编译环境准备与更新
服务器·前端·人工智能·python·深度学习
深度学习lover3 小时前
<数据集>yolo樱桃识别<目标检测>
人工智能·深度学习·yolo·目标检测·计算机视觉·数据集·樱桃识别
深圳市机智人激光雷达3 小时前
技术筑牢安全冗余:激光雷达在自动驾驶高阶感知中的底层价值与范式演进
人工智能·安全·机器学习·3d·机器人·自动驾驶·无人机
江澎涌3 小时前
拆解与 AI 的一次对话
人工智能·算法·程序员
lqqjuly3 小时前
神经架构搜索深度解析(Neural Architecture Search, NAS)
人工智能·知识图谱
AI刀刀3 小时前
Kimi 保存 pdf 显示该页的尺寸超出范围令人困扰,AI 导出鸭一键修复参数,导出 PDF 更顺畅
人工智能·pdf·ai导出鸭