SuperAPI AI 工具集

design-synthesis

编程与开发

查看项目

更新于 10-16 05:26

技能介绍

用途

design-synthesis 用于将研究结论综合为设计决策,并通过轻量级代码库调查为决策提供有依据的上下文。其核心主张是:设计决策在实现之前需要扎实的上下文支撑。

适用场景包括:(1)将研究转化为实现方法;(2)选择实现路径。

主要能力

该技能定义了一套五阶段工作流:

  • INGEST:加载研究产物,解析原始请求。从研究文件中提取发现、置信度等级和关键来源;从请求中提取意图、范围边界和成功标准。研究结构按 FINDINGS(按类别划分的领域知识)、CONFIDENCE(高/中/低评级)、SOURCES(决策归因)解析。要求始终将高置信度发现作为主要输入,将低置信度区域标记为设计风险,且绝不在未理解请求意图的情况下继续。
  • SCAN:通过 parallel-dispatch 调度 3-4 个智能体进行轻量代码库调查,以了解模式、约束和接口。智能体分工为:Patterns(代码库中相似实现、约定、可复用模式、既有先例)、Constraints(项目规则、架构限制、硬边界、风格要求)、Interfaces(功能区域的入口/出口点、接触点、消费者、集成面)。要求所有智能体在一条消息块中一次性调度,范围限定在模式/约束/接口而非实现细节,且不深入文件内容。
  • EXPLORE:基于研究与扫描发现生成 2-3 个不同方案。每个方案包含策略、与研究发现的契合度、遵循的代码库约定、权衡(优缺点)。方案生成标准为:方案 A 最贴合现有模式(保守);方案 B 最大化利用研究发现(最优);方案 C 实现路径最简单(最小化,可选)。要求方案基于扫描发现而非推测,每个方案都包含权衡分析,并应用 YAGNI 原则削减不必要范围。
  • SELECT:通过加权标准选定最佳方案。标准包括:模式契合度(高权重)、研究支持度(高权重)、简洁性(中权重)、风险状况(中权重)。选择输出包括所选方案名称、主要理由(1-2 句)、接受的权衡。要求只承诺一个方案、记录接受的权衡,且不将选择推迟到下游阶段。
  • OUTPUT:产出 brainstorm.md,包含固定结构:标题与构建目标、研究摘要、APPROACHES(各方案表格)、SELECTED_APPROACH(选择、理由、接受的权衡)、DESIGN_CONSTRAINTS(约束与来源)、KEY_DECISIONS(决策、选择、理由)。要求包含所有章节、方案与决策使用表格格式,不使用散文段落。

使用方式

输入包括:Research(研究产物路径,research_{slug}.md)和 Request(原始用户请求/意图)。技能按上述五阶段执行,最终输出结构化的 brainstorm.md 设计文档。

依赖

  • parallel-dispatch:用于代码库扫描的智能体编排。
  • Research artifact:来自 deep-research 的外部发现。

验证

技能包含验证清单:Ingest(研究已解析、请求意图已提取)、Scan(3-4 个智能体在一条消息中调度)、Explore(生成 2-3 个带权衡的方案)、Select(承诺一个方案并附理由)、Output(所有章节存在、使用表格格式)、YAGNI(从所有方案中削减不必要范围)。

限制

资料未提供关于收费、价格、平台支持范围或具体效果的信息。该技能依赖 parallel-dispatch 与 deep-research 产物,缺少这些依赖时无法按设计运行。