AGENT SKILL

prototype

构建用完即弃的原型来回答设计问题。用户希望快速检验状态模型或逻辑是否合理,或探索 UI 应有的外观时使用。

License 许可
MIT
最近更新
2026-07-23
Stars
★ 1
Forks
0

01 前言 Front Matter

name
prototype
description
构建用完即弃的原型来回答设计问题。用户希望快速检验状态模型或逻辑是否合理,或探索 UI 应有的外观时使用。

02 资源文件 3

03 SKILL.md 正文

原型

原型是用于回答问题、用完即弃的代码。问题决定其形态。

选择分支

根据用户提示、周边代码,或在用户在线时直接询问,确定要回答的问题:

  • “这个逻辑/状态模型感觉对吗?” → LOGIC.md。构建一个小型交互式终端应用,让状态机经历难以在纸面上推理的场景。
  • “它应该是什么样子?” → UI.md。在单个路由上生成若干截然不同的 UI 变体,并可通过 URL 搜索参数和悬浮底栏进行切换。

两个分支会产出截然不同的工件——选错会浪费整个原型。如果问题确实有歧义且联系不上用户,则默认选择更符合周边代码的分支(后端模块 → 逻辑;页面或组件 → UI),并在原型顶部说明该假设。

两个分支都适用的规则

  1. 从第一天起就准备丢弃,并明确标记。 将原型代码放在将来实际使用位置附近(紧邻其所针对的模块或页面),使上下文一目了然——但要让命名足够清楚,使普通读者一眼看出这是原型而非生产代码。对于用完即弃的 UI 路由,遵循项目已有的路由约定;不要发明新的顶层结构。
  2. 一条命令即可运行。 使用项目现有任务运行器支持的形式——pnpm <name>、python <path>、bun <path> 等。用户必须无需思考便能启动。
  3. 默认不持久化。 状态保存在内存中。持久化是原型要 检验 的对象,而不是原型应当依赖的对象。如果问题明确涉及数据库,则使用临时数据库,或使用名称中清楚写明“PROTOTYPE — wipe me”的本地文件。
  4. 跳过润色。 不写测试;除保证原型 可运行 所必需的错误处理外,不做其他错误处理;不创建抽象。目标是快速学到东西。
  5. 显露状态。 每次操作(逻辑)后或每次切换变体(UI)时,打印或渲染完整的相关状态,让用户看到发生了什么变化。
  6. 完成后保存。 将所有经过验证的决策融入真实代码,然后把原型本身作为一手来源保存:将其提交到 main 之外的用完即弃分支,并在实现事项中留下指向该分支的上下文指针。同时在事项或提交中记录答案——结论及其所解决的问题。main 分支仅保留经过验证的决策。

04 同仓库更多 Skills