← ClaudeAtlas

choosing-prototype-formlisted

决定原型该用什么做时使用——HTML 静态稿、React Mock 工程还是先写方案文档;用户说"把 HTML 原型转成 React""做个原型""做客户演示 Demo"时。按阶段和不确定点路由:方向没定先 HTML,方向收敛上 React Mock(统一 API 层+六态覆盖),技术路线未定先写方案;禁止 HTML 机械硬转 React、禁止原型冒充正式代码或冻结契约。/ Use when deciding whether to build an HTML prototype, a React Mock project, or a written spec first. Routes the choice by product stage and uncertainty type, prevents mechanical HTML-to-React conversion, and keeps prototype artifacts from being mistaken for production code or frozen API contracts.
zhaiby-web/ai-coworker-skills · ★ 0 · API & Backend · score 76
Install: claude install-skill zhaiby-web/ai-coworker-skills
# Choosing Prototype Form ## Core Rule The prototype form is chosen by what is still uncertain, not by what the tool can generate. Exploration-stage uncertainty (product shape, layout, user path) → HTML. Converged-direction validation (interaction, state flow, API behavior, edge states) → React Mock. Implementation-path uncertainty → written spec first, no prototype yet. A prototype of either form is never production code, and its fields are never frozen API contracts. "It runs" proves nothing about "it ships". ## Selection Table | Situation | Choice | Why | |---|---|---| | Product shape undecided | Text flow + HTML | Validate direction fast; avoid premature engineering | | Layout / user path undecided | HTML | Cheap to change, good for frequent restructuring | | Technical implementation path undecided | Spec document, no React yet | A runnable prototype gets mistaken for a technical decision | | Direction converged | React Mock | Validates interaction, state, and data-link behavior | | Formal customer demo | React Mock | Clickable full paths; HTML demos die at "点不了、跳不了、状态变不了" | | Handing to engineers for task breakdown | React Mock + delivery doc | Yields draft API contracts and component inventory | | HTML prototype already exists | Rebuild as React Mock, never convert | See Anti-Pattern below | | Early customer requirement talks | HTML | Customers judge entrance, flow, and information — not state machines | ## Anti-Pattern: Mechanical HTML → React Conversion Convert