你是不是也有过这样的经历?兴冲冲地开始一个新项目,结果半路发现缺这少那,要么是配置文件没准备好,要么是项目目标不够清晰,最后不得不停下来返工。如果你用 Claude Code 开发过项目,这种挫败感可能更强烈——明明 AI 很强大,为什么还是会陷入混乱?
今天要分享的这套 PSB 系统,来自一位资深 AI 产品经理在构建了几十个 Claude Code 项目后总结出的实战经验。它不是什么高深的理论,而是一套简单实用的三步法,能让你的项目从启动那一刻起就保持清晰高效。
什么是 PSB 系统?
PSB 是三个英文单词的首字母缩写,代表项目启动的三个阶段:
📋 Plan(规划):在写代码前先想清楚要做什么
⚙️ Setup(配置):为 Claude Code 准备好所有工具和环境
🔨 Build(构建):真正开始编码和开发功能
听起来很简单对吧?但就是这三步,能让你的开发效率提升好几倍。
第一阶段:Plan - 规划决定成败
很多人打开 Claude Code 的第一件事就是开始写代码,这恰恰是最常见的错误。花 15 分钟做好规划,能帮你省下几个小时甚至几天的返工时间。
🤔 先回答两个核心问题
在开始之前,拿出笔记本或打开文档,认真回答这两个问题:
问题 1:你到底想做什么?
这听起来像废话,但很关键。你是想:
学习一个新技术?
验证一个想法可不可行?
做一个能给真实用户用的产品?
还是只是做个原型看看效果?
目标不同,做法完全不同。比如你只是做原型,那就专注核心功能,快速验证想法,不用纠结代码质量。但如果要给真实用户用,就得考虑安全性、错误处理这些细节了。
问题 2:分几步走?
把项目拆成清晰的阶段:
第一版(MVP)要做成什么样?
哪些功能可以留到后面做?
第二版、第三版各做什么改进?
一般来说,想清楚一个 MVP 和一到两个改进版本就够了。
💡 让 AI 帮你规划
这里有个小技巧:不要自己苦思冥想,让 AI 来帮你提问。
你可以这样问:
“我想做这个项目,为了成功完成 MVP,我需要回答哪三个最重要的问题?”
或者直接用 Claude 或 ChatGPT 的语音模式聊聊,让 AI 帮你整理思路,最后生成一份 markdown 文档作为起点。特别是想法还比较模糊的时候,这招特别管用。
📝 写一份项目规格文档
规格文档包含两部分:
1. 产品需求
回答三个问题:
谁用:产品是给谁用的?
为什么用:解决什么问题?
怎么用:产品应该做什么?
这里要注意,别写得太抽象。比如不要只说”用户可以创建日记”,而要说”用户打开应用看到空白页,可以添加照片,可以编辑历史记录,具体流程是……”越具体越好。
2. 技术需求
主要包括两块:
选技术栈
如果你不确定用什么技术,可以让 Claude Code 帮你做个调研报告。如果你已经有想法,这里有一套推荐的 Web 应用技术组合:
前端:Vercel + Next.js + Tailwind + Shadcn
后端:MongoDB 或 Supabase
认证:Clerk
支付:Stripe
邮件:Resend
AI 功能:Anthropic + Google Gemini
定架构
说清楚系统怎么设计、各部分怎么交互、数据库怎么设计、API 怎么定义。如果你在公司团队里干活,这部分要写详细点,方便团队协作。
对了,在开始写代码前,记得把基础设施都准备好:数据库建好、域名注册好、API 密钥都创建好。
💡 要点总结
明确项目目标,不要盲目开始
把项目分解成清晰的里程碑
写详细的需求文档,越具体越好
选好技术栈,准备好所有基础设施
第二阶段:Setup - 配置是效率的基础
配置阶段可能看起来有点繁琐,但这是磨刀不误砍柴工。把这七步做好,后面开发会顺利得多。
📦 步骤 1:建 GitHub 仓库
强烈建议从一开始就建好 Git 仓库,理由有四个:
随处编码:可以在电脑、平板、手机上用 Claude Code
自动化流程:用 GitHub CLI 和 Actions 处理 PR、Issues
一键部署:很多平台(比如 Vercel)可以直接连 GitHub 部署
基于 Issue 开发:把 Issues 当作任务清单,可以多个 Claude Code 实例同时干活
小提示:每个大功能用新分支开发,完成后再合并到主分支。
🔐 步骤 2:准备环境变量
让 Claude 根据你的技术栈生成一个 .env.example 文件,然后复制一份填上真实的密钥和凭证。这样 Claude 就能直接用,不用三天两头问你要密钥了。
📄 步骤 3:配置 claude.md 文件
这个文件是项目的”记忆”,每次和 Claude Code 对话都会读取它。但要记住一个原则:保持简洁。
应该包含什么?
项目目标和架构概览
设计风格和用户体验准则
约束和规则(比如”永远不要直接推到主分支”)
仓库规范(什么时候用 PR,分支怎么命名)
常用命令(构建、测试命令)
如果内容太多怎么办?用链接。在 claude.md 里提到重要文件,告诉 Claude 需要时去看那些文件。
这个文件不用一次写完美,在开发过程中慢慢完善就行。
📚 步骤 4:建自动化文档系统
除了 claude.md,还要准备几份文档,让 Claude 在需要时查阅:
architecture.md:系统设计和组件交互
changelog.md:项目变更历史
project-status.md:当前进度和下一步计划
功能文档:比如
onboarding.md、payments.md等
怎么保持更新?在 claude.md 里加一条指令,让 Claude 工作时自动更新这些文档。或者创建一个自定义命令,完成功能后跑一下。
🔌 步骤 5:安装插件
插件是给 Claude Code 加功能的扩展包,能让开发更快更简单。
推荐三个:
Anthropic Frontend Plugin:专门优化前端开发
Anthropic Feature Dev Plugin:简化功能开发流程
Every Compound Engineering Plugin:一整套实用命令和子代理
用 /plugins 命令就能管理这些插件。
🔗 步骤 6:连接 MCP 服务器
MCP(Model Context Protocol)是连接外部工具的桥梁。比如:
数据库 MCP(MongoDB 或 Supabase):让 Claude 能直接操作数据库
Playwright MCP:自动测试网页功能
Vercel MCP:一键部署
Linear MCP:管理项目任务
安装很简单,按文档里的命令操作就行,通常就是一行命令的事。
⚡步骤 7:设置命令和子代理
Slash 命令和子代理有什么区别?
Slash 命令:快捷方式,和主对话用同一个上下文
子代理:专门干一件事的独立代理,有自己的上下文
推荐的子代理:
Planning 子代理:帮你规划任务
Codebase Search 子代理:搜索代码库
Changelog 子代理:自动更新变更日志
Frontend Testing 子代理:专注前端测试
Retro 子代理:开发后反思改进
推荐的命令:
/commit和/pr:提交更改Feature Dev 相关命令
自定义的更新文档命令
✓ 两个高级技巧
技巧 1:预配置权限
提前批准常用操作(比如 git 命令、编辑文件),避免 Claude 老是问你”可以吗”。不然你去泡杯咖啡回来,发现 Claude 还在等你批准,那可太尴尬了。
技巧 2:设置 Hooks
Hooks 是自动运行的脚本,可以在特定时刻触发。比如:
Stop Hook:Claude 完成任务后自动检查测试
Notification Hook:需要权限时在 Slack 通知你
虽然听起来高级,但试试看,能大幅提升效率。
💡 要点总结
GitHub 仓库是基础,从一开始就要建好
claude.md要简洁但信息丰富用文档系统让 Claude 记住项目状态
插件和 MCP 能省很多事
预配置权限和 Hooks 让开发更顺畅
第三阶段:Build - 开始真正的开发
前面两步做好了,这一步就轻松多了。
✓ 构建 MVP
把项目规格文档准备好,让 Claude 根据它来构建第一版。
专业技巧:要求 Claude 尽可能使用并行子代理,能同时处理项目的多个部分,速度快得多。
记住:始终先用计划模式,让 Claude 把规格转化成实施计划,结果会好很多。
✓ 三种开发工作流
流程 1:通用流程(适合单个功能)
四个步骤:
研究:让 Claude 做技术调研(可选)
计划:用计划模式分解任务(最重要!)
实施:Claude 自动使用你配置的所有工具
测试:验证功能是否正常
推荐使用 Feature Dev 命令,它会自动走完这个流程。
流程 2:基于 Issue 的开发(适合大项目)
核心思想:把 GitHub Issues 当作任务清单。
不是直接给 Claude 下命令
而是创建 Issues 描述要做的事
然后让 Claude 处理这些 Issues
好处是:
项目更有条理
可以多个 Claude 实例并行干活
用子代理同时修多个 bug
流程 3:多代理开发(最高级)
同时运行多个 Claude Code 实例,每个处理不同的功能。
关键技术是 Git Worktrees:它让你能在不同目录里同时处理不同分支,互不干扰。
完成后让 Claude 把各个分支合并起来就行。这招很强大,但需要一点学习成本。
🚀 四个提升效率的技巧
技巧 1:用最好的模型
Opus 4.5:规划和复杂任务
Sonnet:日常开发主力
Haiku:简单 bug 修复
别为了省钱用差的模型,好模型犯错少,长远看反而省时间省钱。
技巧 2:定期更新 claude.md
每次添加新功能或达到新里程碑时更新。可以创建个自定义命令,让 Claude 自动更新文档并提交 git。
技巧 3:防止重复犯错
Claude 犯错时,别只是改掉继续。键盘敲个 # 号,给 Claude 一个指令,它会自动更新到 claude.md 里,下次就不会再犯同样的错了。
技巧 4:别怕推倒重来
代码很便宜。如果某个功能怎么都搞不定,特别是在原型阶段,直接删掉重新写可能更快。反正有 Git,什么都丢不了。
💡 要点总结
先规划再实施,用计划模式
根据项目规模选合适的工作流
用好模型,定期更新文档
别怕推倒重来,快速迭代
写在最后
PSB 系统看起来步骤不少,但其实都是些实实在在的技巧。你不需要一次全用上,挑几个适合自己的先试试,慢慢就会体会到好处。
最重要的是:花时间规划,做好配置,然后放心构建。这三步走好了,用 Claude Code 开发项目会变成一件很享受的事。
记住,这不是什么高深的理论,而是经过几十个项目验证的实战经验。试试看,你也能让自己的项目从第一天起就井井有条。
📚 信息来源
视频标题:How I Start EVERY Claude Code Project
作者:Avthar Sewrathan(AI with Avthar)
作者背景:拥有十年技术经验的 AI 产品经理和创业者
发布时间:2024 年 12 月 17 日
视频时长:约 33 分钟
本文基于该视频内容整理改写,旨在以更通俗易懂的方式分享 Claude Code 项目开发的实战经验。
