[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M78H82TPWA4ABQNC72FATPEA":3,"skill-same:01M78H82TPWA4ABQNC72FATPEA":61},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":24,"commitSha":25,"skillDirectory":26,"forksCount":27,"repositoryHtmlUrl":28,"repositoryHomepageUrl":28,"ownerHtmlUrl":29,"ownerBlogUrl":30,"ownerDescription":31,"updatedAt":32,"install":33,"resources":46},"01M78H82TPWA4ABQNC72FATPEA","prototype",null,"构建一个 throwaway prototype 来回答设计问题。当用户想确认某个 state model 或 logic 是否合理，或想探索 UI 应该长什么样时使用。","toRolex\u002Frolex-skills","toRolex","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F171526267?v=4","01M78H6W9BVJ5TBK7APN5HFBJF","Rolex","01M78H6WAC60FGNASCYJAJM7VW",1,"MIT","https:\u002F\u002Fgithub.com\u002FtoRolex\u002Frolex-skills\u002Fblob\u002Fmain\u002Fskills\u002Fengineering\u002Fprototype\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: prototype\ndescription: 构建一个 throwaway prototype 来回答设计问题。当用户想确认某个 state model 或 logic 是否合理，或想探索 UI 应该长什么样时使用。\n---\n\n# Prototype\n\nprototype 是**用来回答某个问题的 throwaway 代码**。问题决定了它的形态。\n\n## 选择分支\n\n先确认要回答的是哪个问题，从用户的 prompt、周围的代码来判断，如果用户在场也可以直接询问：\n\n- **「这套 logic \u002F state model 合理吗？」** → [LOGIC.md](LOGIC.md)。构建一个单一的、可分享的 HTML 文件（包含自由操作的按钮和带标签页的引导式分步演示），让 state machine 跑过那些在纸面上很难推演的用例，而且让非开发者也能操作。\n- **「它应该长什么样？」** → [UI.md](UI.md)。在单一路由上生成几个差异极大的 UI variant，通过 URL search param 和一个浮动底栏来切换。\n\n两个分支产出的 artifact 截然不同，选错了会浪费整个 prototype。如果问题确实模棱两可，又联系不上用户，就默认选择更贴合周围代码的分支（后端 module → logic；页面或组件 → UI），并在 prototype 顶部注明这个假设。\n\n## 适用于两个分支的规则\n\n1. **从第一天起就是 throwaway，并且要明确标注。** 把 prototype 代码放在它实际会被使用的位置附近（紧挨着它为之做原型的 module 或页面），这样上下文一目了然，但命名要让随便翻到的人一眼看出这是 prototype，不是生产代码。对于 throwaway 的 UI 路由，遵循项目现有的路由约定，不要发明新的顶层结构。\n2. **启动要毫无门槛。** UI prototype 从项目任务运行器里的一条命令就能启动：`pnpm \u003Cname>`、`python \u003Cpath>`、`bun \u003Cpath>` 等。logic demo 则是用户双击即可打开的单个 HTML 文件。无论哪种，启动它都不需要动脑。\n3. **默认不持久化。** state 放在内存里。persistence 是 prototype 要_检验_的对象，不是它应该依赖的东西。如果问题明确涉及数据库，就接一个临时数据库，或一个命名清晰、写着「PROTOTYPE, wipe me」的本地文件。\n4. **跳过打磨。** 不写测试，除了让 prototype 能_跑起来_所必需的错误处理之外不做错误处理，不做抽象。重点是快速学到东西。\n5. **把 state 亮出来。** 每次操作之后（logic）或每次切换 variant 时（UI），打印或渲染完整的相关 state，让用户看到发生了什么变化。\n6. **完成后收尾。** 把任何验证过的 decision 合并进真实代码，然后把 prototype 本身作为 **primary source** 留存：提交到一个 throwaway branch，不进入 main，并在实现 issue 上留下指向该 branch 的 context pointer。也要把答案记下来（结论以及它解决的问题），记在 issue 或某个 commit 里。main branch 只保留已验证的 decision。\n","# Prototype\n\nprototype 是**用来回答某个问题的 throwaway 代码**。问题决定了它的形态。\n\n## 选择分支\n\n先确认要回答的是哪个问题，从用户的 prompt、周围的代码来判断，如果用户在场也可以直接询问：\n\n- **「这套 logic \u002F state model 合理吗？」** → [LOGIC.md](LOGIC.md)。构建一个单一的、可分享的 HTML 文件（包含自由操作的按钮和带标签页的引导式分步演示），让 state machine 跑过那些在纸面上很难推演的用例，而且让非开发者也能操作。\n- **「它应该长什么样？」** → [UI.md](UI.md)。在单一路由上生成几个差异极大的 UI variant，通过 URL search param 和一个浮动底栏来切换。\n\n两个分支产出的 artifact 截然不同，选错了会浪费整个 prototype。如果问题确实模棱两可，又联系不上用户，就默认选择更贴合周围代码的分支（后端 module → logic；页面或组件 → UI），并在 prototype 顶部注明这个假设。\n\n## 适用于两个分支的规则\n\n1. **从第一天起就是 throwaway，并且要明确标注。** 把 prototype 代码放在它实际会被使用的位置附近（紧挨着它为之做原型的 module 或页面），这样上下文一目了然，但命名要让随便翻到的人一眼看出这是 prototype，不是生产代码。对于 throwaway 的 UI 路由，遵循项目现有的路由约定，不要发明新的顶层结构。\n2. **启动要毫无门槛。** UI prototype 从项目任务运行器里的一条命令就能启动：`pnpm \u003Cname>`、`python \u003Cpath>`、`bun \u003Cpath>` 等。logic demo 则是用户双击即可打开的单个 HTML 文件。无论哪种，启动它都不需要动脑。\n3. **默认不持久化。** state 放在内存里。persistence 是 prototype 要_检验_的对象，不是它应该依赖的东西。如果问题明确涉及数据库，就接一个临时数据库，或一个命名清晰、写着「PROTOTYPE, wipe me」的本地文件。\n4. **跳过打磨。** 不写测试，除了让 prototype 能_跑起来_所必需的错误处理之外不做错误处理，不做抽象。重点是快速学到东西。\n5. **把 state 亮出来。** 每次操作之后（logic）或每次切换 variant 时（UI），打印或渲染完整的相关 state，让用户看到发生了什么变化。\n6. **完成后收尾。** 把任何验证过的 decision 合并进真实代码，然后把 prototype 本身作为 **primary source** 留存：提交到一个 throwaway branch，不进入 main，并在实现 issue 上留下指向该 branch 的 context pointer。也要把答案记下来（结论以及它解决的问题），记在 issue 或某个 commit 里。main branch 只保留已验证的 decision。\n",{"name":5,"description":7},"main","5648606410e64c6ebad383fa37b866fcd14718cf","skills\u002Fengineering\u002Fprototype",0,"https:\u002F\u002Fgithub.com\u002FtoRolex\u002Frolex-skills","https:\u002F\u002Fgithub.com\u002FtoRolex","luolie3@mail2.sysu.edu.cn","I'm Luo Lie from SYSU. Mathematics-trained builder for agentic AI systems and real-world products.","2026-11-03 15:28:15",{"source":8,"skillName":5,"commands":34,"prompt":44,"zipAvailable":45},[35,38,41],{"tool":36,"command":37},"npx","npx skills add toRolex\u002Frolex-skills --skill prototype",{"tool":39,"command":40},"bunx","bunx skills add toRolex\u002Frolex-skills --skill prototype",{"tool":42,"command":43},"pnpm","pnpm dlx skills add toRolex\u002Frolex-skills --skill prototype","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002FtoRolex\u002Frolex-skills\u002Fblob\u002Fmain\u002Fskills\u002Fengineering\u002Fprototype\u002FSKILL.md",true,[47,53,57],{"path":48,"resourceType":49,"resourceTypeDesc":50,"sizeBytes":51,"sourceHtmlUrl":52},"agents\u002Fopenai.yaml","REFERENCE","参考文档",100,"https:\u002F\u002Fgithub.com\u002FtoRolex\u002Frolex-skills\u002Fblob\u002Fmain\u002Fskills\u002Fengineering\u002Fprototype\u002Fagents\u002Fopenai.yaml",{"path":54,"resourceType":49,"resourceTypeDesc":50,"sizeBytes":55,"sourceHtmlUrl":56},"LOGIC.md",5698,"https:\u002F\u002Fgithub.com\u002FtoRolex\u002Frolex-skills\u002Fblob\u002Fmain\u002Fskills\u002Fengineering\u002Fprototype\u002FLOGIC.md",{"path":58,"resourceType":49,"resourceTypeDesc":50,"sizeBytes":59,"sourceHtmlUrl":60},"UI.md",6962,"https:\u002F\u002Fgithub.com\u002FtoRolex\u002Frolex-skills\u002Fblob\u002Fmain\u002Fskills\u002Fengineering\u002Fprototype\u002FUI.md",[62,69,76,83,90,97],{"skillNo":63,"name":64,"nameZh":6,"description":65,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":66,"categories":67,"keywords":68,"publishedAt":19},"01M78HA978AVPWGFE3PR9RNJ9G","writing-great-skills","Reference for writing and editing skills well — the vocabulary and principles that make a skill predictable.","https:\u002F\u002Fgithub.com\u002FtoRolex\u002Frolex-skills\u002Fblob\u002Fmain\u002Fskills\u002Fproductivity\u002Fwriting-great-skills\u002FSKILL.md",[],[],{"skillNo":70,"name":71,"nameZh":6,"description":72,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":73,"categories":74,"keywords":75,"publishedAt":19},"01M78HA7737MNQ4411A7SZWPJQ","writing-for-agents","覆盖创建、修改与审核 agent 指令规则、路由及指针文档（如 skill、AGENTS.md、CLAUDE.md）。","https:\u002F\u002Fgithub.com\u002FtoRolex\u002Frolex-skills\u002Fblob\u002Fmain\u002Fskills\u002Fproductivity\u002Fwriting-for-agents\u002FSKILL.md",[],[],{"skillNo":77,"name":78,"nameZh":6,"description":79,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":80,"categories":81,"keywords":82,"publishedAt":19},"01M78HA62NC1NZNAEZ26784495","wait-what","停下。上一条消息没有说清楚：重新讲一遍。","https:\u002F\u002Fgithub.com\u002FtoRolex\u002Frolex-skills\u002Fblob\u002Fmain\u002Fskills\u002Fproductivity\u002Fwait-what\u002FSKILL.md",[],[],{"skillNo":84,"name":85,"nameZh":6,"description":86,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":87,"categories":88,"keywords":89,"publishedAt":19},"01M78HA4NX5KBJ7WQ69SR25QHW","to-questionnaire","把一个你无法完全回答的决策，变成一个让其他人填写的问题单。","https:\u002F\u002Fgithub.com\u002FtoRolex\u002Frolex-skills\u002Fblob\u002Fmain\u002Fskills\u002Fproductivity\u002Fto-questionnaire\u002FSKILL.md",[],[],{"skillNo":91,"name":92,"nameZh":6,"description":93,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":94,"categories":95,"keywords":96,"publishedAt":19},"01M78HA2RTESFTRTNA7ZZNVVXS","teach-me","在教学工作区内教授用户一项新技能或概念。","https:\u002F\u002Fgithub.com\u002FtoRolex\u002Frolex-skills\u002Fblob\u002Fmain\u002Fskills\u002Fproductivity\u002Fteach-me\u002FSKILL.md",[],[],{"skillNo":98,"name":99,"nameZh":6,"description":100,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":101,"categories":102,"keywords":103,"publishedAt":19},"01M78HA187DQB10VDJ4G89F540","handoff","将当前对话压缩为 handoff 文档，供另一个 agent 接续。","https:\u002F\u002Fgithub.com\u002FtoRolex\u002Frolex-skills\u002Fblob\u002Fmain\u002Fskills\u002Fproductivity\u002Fhandoff\u002FSKILL.md",[],[]]