demolisted
Install: claude install-skill chilohwei/decidekit
# Demo
基于已通过 review 的 PRD 生成可验证核心体验的交互 Demo。默认推荐 React + Vite + TypeScript + Tailwind CSS + shadcn/ui + Radix primitives + lucide-react + Cloudflare Pages，除非项目上下文已有固定技术栈。Demo 根目录必须包含 `docs/`，存储 PRD 与产品、UI、UX、前端、后端、可测性、部署等角色文档。
## 必须声明
- Demo 类型：Concept / UX / Engineering。
- 覆盖的主路径。
- Mock 数据与真实逻辑边界。
- 不做的生产能力。
- Cloudflare Pages preflight：build command、output dir、env、routing、preview URL 验证。
- Demo 成功/失败判定：它验证什么，不验证什么。
- Preview URL：可运行 Demo 必须记录 local preview URL；Cloudflare URL 只在用户批准部署后产生。
## Demo 根目录文档契约
生成 Demo 时必须在 Demo 根目录创建 `docs/`，最低包含：
```text
docs/prd.md
docs/product-spec.md
docs/ui-design.md
docs/ux-design.md
docs/frontend-engineering.md
docs/backend-integration.md
docs/test-plan.md
docs/cloudflare-deployment.md
docs/demo-verification.md
docs/vet.md
docs/techspec-notes.md
docs/demo-docs-manifest.json
```
文件名可以按项目调整，但必须有辨识度，并在 manifest 中登记。
可用脚本：
```bash
decidekit demo ./demo --name "Demo Name"
node scripts/scaffold_demo.mjs --root ./demo --project-name "Demo Name" --force
node scripts/validate_demo_docs.mjs --root ./demo
```
## 输出格式
- Demo objective
- User journey
- Pages
- Components
- State model
- Mock data
- Fake vs real boundary
- Implementation plan
- Local run commands
- Cloudflare preflight
- Demo verification checklist
- Preview URL
- `docs/` role-document checklist and manifest
- Risks and open questions
## Gate
- Ready: Demo 能验证 PRD 主路径，fake/real 边界清楚，`docs/` 契约完整，并记录 preview URL。
- Blocked: PRD 未通过 review，核心路径不明，或 Cloudflare preflight 缺 buil