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

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

相关推荐
罗小罗同学3 分钟前
华西医院联合多伦多大学、盛京医院等机构发布多模态智能体检索模型,实现 AI 循证推理全链条权威可溯
大数据·人工智能·机器学习·医工交叉·医学ai
研究点啥好呢13 分钟前
途游游戏AI产品经理面试题精选:10道高频考题+答案解析
人工智能·游戏·产品经理
KG_LLM图谱增强大模型16 分钟前
从数据孤岛到知识融合:用友大型本体模型LOM如何赋能企业知识管理和智能决策
人工智能·知识图谱
码以致用16 分钟前
用 DeepAgents 自动分析表格数据,一键生成图表与报告
人工智能·ai编程
码上掘金21 分钟前
基于深度学习的行人计数与人群密度分析系统设计与实现
人工智能·深度学习
北京软秦科技有限公司26 分钟前
灌封胶耐候测试报告为何更依赖“AI报告审核”?IACheck如何提升长期环境可靠性判断精度
人工智能
程序员果子29 分钟前
Agent设计手册:四层架构、工程约束、框架选型
人工智能·agent·智能体·agent框架
2401_8322981032 分钟前
SaaS 到 Agent-as-a-Service——OpenClaw 生态爆发,开启企业数字化新时代
人工智能
AI产品测评官40 分钟前
2026年AI招聘架构深潜:多Agent协同如何打造主动出击智能体代表?
人工智能·架构
captain_AIouo1 小时前
Captain AI:全阶段适配不同规模OZON商家
大数据·人工智能·经验分享·aigc