SuperAPI AI 工具集

breadboarding

设计与创作

查看项目

更新于 10-15 19:53

技能介绍

用途:Breadboarding 将一段工作流描述转化为完整的可供性与关系图谱,产出始终是一组表格,列出带编号的 UI 与 Code 可供性,以及它们的 Wires Out(控制流)和 Returns To(数据流)关系。表格是事实来源,Mermaid 图是可选的、给人看的可视化。

主要能力:支持两类工作,一是映射现有系统,输入代码仓库与以操作者视角描述的工作流,输出 UI 可供性表、Code 可供性表及可选 Mermaid 图;二是基于已塑形的部件设计新系统,输入部件清单、目标需求(R)与可选现有系统。两者混合时,把既有与新增可供性一起 breadboard,展示连接方式。还说明如何阅读白板手绘 breadboard:位置为彩色块,可供性在其下堆叠,Code 可供性常悬于堆栈之间,位置加载器位于左上,实线箭头为 Wires Out,虚线为 Returns To,缩进块表示条件分支,_ 前缀表示位置引用,? 或 ~ 前缀表示不确定,大框表示系统/职责边界。核心概念包括 Places(有界交互上下文,用“能否与背后内容交互”的阻塞测试判断)、子位置(用 P2.1 等层级 ID)、位置引用、模式即位置、包含与接线的区别,以及导航接线应指向 Place 而非其内部可供性。产出表格包括 Places 表、UI 可供性表、Code 可供性表与数据存储表,列含 #、Place、Component、Affordance、Control、Wires Out、Returns To。

使用方式:按资料中的步骤操作——识别要分析的流程、列出涉及的位置、从入口追踪代码找组件、列出每个组件的可供性、命名代码中真实存在的对象而非抽象、填写 Control、Wires Out、Returns To,把数据存储与框架机制也作为可供性加入,最后对照代码核验。调用命名示例:activeQuery.next()、performSearch()、searchOneCategory()、rawSearch()。

适用场景:理解某功能为何发生或不发生、梳理跨前后端的完整故事、在既有系统上加入新部件、把白板图转成标准表格。

限制:资料未提供关于授权、收费、价格、平台支持或性能效果的说明;表格必须基于真实代码可供性,不应写成抽象概念,且需反复对照代码核验。