SuperAPI AI 工具集

breadboarding

通用与其它

查看项目

更新于 10-16 06:14

技能介绍

用途:breadboarding 用于把用户可执行的操作与系统产出结果的方式映射成标准模型,适用于梳理现有系统、从既定部件设计功能,或两者混合场景。若流程跨越前端、后端、worker 或第三方系统,需用同一张 breadboard 并在 Place 与 Component 字段标注各边界。

主要能力:以四张表为规范输出,依次为 Places、UI affordances、Code affordances、Data stores。Place 是受限交互上下文,用 P1、P2 编号,真实子场所用 P2.1;判断标准为进入或离开该上下文是否需要用户操作,或可用控件是否整体变化。UI 可供性编号 U1、U2,如输入、按钮、列表、消息与渲染值;代码可供性编号 N1、N2,如处理函数、方法、订阅、任务与 API 操作;状态存储编号 S1、S2,如持久记录、可观察状态、URL 状态或组件状态。Wires Out 表示控制流(调用、触发、状态写入),Returns To 表示数据流(输出或存储值流向何处),导航目标指向 Place 而非其中任意可供性;控制流与数据流不得混在同一列。

使用方式:先从用户或调用方视角陈述工作流与预期最终效果,识别 Place 与系统边界,按流程顺序盘点 UI 可供性,追踪真实或预期的调用路径并补充代码可供性,仅在状态持久或影响后续行为处添加存储,分别填写 Wires Out 与 Returns To,再端到端追踪每条用户故事。映射代码时需足够广泛地搜索,找出其他调用方与读取方,不要按记忆路径或首个匹配即停止。现有系统须核对名称与连线,可在 Notes 中引用文件路径或符号。Mermaid 图可选且必须由表格推导,不覆盖表格;仅在表格验证完成后才做纵向切片。

限制:每条可供性只能属于一个已声明的 Place;每个被展示的值须有传入数据源;每个 N 须有 Wires Out、Returns To 或明确的终点效应说明;每个 S 须有写入者或来源并至少一个读取者;每个必需结果须有从触发到效果的完整链路;提议行为须与代码支撑行为区分;可选图中不得出现表格之外的节点或连线。若验证失败,应修正表格或记录明确待解问题,不得用图隐藏不确定性。详细白板翻译、子场所、分块、Mermaid 样式、切片图与完整示例见 references/extended-guide.md。