Skip to content

feizhen/vibe_coding_pro

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

7 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Vibe Prompts

一个基于 Claude Code 的完整产品设计工作流项目,用于将产品创意快速转化为详细的产品规格文档(PRD)和可交互的 UI 原型。

项目简介

本项目提供了一套端到端的产品设计工作流,通过 AI 驱动的方式帮助产品经理、设计师和创业者:

  • ✨ 将初步的产品创意结构化为专业的 PRD
  • 🎨 从参考 App 截图中提取设计系统
  • 🚀 自动生成完整的 React UI 原型
  • 🔄 实现从创意到可视化原型的端到端闭环

核心功能

1. 产品管理工作流 (/pm)

将产品创意转化为详细的 PRD 文档。

特点:

  • 专业的产品思维:基于资深产品专家的思维模型
  • 协作式咨询:通过苏格拉底式提问引导深化思考
  • 结构化输出:完整的产品定位、功能规划、技术架构、商业模式

2. UX 设计工作流 (/ux)

从参考图片生成设计系统并实现完整 UI 原型。

特点:

  • 自动提取设计模式:颜色、字体、组件、布局等
  • 多方案设计:每个功能提供多个设计方案供选择
  • 即时可视化:生成可运行的 React 组件
  • 响应式设计:支持移动端和 Web 端

目录结构

.
├── .claude/
│   ├── commands/              # 自定义斜杠命令
│   │   ├── pm.md             # /pm 命令:生成 PRD
│   │   └── ux.md             # /ux 命令:生成 UI 设计
│   └── scripts/              # 执行脚本
│       ├── prepare_pm.py     # PM 工作流脚本
│       └── prepare_ux.py     # UX 工作流脚本
├── agent-prompts/             # Agent 提示词模板
│   ├── product-manager.md    # 产品经理 Agent 模板
│   └── ux-designer/          # UX 设计师 Agent 模板
│       ├── design-system.md           # 设计系统提取
│       ├── app-overview-generator.md  # PRD 生成
│       └── vibe-design-template.md    # UI 实现
├── documents/
│   ├── designs/              # 生成的设计系统
│   ├── prds/                 # 生成的 PRD 文档
│   └── ux-design/            # 最终 UI 提示词
├── ideas/                    # 产品创意输入文件
│   └── image_to_ds.md       # 示例:图片转设计系统
├── images/                   # 参考图片(按 App 名称分目录)
│   └── cherrypick/          # Cherrypick App 参考截图
├── my-app/                   # React UI 展示应用
│   ├── src/
│   │   ├── App.js
│   │   └── GoalAchievementShowcase.js
│   └── package.json
├── CLAUDE.md                 # 项目指南(给 Claude Code 的说明)
└── README.md                 # 本文件

快速开始

前置要求

  • 安装 Claude Code
  • Python 3.x(用于运行辅助脚本)
  • Node.js 和 npm(用于运行 React 应用)

完整工作流示例

步骤 1:创建产品创意文件

ideas/ 目录下创建一个 markdown 文件:

# 创意描述

[描述你的产品创意、目标用户、核心价值]

# MVP 功能范围

1. 功能 1
2. 功能 2
...

步骤 2:生成产品规格文档

在 Claude Code 中运行:

/pm --file ideas/your-idea.md

系统会启动一个 AI 产品经理与你对话,最终生成完整的 PRD 文档到 documents/prds/ 目录。

步骤 3:收集参考设计

将参考 App 的截图放到 images/app-name/ 目录下(支持 PNG、JPG、WebP 等格式)。

步骤 4:生成 UI 设计原型

运行 UX 设计工作流:

/ux --dir images/app-name --idea ideas/your-idea.md --prd documents/prds/your-prd.md

系统会:

  1. 从参考图片中提取设计系统
  2. 基于 PRD 生成 UI 实现提示词
  3. 在 React 项目中实现完整的 UI 组件

步骤 5:查看 UI 原型

启动 React 开发服务器:

cd my-app
npm start

在浏览器中访问 http://localhost:3000 查看生成的 UI 原型。

产品规格文档模板

生成的 PRD 文档包含以下章节:

  1. 产品核心定位

    • 电梯演讲
    • 问题陈述
    • 目标用户
    • 独特价值主张
    • 核心用户体验
  2. 产品规划

    • 目标平台
    • 功能架构(用户故事 + 验收标准)
    • UX/UI 设计要点
  3. 技术与架构

    • 技术栈建议
    • 架构设计要点
  4. 商业模式

    • 变现策略
    • 定价方案
  5. MVP 与迭代路线图

    • MVP 范围
    • 产品演进路径
  6. 风险与挑战

  7. 成功衡量标准

  8. 项目里程碑与资源需求

设计系统提取

UX 工作流会从参考图片中自动提取:

  • 色彩调色板:主色、辅色、功能色
  • 排版系统:字体、字号、字重、行高
  • 组件样式:按钮、卡片、输入框、导航等
  • 间距系统:基础单位、内外边距、网格
  • 圆角和阴影:视觉层次和深度
  • 交互动效:过渡时间、缓动曲线

示例项目

目标达成助手

一个完整的示例项目,展示从创意到 UI 的全过程:

  • 创意文件ideas/image_to_ds.md
  • PRD 文档documents/prds/1-prd-image-to-design-system.md
  • 设计系统documents/designs/cherrypick_design_system.md(基于 Cherrypick App)
  • UI 原型my-app/src/GoalAchievementShowcase.js

功能模块:

  1. 认证与引导(登录、注册、引导流程)
  2. 目标管理(创建、编辑、追踪目标)
  3. AI 路径规划(智能学习路径生成)
  4. 学习日志记录(记录学习过程)
  5. 智能总结(AI 生成学习总结)
  6. 进度可视化(数据统计和图表)

每个模块提供 3 个不同的设计方案(共 18 个移动端界面)。

React 应用技术栈

  • React 19.2.0 - UI 框架
  • Tailwind CSS 3.4.18 - 样式框架
  • Lucide React 0.545.0 - 图标库
  • Create React App - 项目脚手架

常用命令

# 启动开发服务器
cd my-app && npm start

# 构建生产版本
cd my-app && npm run build

# 运行测试
cd my-app && npm test

工作流特点

产品管理工作流

  • 专业的产品思维:基于资深产品专家的思维模型,提供深度分析
  • 结构化输出:生成的 PRD 包含完整的产品定位、功能规划、技术架构、商业模式等
  • 协作式咨询:通过提问引导,而非直接给出答案,帮助深化思考
  • 可执行性强:文档包含明确的验收标准、优先级和迭代路线

UX 设计工作流

  • 智能设计系统提取:自动识别设计模式和视觉规范
  • 多方案设计:为每个功能提供多个设计变体供选择
  • 即时可视化:生成可运行的 React 代码,立即查看效果
  • 设计一致性:确保所有界面遵循统一的设计系统
  • 响应式支持:移动端和 Web 端适配

自定义配置

修改产品经理 Prompt

编辑 agent-prompts/product-manager.md 来自定义产品经理的角色定位和输出格式。

修改 UX 设计模板

编辑 agent-prompts/ux-designer/ 下的模板文件来调整:

  • 设计系统提取的详细程度
  • PRD 生成的结构和内容
  • UI 实现的要求和规范

调整工作流脚本

修改 .claude/scripts/ 下的 Python 脚本来调整工作流逻辑。

最佳实践

  1. 创意阶段:尽可能详细地描述产品创意,包括目标用户、核心价值、主要功能
  2. PRD 生成:与 AI 产品经理充分对话,澄清所有关键问题
  3. 参考图片:选择设计风格接近的 App 截图作为参考(6-10 张为宜)
  4. 设计系统:检查生成的设计系统,确保符合品牌调性
  5. UI 原型:基于生成的原型进行迭代优化

常见问题

Q: 可以使用多个 App 的截图作为参考吗? A: 建议使用单一 App 的截图以保持设计一致性。如需混合风格,可以手动编辑生成的设计系统。

Q: 生成的 UI 代码可以直接用于生产环境吗? A: 生成的代码主要用于原型展示和设计验证,建议经过重构和优化后再用于生产。

Q: 如何修改已生成的 UI? A: 可以直接编辑 my-app/src/ 下的组件文件,或者调整设计系统后重新生成。

Q: 支持哪些设计风格? A: 支持任何风格,只要提供相应的参考图片。系统会自动提取设计模式。

贡献指南

欢迎提交 Issue 和 Pull Request 来改进这个工作流!

贡献方向

  • 新的 Agent 提示词模板
  • 更多的设计系统示例
  • UI 组件库扩展
  • 工作流优化建议
  • 文档改进

License

MIT

联系方式

如有问题或建议,请提交 Issue。

致谢

本项目基于 Claude Code 构建,感谢 Anthropic 提供强大的 AI 能力。

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors