AGENT SKILL
prototype
构建一次性原型来回答设计问题。当用户想要验证状态模型或逻辑是否顺手,或探索 UI 应该长什么样时使用。
- License 许可
- MIT
- 最近更新
- 2026-10-19
- Stars
- ★ 0
- Forks
- 0
01 前言 Front Matter
- name
- prototype
- description
- 构建一次性原型来回答设计问题。当用户想要验证状态模型或逻辑是否顺手,或探索 UI 应该长什么样时使用。
- commit_version
- 321658273cb1d20b76026717d027d505790106d4
02 资源文件 3
- 参考文档agents/openai.yaml96 B
- 参考文档LOGIC.md5.5 KB
- 参考文档UI.md6.2 KB
03 SKILL.md 正文
Prototype
原型是用来回答一个问题的一次性代码。问题决定它的形态。
选择分支
确定正在回答的是哪个问题,依据用户提示、周边代码来判断,或用户在场时直接询问:
- “这个逻辑 / 状态模型是否顺手?” → LOGIC.md。构建一个可共享的 HTML 文件(自由把玩的按钮 + 分页的引导式走查),把状态机推过那些纸面上难以推理的用例,而且非开发者也能操作。
- “这应该长什么样?” → UI.md。在单一路由上生成几个截然不同的 UI 变体,通过 URL 搜索参数和悬浮底栏切换。
两条分支产出截然不同的产物,所以选错会浪费整个原型。如果问题确实含糊且联系不上用户,默认选与周边代码更匹配的分支(后端模块 → logic;页面或组件 → UI),并在原型顶部声明这一假设。
两条分支都适用的规则
- 从第一天起就是一次性的,并清楚标记。 把原型代码放在它真正会被使用的位置附近(要为之做原型的模块或页面旁边),让上下文一目了然,但命名要让随便一个读者都看得出它是原型,而不是生产代码。对于一次性 UI 路由,遵循项目已有的路由约定;不要发明新的顶层结构。
- 运行起来要极其简单。 UI 原型从项目任务运行器的一条命令开始:
pnpm <name>、python <path>、bun <path>等。逻辑演示是用户双击即开的单个 HTML 文件。无论哪种,启动时都不需要思考。 - 默认无持久化。 状态只存在于内存。持久化是原型要检验的东西,而不是它应当依赖的东西。如果问题明确涉及数据库,使用 scratch 数据库或本地文件,并起一个清晰的 “PROTOTYPE, wipe me” 名字。
- 跳过打磨。 不写测试,不做超出“让原型可运行”的错误处理,不做抽象。目标是快速学到东西。
- 暴露状态。 每次动作后(logic)或每次切换变体时(UI),打印或渲染完整相关状态,让用户看到什么变了。
- 完成后捕获。 把经过验证的决策折入真实代码,然后把原型本身捕获为一手来源:提交到 main 之外的一次性分支,并在实现 issue 上留下指向该分支的上下文指针。答案也要捕获(结论和它解决的问题),写进 issue 或提交。main 分支只保留经过验证的决策。
04 同仓库更多 Skills
skills-link
管理 muscaestar/skills 仓库的 skill 安装。当用户想安装/卸载某个 skill、查看已装清单、把 skill 装到全局或某个项目、或问"这个 skill 装了没有"时使用。也用于向用户解释三层结构与全局/项目双范围安装策略。
★ 0
writing-shape
写作之 exploit:把原始素材塑形成一篇文章,逐段进行。
★ 0
writing-fragments
写作之 explore:开采原始碎片,还没有结构。
★ 0
writing-for-agents
为 agents 编写文档。在创建或编辑技能,或修改 AGENTS.md 或 CLAUDE.md 时使用。
★ 0
writing-beats
写作之 exploit;把原始素材组装成一段由节拍(beat)构成的旅程,在每个节拍倚赖某个术语之前先把它落地。
★ 0
wizard
生成一个交互式 bash 向导,引导人类完成只有他们才能执行的步骤。当需要配置基础设施、设置凭据或 CI secret、摸索不熟悉的第三方仪表盘,或执行一次性的迁移或切换时使用。不要为 agent 自己能执行的步骤调用本技能。
★ 0