把你的想法,变成 Claude Code 可以直接执行的开发文档包
🏗️ 6 个 AI 角色 · 5 个开发阶段 · 0 技术门槛
你有一个产品想法,但不会写代码。
你知道 Claude Code 可以帮你开发,但不知道怎么跟 AI 说清楚需求。
你试过直接让 AI「帮我做一个 APP」,结果 AI 要么问一堆你听不懂的技术问题,要么做出来完全不是你要的东西。
AI 产品开发工作室 是一个运行在 Claude Code 里的多 Agent 工作流系统。你只需要带着想法进来,AI 团队会引导你一步步把想法变成专业的开发文档包——需求、架构、界面、任务拆解一应俱全,交给 Claude Code 就能开始开发。
你的一句话想法
↓
AI 团队引导
↓
5 份标准文档
↓
Claude Code 执行
↓
你的产品上线
| 角色 | 职责 |
|---|---|
| 🎯 产品经理 | 全程陪同,控制流程节奏 |
| 🔍 需求分析师 | 四轮对话梳理功能需求 |
| 🏗️ 技术架构师 | 基于多维度决策框架选型 |
| 🎨 UI/UX 设计师 | 核心页面提供多方案选择 |
| 📋 开发规划师 | 拆解可执行任务序列 |
| 🛟 执行教练 | 开发阶段实时辅助 |
| ✅ 质量审核官 | 贯穿全程三重检查 |
- 基于判断而非模板:技术架构师按五维度决策框架做真实工程判断,不再机械查表
- 执行阶段全程辅助:新增
~debug、~verify、~skip三个指令,从文档包到产品落地零断层 - 三重质量审核:多维度打分 + 仿真测试 + 结构化对账,文档质量达标标准提升到 90 分级别
- 前置审查机制:每个角色开工前审查上游文档,发现模糊立即报告,不猜不脑补
- 发散-收敛设计:核心页面并行生成 2-3 个差异化方案,让小白通过对比做选择
- 六条编码规范:自动内置到任务文档,Claude Code 执行时保持代码干净、行为规范
- Agent 间交接报告:每个阶段额外产出 handoff 文件,下游 Agent 快速抓取关键决策
- 全程中文,所有对话、文档、错误说明一律中文
- 不说术语,技术概念立刻用大白话解释,多用生活类比
- 给选项而非开放题,2-4 个选项让你选,不让你凭空想
- 固定称呼机制,监测上下文状态,接近上限主动提示
- 自动质量审核,每阶段产出自动检查,不达标打回重做
- Claude Code 已安装
- Claude 账号(建议 Pro 版,上下文更长)
- 一个产品想法(一句话也行)
npm install -g @anthropic-ai/claude-code第一步:下载并解压本项目
git clone https://github.com/binghe1980/ai-dev-studio.git
cd ai-dev-studio第二步:启动 Claude Code
claudeClaude Code 会自动读取 .claude/claude.md 加载工作室配置,显示欢迎语:
🏗️ AI 产品开发工作室已就绪
欢迎!我是你的产品经理,会带着你一步步把想法变成现实。
你不需要懂任何技术,只需要告诉我:你想做一个什么样的产品?
第三步:告诉 AI 你的想法
我想做一个读书笔记网站
接下来按提示走完五个阶段,就这么简单。
阶段零 · 项目初始化
你的想法 → project-config.md
↓ ~analyze
阶段一 · 需求分析
四轮引导式对话 → prd.md + handoff-prd.md
↓ ~architect
阶段二 · 技术架构
五维度决策框架 → tech-architecture.md + handoff-architecture.md
↓ ~design
阶段三 · UI 设计
发散-收敛多方案 → ui-design.md + handoff-ui.md
↓ ~plan
阶段四 · 开发规划
任务拆解+执行指令 → dev-tasks.md
↓ ~deliver
阶段五 · 交付打包
outputs/dev-package/ ← 完整文档包
↓ 交给 Claude Code
执行阶段(v3 新增)
~debug 报错卡壳时诊断
~verify 任务完成后验证
~skip 跳过任务影响评估
每个阶段都由质量审核官自动审核,平均分 ≥ 8 分且通过仿真测试和结构化对账才能进入下一阶段。
| 指令 | 功能 |
|---|---|
~help |
查看使用说明和当前进度 |
~analyze |
启动需求分析 |
~architect |
启动技术架构设计 |
~design |
启动 UI/UX 设计 |
~plan |
启动开发任务规划 |
~deliver |
打包交付文档 |
~status |
查看完整进度报告 |
~review |
查看最近一次审核详情 |
~redo [阶段] |
重新执行某阶段(自动提示下游影响) |
~modify [阶段] |
局部修改某阶段产出 |
| 指令 | 功能 |
|---|---|
~debug [任务] |
执行卡壳时的三象限诊断 |
~verify [任务] |
按清单逐项引导任务验证 |
~skip [任务] |
评估跳过任务的影响级别 |
完成所有阶段后,outputs/dev-package/ 目录里有:
outputs/dev-package/
├── dev-tasks.md ⭐ 核心交付物(AI 执行手册)
├── prd.md 产品需求文档
├── tech-architecture.md 技术架构方案
├── ui-design.md 界面设计文档
├── project-config.md 项目基础信息
├── handoff-prd.md 阶段交接报告(v3)
├── handoff-architecture.md
├── handoff-ui.md
└── README.md 手把手使用说明
把整个文件夹交给 Claude Code,按 dev-tasks.md 任务顺序执行就行。
| 用户类型 | 说明 |
|---|---|
| 💡 有想法的创业者 | 有产品想法但没有技术合伙人,也没有外包预算 |
| 📱 想自己做工具的普通人 | 想做记账、笔记、日程管理等自用小工具 |
| 📚 知识付费内容创作者 | 想给课程/社群做专属平台或演示完整工作流 |
| 🏢 中小企业管理者 | 想做内部管理系统或客户管理工具,降低外包成本 |
| 🎓 学习 AI 开发的新手 | 想入门 AI 辅助开发,以工作室为完整学习案例 |
| 🔧 有编程基础的开发者 | 会写代码但产品思维和文档写作不是强项 |
核心升级
- 🆕 新增执行教练 Skill,补全从文档包到产品落地的断层
- 🆕
~debug/~verify/~skip三个执行阶段指令 - 🆕 质量审核官加入仿真测试和结构化对账,三重检查机制
- 🆕 UI 设计师对核心页面支持发散-收敛多方案设计
- 🆕 每个 Sub Agent 加入前置审查机制,不猜不脑补
- 🆕 每个阶段产出 handoff 交接报告,下游 Agent 快速获取决策
- 🔧 技术架构师从决策树升级为五维度决策框架
- 🔧 五个 SKILL 的 description 按最佳实践重写,触发准确度提升
- 🆕 新增六条 Claude Code 行为规范(中文回复、先描述方案、禁止兼容补丁等)
- 🆕 固定称呼机制,用于监测上下文状态
- 🆕 上下文预警规则,对话过长主动提示保存
- 🆕
~redo下游影响提示机制 - 🆕 阶段零工作量预估功能
- 🆕 技术架构覆盖桌面软件和命令行工具
- 🆕 部署方案区分国内外用户
- ✅ 六角色分工 + 五阶段流水线 + 四文档编号引用 + 自动质量审核
- ✅ 十个基础指令覆盖完整流程
Q: 我完全不懂技术,真的能用吗?
A: 可以。整个系统设计哲学就是面向不懂技术的小白:
- 所有对话用中文、不说术语
- 技术决策 AI 帮你做,你只需要做非技术层面的选择
- 遇到问题 AI 会用日常语言解释,不会让你看不懂
- 每一步都有具体操作,复制粘贴就能用
Q: 我需要准备什么?
A: 四样东西:
- 一个产品想法(一句话就够)
- 安装 Claude Code
- Claude 账号(建议 Pro 版)
- 耐心回答问题(AI 问你的时候如实回答)
你不需要:编程经验、技术知识、了解数据库、懂 API、写过文档、用过命令行。
Q: 工作室本身会帮我写代码吗?
A: 不会。工作室只负责产出开发文档包,不写代码。代码由你拿文档包后让 Claude Code 执行。这种设计的好处是:
- 文档包是永久资产,可以重复使用、分享、迭代
- 不同 AI 编程工具都能用这份文档包
- 执行阶段有执行教练辅助,遇到问题随时求助
Q: 对话太长了,AI 会不会忘记之前说过的内容?
A: 工作室有三重保护机制:
- 固定称呼监测:AI 每次回复都以你的名字开头,当不再称呼说明上下文满了
- 主动预警:对话过长时主动提醒你保存进度
- 落盘机制:每个阶段产出立即写入文件,不依赖对话记忆
开启新会话后,把 docs/ 文件夹里的文档重新放入项目目录,就能无缝继续。
Q: 可以用其他 AI 编程工具吗,比如 Cursor?
A: 产出的文档包是标准 Markdown 格式,理论上 Cursor、Windsurf、GitHub Copilot 等都能读。但工作室本身的五阶段工作流依赖 Claude Code 的 Skill 系统,最佳体验在 Claude Code 中。
Q: 文档生成后想修改怎么办?
A: 两种方式:
~redo [阶段]:整个阶段重做,AI 会提示下游文档是否也需要更新~modify [阶段]:局部修改,保留其他内容
重做会自动检测下游影响,避免文档间悄悄错位。
欢迎贡献!如果你有任何建议或遇到问题:
- 提交 Issue 报告 Bug 或建议新功能
- Fork 项目做自己的改进
- 发 Pull Request 合入主分支
MIT License,可自由商用。
这是冰河(Binghe)持续打磨的 AI 工作流系统之一。同系列还有:
- 📝 LOFTER 同人文写作 Skill
- 🎨 PPT 网页设计师 Skill(十大世界级设计风格)
- 📱 短视频内容超级操盘手 Agent
- 🧭 思维罗盘思维框架 Skill
- 🎙️ OmniVoice macOS 语音输入工具
关注冰河(知识星球 · 公众号),获取更多 AI 工具。
如果这个项目对你有帮助,请点一个 ⭐ Star
不是 AI 让一切变简单,而是让更多人的想法变得可能。