什么是 PSB 系统？

PSB（Plan-Setup-Build）是专门为 Claude Code 设计的项目开发框架，由开发者 Avthar 在构建数十个项目后总结而成。这套方法论能将项目启动效率提升约 10 倍，特别适合 AI 辅助开发场景。

PSB 的核心理念是：先规划再动手，用 15 分钟的前期思考，节省数小时的后期返工。

为什么需要 PSB？

传统的”即兴式”开发在 AI 辅助场景下问题尤为突出：

  • 方向模糊：没有清晰规格，AI 容易误解需求
  • 环境混乱：缺少配置，开发中频繁中断
  • 代码无序：像”没有蓝图就盖房子”，后期难以维护

PSB 通过结构化的三个阶段解决这些痛点。

阶段一：Plan（规划）—— 15 分钟定方向

核心任务

明确项目目标和技术路线，输出一份项目规格文档。

关键步骤

1. 明确项目定位

  • 这是验证想法的原型，还是面向用户的产品？
  • 里程碑是什么？（如：MVP → 完整功能 → 优化版本）

2. 借助 AI 辅助思考

  • 提示词示例：”针对这个想法，问我三个最关键的问题”
  • 使用语音模式自由讨论，再让 AI 生成 Markdown 总结

3. 编写规格文档

规格文档分为两部分：

产品需求（PRD）

  • 解决什么用户痛点？
  • 核心交互流程是什么？
  • 示例（日记应用）：
    • 打开应用显示空白页还是引导提示？
    • 支持添加照片吗？如何编辑已有日记？

工程需求（EDD）

  • 技术栈选择（推荐组合）：
    • 托管：Vercel
    • 框架：Next.js
    • UI：Tailwind + Shadcn
    • 数据库：Supabase / MongoDB
    • 认证：Clerk
    • 支付：Stripe
  • 不确定技术选型？让 Claude 根据需求推荐

注意事项

  • 保持文档轻量，避免上下文过载
  • 需求要具体，防止 AI 误解

阶段二：Setup（设置）—— 7 步配置环境

这个阶段将 Claude Code 打造成”完美调校的开发仪器”。

7 步清单

步骤 具体操作 核心价值
1. 创建 GitHub 仓库 启用 Actions、配置 Vercel 自动部署 版本控制 + 自动化部署
2. 配置环境变量 创建 .env.example，填充 API 密钥 避免开发中频繁中断
3. 编写 claude.md 项目”记忆库”：目标、架构、风格指南、约束条件 确保 AI 始终理解项目上下文
4. 自动化文档 设置 architecture.md、changelog.md、project_status.md
指示 Claude 自动更新		 长期维护项目上下文，便于中断后恢复
5. 安装插件 Anthropic 前端插件、特性开发插件等 扩展功能，输出更精准
6. 集成 MCP Model Context Protocol：数据库、Playwright 测试、Vercel 部署 AI 直接操作工具，自动化测试和部署
7. 自定义命令 创建斜杠命令（如 /update-docs）和子代理 自动化重复工作流

核心：claude.md 文件

这是整个系统的灵魂，包含：

  • 项目目标：一句话说明在做什么
  • 技术架构：技术栈和文件结构
  • 风格指南：代码规范、UI 风格偏好
  • 约束条件：如”禁止直接推送到 main 分支”
  • 文档链接：指向其他配置文档

进阶技巧

  • 预批准常用操作（如 git 提交）
  • 设置自动化钩子（如测试失败自动修复、Slack 通知）

阶段三：Build（构建）—— 实现与迭代

三种工作流

1. 通用工作流（单功能开发）

适合简单项目，流程：

  1. 研究：查阅 API 文档
  2. 计划：使用 plan 模式分解任务
  3. 实现：借助插件和 MCP 工具
  4. 测试：验证功能

2. 基于 Issue 的工作流

适合团队协作或复杂项目：

  • 用 GitHub Issues 组织任务
  • AI 自动创建和关联 Issues
  • 适合 Bug 追踪和功能管理

3. 多代理工作流

适合并行开发多个功能：

  • 使用 git worktree 创建隔离副本
  • 多个 Claude 实例同时处理不同功能
  • 合并时集中审查

生产力技巧

模型选择策略

  • Opus 4.5：复杂规划和架构设计
  • Sonnet：日常功能实现
  • Haiku：快速修复小问题

关键实践

  • 每次新功能完成后更新 claude.md
  • 出现错误时，用 # 注释添加规则防止回归
  • 大胆丢弃代码：AI 重写成本低，别怕推倒重来

工作流对比

工作流 适用场景 优势 局限
通用 小型项目、单功能 简单直接 串行开发，效率有限
基于 Issue 团队协作、长期项目 组织清晰、可追溯 需要管理开销
多代理 复杂项目、并行开发 效率最高、隔离性好 需要熟悉 git，合并有难度

适用场景与局限

最佳适用场景

  • Web 应用快速原型
  • MVP 到生产级应用的迭代
  • 个人开发者或小团队项目

需要调整的场景

  • 移动应用：调整 MCP 配置
  • 大型团队：增加协作文档
  • 非代码项目：概念可复用，但需简化

核心局限

  • 上下文限制：文档需保持精简
  • 学习曲线：高级功能（如钩子）需要时间掌握

PSB 代表的思维转变

传统开发：人写代码，工具辅助
AI 原生开发：人负责策略，AI 执行战术

PSB 系统的本质是：

  1. 规划阶段：人确定”做什么”
  2. 设置阶段：建立人机协作的”对话规则”
  3. 构建阶段：AI 在规则内高效执行

这种模式正在成为 AI 时代软件开发的新范式。