Vibe Coding 方法论 · 第 3 节

PlayGround:组件的试衣间

UI 功能直接写进页面,改一处影响一片,调一个按钮要把整个页面跑起来。解法是先做独立的组件 PlayGround:每个 UI 元素有单独的 demo,调好了再集成进正式页面。

交互演示一 · 现场体验一个迷你 PlayGround

下面就是一个最小的 PlayGround:左边是组件的实时预览,右边是参数控制。随便调,这里怎么改都不会影响页面上任何其他东西,这就是「隔离调试」。

组件预览 · PrimaryButton
参数控制

在 PlayGround 里调

刚才的每一次调整,影响范围只有这一个 demo。样式和业务逻辑互不干扰,调好的参数直接抄进正式组件,集成时它已经是成品。

直接写进页面会怎样

同样是调这个按钮:先把整个页面跑起来,登录、拉数据、切到目标状态,才能看到它一眼。样式和业务逻辑纠缠在一起,圆角改大了可能挤歪旁边的布局,牵一发动全身。

和 Storybook 的关系

思路一致,成本不同。Storybook 是行业标准方案,但配置太重,对 AI 辅助的快速原型项目属于 overkill。PlayGround 取其思路:用一个静态页面把所有组件 demo 排在一起,改组件不影响业务逻辑,调业务逻辑不搞乱组件样式,成本几乎为零。

三条维护规则
何时创建

涉及动效必须先建

涉及页面动效时,必须先创建静态页面 PlayGround,用于自由调整和测试组件,之后才允许写进正式页面。

同步更新

需求变了 demo 跟着变

需求变化后必须同步更新 PlayGround,保证 demo 始终反映组件的最新形态,别让它变成过期的摆设。

只增不删

取消的需求 demo 也保留

demo 组件只增改、不删除。功能需求取消了,对应 demo 也要留着,它是设计过程的历史存档,未来复活需求时直接捡回来用。

交互演示二 · 情景选择题:这条 demo 怎么处理

三个真实情景,点选你认为正确的做法,看判定和理由。

AI 对话项目的特殊要求

必须有对话测试页

项目涉及 AI 对话功能时,PlayGround 中必须实现简单的对话测试页面,脱离完整业务流程也能单独调一轮对话。

列出所有提示词

页面上必须列出项目用到的所有 Prompt。提示词是 AI 产品的核心资产,藏在代码字符串里没法调试,摊开在页面上才能快速对比和调整。

本节要点

组件先在试衣间里调好,再走上台。PlayGround 用一个静态页面的成本,换来组件与业务逻辑的双向隔离。

素材来源:对应 rule-opensource.mdc 第三章「PlayGround 组件页规范」,仓库 itshen/xs_vibe_rules