prototype

Files (4)

• LOGIC.md
• SKILL.md
• UI.md
• openai.yaml · agents/

SKILL.md (first lines)

# 原型

原型是 **用来回答一个问题的一次性代码**。问题决定形态。

## 选择分支

识别正在回答哪个问题 —— 来自用户提示、周围代码，或在用户在场时询问：

- **「这套逻辑 / 状态模型感觉对吗？」** → [LOGIC.md](LOGIC.md)。构建一份可分享的 HTML 文件 —— 自由试玩按钮加上带标签页的引导演练 —— 把状态机推进纸面上难以推理的情形，并让非开发者也能操作。
- **「这应该长什么样？」** → [UI.md](UI.md)。在同一条路由上生成若干差异极大的 UI 变体，通过 URL 查询参数和底部浮动栏切换。

两个分支产出的产物非常不同 —— 选错就浪费整个原型。若问题确实含糊且用户联系不上，默认选与周围代码更匹配的分支（后端 module → 逻辑；页面或组件 → UI），并在原型顶部写明该假设。

## 两条分支都适用的规则

1. **从第一天起就是一次性的，并明确标成这样。** 把原型代码放在它实际会被用到的附近（紧挨它所原型化的 module 或页面），让上下文一目了然 —— 但命名要让随便扫一眼的人看出这是原型，不是生产代码。一次性 UI 路由遵循项目已有的路由约定；不要发明新的顶层结构。
2. **运行必须毫不费力。** UI 原型从项目任务运行器的一条命令启动 —— `pnpm <name>`、`python <path>`、`bun <path>` 等。逻辑演示是用户双击即可打开的单个 HTML 文件。无论哪种，启动都不需要思考。
3. **默认不持久化。** 状态活在内存里。持久化是原型在 _检查_ 的东西，不是它应依赖的东西。若问题明确涉及数据库，打到临时 DB 或带清晰 "PROTOTYPE — wipe me" 名称的本地文件。
4. **跳过打磨。** 不要测试，除了让原型 _能跑起来_ 所需之外不要错误处理，不要抽象。要点是尽快学到东西。
5. **把状态摊开。** 每次动作之后（逻辑）或每次变体切换时（UI），打印或渲染全部相关状态，让用户看见改了什么。
6. **完成后收存。** 把任何已验证的决策折进真实代码，然后把原型本身收存为 **primary source**：提交到一条一次性分支上，远离 main，并在实现工单上留下指向该分支的上下文指针。答案也要收存 —— 结论以及它了结的问题 —— 写在工单或一次提交里。main 分支只保留已验证的决策。

From shenjunjian/matt-skill-cn, MIT.

More from shenjunjian/matt-skill-cn