文档到 Demo
怎么用
把本文件夹原样交给 AI，不要拆、不要只发其中一句摘要。
- Cursor / Claude Code / 其他支持 Skills 的工具：把本文件夹放到项目的
.cursor/skills/document-to-demo/或~/.cursor/skills/document-to-demo/（Claude Code 用.claude/skills/document-to-demo/）。文件夹名必须仍是document-to-demo，SKILL.md放在里面。新开对话，说：
按 document-to-demo 做。根据这个文档做一个 Demo。[产品名]。文档如下 / 我还只有这个想法：[贴文档或一句话]。这次要做到：[本地能跑 / 还要测效果 / 还要部署上云]没有记这条指令也行。用户直接说「根据这个文档做一个 Demo」并贴上文档，同样启用；缺项由 AI 追问。
- ChatGPT / 其他只能贴文本的对话：按这个顺序贴，不要让 AI 猜还缺哪份。先贴
SKILL.md全文，再贴references/workflow.md，再贴references/coding-prompt-template.md，再贴references/failure-modes.md。只有想法、没有产品文档时，再贴references/idea-to-document.md。然后说同一句。 - 你需要先准备
- 必填三项（说不清或缺一项，AI 先追问，补齐再开始）：
- 产品名
- 产品策略 / 流程文档全文，或一句话想法（二选一）
- 这次要做到哪一步：
A 本地能跑/B 本地能跑 + 埋料测试/C 再加部署上云
- 要验证「本地已经跑通」：需要能执行 Python 的环境。没有 → 只交文件和启动命令，必须标明「未实际跑通」，不要假装点过
- 要部署上云：需要用户有权限的云服务器、用户自己的公网 IP、用户自己保管的 API Key。缺服务器或 IP → 做到埋料测试后停下，不要做部署。真实 Key 不要贴进对话
- 必填三项（说不清或缺一项，AI 先追问，补齐再开始）：
When to Use
- 用：用户手里有产品策略 / 流程文档，想少写或不写代码做出能跑的 Demo
- 用：用户说「根据这个文档做一个 Demo」「把这份文档做成能跑的」「少写代码先做个能点的」「有文档，先跑通一条」
- 用：已有 PRD 或流程说明，但还没有可点击走通的 Demo
- 用：只有模糊想法、没有文档 → 先走
references/idea-to-document.md - 用：用户说「做个 Demo」「根据文档做个能跑的」「按这个做」，但产品名、文档或想法、做到哪一步还没给齐 → 仍启用，先追问，不要关掉
- 不用：已有代码库、要持续加功能或改现有模块（不要用阶段 4 的一次生成覆盖已有项目）
- 不用：用户只要观点、分享稿或课程讲义，明确不要可运行 Demo
输入
不要替用户编产品。Examples 只说明格式，不要拿来顶替用户的输入。
用户没给齐或没说清 → 仍用本 Skill，去追问。问清楚之前：不写产物、不进入阶段 0–6、不调用 references/ 里的模板。宁可多一轮问答，不要带着假输入往下做。
每次都要
| 用户必须给 | 为什么要 | 缺了会怎样 |
|---|---|---|
| 产品名 | 所有产出文件名都用它 | 无法命名文件；先问，不要自拟 |
| 产品文档全文，或一句话想法（二选一） | 有文档从阶段 0 起；只有想法先走 references/idea-to-document.md |
没有工作对象；先问「贴文档还是先说想法」 |
| 这次要做到哪 | 决定停在阶段 4、5 还是 6 | 给三个选项让用户选，不要默认做完全程 |
怎样算没说清
下面这些要启用本 Skill 去追问，不要写成「不用」：
- 「根据这个文档做一个 Demo」「把文档做成能跑的」「做个 Demo」但没给产品名、没贴文档
- 说「有个想法」但没写出那一句话，也没贴文档
- 没说要做到本地能跑、还要埋料测试、还是再加部署
- 三项里给了一部分，其余含糊或互相打架（例如既说「只要 Prompt」又说「直接上线」）
- 一上来就要登录、数据库、完整工程：仍启用。先说明本流程默认最小 Demo，问是否接受先砍范围；不接受再停，不要替他做大而全
怎么问
一次只问现在缺的那几项，不要一次甩二十个开放题。能给选项就给选项。缺哪项问哪项：
- 产品名是什么？
- 已有产品文档请贴全文，还是现在只有一句话想法？（请直接贴）
- 这次要做到哪一步？
A 本地能跑/B 本地能跑 + 埋料测试/C 再加部署上云
用户说「我不确定」→ 换个问法，仍不要替他填。
按任务追加（补齐每次都要之后，再按需问）
- 只要编码 Prompt：还要已拍板的「一句话核心路径」+「Demo 最小栈」。缺则从阶段 0 走，不要跳
- 只要埋料测试：还要已经能跑的 Demo，或
main.py+index.html路径 - 只要部署：还要用户确认有云服务器、自己的公网 IP；真实 Key 不要向用户要原文
有就用，没有就标 [待补充]（不要为这些拦住）
- 图的使用场景：没给则在对齐图里标
[待补充]，采用默认「和技术同事对齐 / ASCII」 - 技术栈：没拍板则在最小技术栈里写出默认双文件栈，未确认处标
[待补充]；用户确认前不写代码 - 埋料及格线：没给则标
[待补充]，改为逐条报命中 / 未命中，让用户拍板
Instructions
人负责做减法（砍范围、定形式、验效果）。你负责执行（分析、画图、写代码、配环境）。不要一上来实现，不要替用户做产品决策。默认产出一个能跑通一条闭环的本地 Demo。登录、权限、数据库、多端、生产架构全部先不做。
用户没给的事实不要编。阶段细则读 references/workflow.md。进入阶段 4 时读 references/coding-prompt-template.md。进入阶段 4 或 6 前读 references/failure-modes.md。不要从一份 reference 再去打开另一份。
人与 AI 的分工锁死，不要对调：
| 环节 | 用户 | 你 |
|---|---|---|
| 读文档 | 判断风险是否成立 | 通读，给评审意见 |
| 定路径 | 拍板只留哪一条 | 先列全集 |
| 画图 | 定格式、要求简化 | 画 |
| 技术选型 | 决定什么先不做、接受哪些牺牲 | 给选型和理由 |
| 编码 | 写验收标准、验收 | 写全部代码 |
| 测试 | 定及格线、对答案 | 生成埋料数据和答案清单 |
| 部署 | 控制台操作、安全把头、填密钥 | 执行配置命令（不含安全组与真实 Key） |
产出文件（{产品名} 换成用户给的名字）：
| 阶段 | 文件 |
|---|---|
| 0 | {产品名}-文档评审.md |
| 1 | {产品名}-核心路径.md |
| 2 | {产品名}-对齐图.md |
| 3 | {产品名}-最小技术栈.md |
| 4 | {产品名}-编码 Prompt.md、main.py、index.html |
| 5 | {产品名}-埋料测试.md |
| 6 | {产品名}-部署 Prompt.md |
任务路由
- 必填三项有缺或口糊 → 先按「输入」追问，不要进入下面任一支
- 已有产品文档 → 读
references/workflow.md，从阶段 0 起 - 只有想法、没有文档 → 先执行
references/idea-to-document.md，拿到文档再读references/workflow.md - 只要编码 Prompt → 必须已有一句话路径 + 最小栈；读
references/coding-prompt-template.md - 只要埋料测试 →
references/workflow.md阶段 5；Demo 还不能跑则追问文件或先回到阶段 4 - 只要部署 →
references/workflow.md阶段 6；先读references/failure-modes.md。安全组、授权 IP、真实密钥只由用户做 - 用户要「先搭空项目再写功能」→ 不走阶段 4。本 Skill 的编码是一份自包含 Prompt 一次生成 Demo
阶段 0–6 必须按序。过不了就停，写回到哪一步。不要跳过 0 去写代码。用户没要求部署 → 阶段 5 结束后停。
修复
- 口糊或必填缺项 → 回「输入」追问，不写产物
- 文档没被读懂 / 风险没拍板 → 停在阶段 0
- 路径压不成一句话 → 停在阶段 1
- 图太重、格式错 → 停在阶段 2
- 栈太大或没写清牺牲 → 停在阶段 3
- 代码走不通、Prompt 不自包含、没验收路径 → 回阶段 4
- 只能跑、没有答案清单 → 回阶段 5；规则不够回阶段 4
- 密钥、公网暴露、安全组 → 停，交给用户
- 法规 / 隐私不确定 → 停，让用户找业务方或法务，不要代写合规结论
全链路勾选
做一步勾一步。任一项失败，停在该步。
- 产品名、文档或想法、要做到哪一步，三项已齐；不齐则已追问，尚未写产物
- 阶段 0：有文档未写的发现；用户已判定风险
- 阶段 1：一句话核心路径；支线已标「先不做」
- 阶段 2：对齐图 + 三行骨架；格式符合场景
- 阶段 3：Demo 最小栈已拍板；写明牺牲和何时换
- 阶段 4：六要素自包含 Prompt；验收是一条可点击路径；已跑通或已标明未实际跑通
- 阶段 5（若这次需要）：埋料数据 + 答案清单；对照验收
- 阶段 6（若这次需要）：部署 Prompt 含环境探测、密钥占位、systemd；安全组 / IP / 真实密钥留给用户
- 未把登录、数据库、多端、生产架构塞进 Demo
Examples
下面都是虚构例子，不要拿来顶替用户的输入。不要用这里的产品名、文档或路径去填用户没给的空。
输入口糊，先追问
输入：用户说「根据这个文档做一个 Demo」。
输出：不写文件。一次只问缺的三项：
- 产品名是什么？
- 已有产品文档请贴全文，还是现在只有一句话想法？（请直接贴）
- 这次要做到哪一步？
A 本地能跑/B 本地能跑 + 埋料测试/C 再加部署上云
已有文档，三项齐
输入：用户说「根据下面这份文档做一个 Demo，要能本地跑，还要测一下效果。就叫请假审批助手。」并贴了文档正文：「员工在网页提交请假（类型、日期、事由）→ 直属主管批准或驳回 → 批准后写入团队日历 → 结果通知员工。」
输出（阶段 6 不做）：
请假审批助手-文档评审.md：指出文档没写的点，例如驳回后能否再提、日历写入失败怎么降级、时长规则谁说了算；等用户判定请假审批助手-核心路径.md：一句话「员工提交请假，主管批完后自动写入日历并通知」；人事汇总、跨部门会签标「先不做」请假审批助手-对齐图.md：ASCII 线框图 + 三行骨架；场景若用户没给，标[待补充]并采用默认 ASCII请假审批助手-最小技术栈.md：Demo 为main.py+index.html+ 内存字典；登录先不做，用页面角色切换模拟主管/员工请假审批助手-编码 Prompt.md、main.py、index.html：验收路径是「提交一条请假 → 切到主管批准 → 日历出现占用 → 员工侧看到已批准」请假审批助手-埋料测试.md：埋「跨天请假」「主管驳回后再提」等，并附答案清单
只有一句话想法
输入：用户说「我想做个班车座位登记，同事每天在群里问还有没有座位。先做个能跑的 Demo。」
输出：不进入阶段 4。先走 references/idea-to-document.md，产出能讲清「做什么、给谁用、不做什么」的 {产品名}-PRD.md，再从阶段 0 开始。
不要启用
输入：用户说「这个仓库已经在跑，帮我加一个看板」。
输出：不走本 Skill。已有代码库上加功能，按该项目协作规则改，不要用一次生成 Demo 的编码 Prompt 覆盖现有项目。