AGENT SKILL
prototype
构建一个用完即弃的原型来回答某个设计问题。当用户想核实一个状态模型或逻辑是否感觉对劲,或者探索某个 UI 该长什么样时使用。
- License 许可
- MIT
- 最近更新
- 2026-08-13
- Stars
- ★ 31
- Forks
- 6
01 前言 Front Matter
- name
- prototype
- description
- 构建一个用完即弃的原型来回答某个设计问题。当用户想核实一个状态模型或逻辑是否感觉对劲,或者探索某个 UI 该长什么样时使用。
02 资源文件 3
- 参考文档agents/openai.yaml96 B
- 参考文档LOGIC.md5.9 KB
- 参考文档UI.md6.6 KB
03 SKILL.md 正文
原型
一个原型是回答一个问题的用完即弃代码。问题决定形状。
挑一个分支
弄清正在回答的是哪个问题——从用户的提示、周围的代码,或者在用户在场时直接问:
- 「这个逻辑 / 状态模型感觉对吗?」 → LOGIC.md。构建一个单一的可分享 HTML 文件——自由玩耍按钮加上带标签页的引导式演练——把状态机推过那些在纸上难以推理的情形,而且非开发者也能驱动它。
- 「这该长什么样?」 → UI.md。在单个路由上生成若干截然不同的 UI 变体,通过一个 URL 查询参数和一个浮动底栏切换。
两个分支产出非常不同的产物——搞错了会浪费整个原型。如果问题确实含糊而用户又联系不上,就默认走与周围代码更匹配的那个分支(后端模块 → 逻辑;页面或组件 → UI),并在原型顶部陈述这个假设。
两个分支都适用的规则
- 从第一天起就用完即弃,并明确标注为如此。 把原型代码放在它实际会被用到的地方附近(挨着它在为之做原型的那个模块或页面),这样上下文一目了然——但给它起个名,让随意的读者一看就知道这是原型、不是生产代码。对于用完即弃的 UI 路由,遵循项目已有的路由约定;不要发明新的顶层结构。
- 运行起来轻而易举。 一个 UI 原型从项目任务运行器里的一条命令启动——
pnpm <name>、python <path>、bun <path>等。一个逻辑演示是一个用户双击的单 HTML 文件。无论哪种方式,启动它都不用动脑子。 - 默认不持久化。 状态活在内存里。持久化是原型在核实的东西,不是它该依赖的东西。如果问题明确涉及数据库,就打到一个临时数据库或本地文件,起个明确的「PROTOTYPE — wipe me」名字。
- 跳过打磨。 没有测试,除了让原型可运行所必需的之外没有错误处理,没有抽象。重点是快速学到点东西。
- 让状态浮现。 每次 action(逻辑)之后,或每次变体切换(UI)时,打印或渲染全部相关状态,让用户看到变了什么。
- 完成后捕获它。 把任何经过验证的决策折叠进真实代码,然后把原型本身作为一份一手来源捕获:把它 commit 到一个主线之外的用完即弃分支,并在实现工单上留一个指向那个分支的上下文指针。也捕获答案——那个结论以及它所定夺的问题——记在工单或一个 commit 里。主分支只保留经过验证的决策。
04 同仓库更多 Skills
writing-for-agents
为智能体撰写文档。当创建或编辑技能,或修改 AGENTS.md 或 CLAUDE.md 时使用。
★ 31
wait-what
停一下。那最后一条消息没能领会——重新表述它。
★ 31
to-questionnaire
把一个你无法完全回答的决策变成一份问卷,交给别人填写。
★ 31
teach
在本工作区内向用户传授一项新技能或概念。
★ 31
handoff
把当前对话压缩成一份交接文档,供另一个 agent 接手。
★ 31
grilling
就一个计划、决定或想法不留情面地拷问用户。当用户想对自己的思考做压力测试,或使用任何 'grill' 触发短语时使用。
★ 31