SuperAPI AI 工具集

sddesign

设计与创作

查看项目

更新于 10-15 16:34

技能介绍

用途

sddesign 是 ui-craft 技能体系下的一个子技能,是其中一个视角(lens)。它用于运行“规范驱动(spec-driven)的设计流水线”,把需求简要到交付的各个阶段串联起来,在一次引导式运行中完成整条链路,并写入 .ui-craft/spec.md 作为规范记录。

若同时安装了更上层的 ui-craft 技能,应先阅读其 SKILL.md,了解 Discovery、Anti-Slop 与 Craft Test 内容,再应用本子技能的具体视角。

主要能力

该命令采用“仅编排(ORCHESTRATE-ONLY)”规则,按顺序调度已有的各阶段命令,自身不重新实现或复制这些命令中的任何逻辑。它只贡献以下几类内容:

  • 门禁检测:判断某阶段产物是否已经存在。
  • 提供提示:询问用户是否运行某阶段或跳过。
  • 进度报告:输出一条进度清单。
  • 降级诚实:说明哪些阶段被跳过,以及跳过的代价。

进度清单在流程开始时打印,并在每个门禁解决后更新。清单格式为:

[ ] brief [ ] tokens [ ] shape (spec) [ ] craft (build) [ ] converge [ ] ship

其中:[✓] 表示已完成或已跳过但产物存在;[>] 表示当前所在门禁;[–] 表示已跳过且没有产物(降级)。

使用方式(流水线门禁)

门禁 1 — Brief:检查 .ui-craft/brief.md 是否存在。存在则标记完成,并说明 brief §6 学习到的约束以及无障碍/正确性底线将对后续所有门禁生效,且优先于任何 spec.md 的组合选择。不存在则提供立即运行 /brief 的选项:用户确认则运行并标记完成;用户拒绝则标记为降级,并说明影响——没有 brief 时 craft 将使用技能默认值,组合不会锚定项目原则。

门禁 2 — Tokens:检查是否存在令牌主干(例如 CSS 变量 --color-*、--font-*、--accent-*,或带 tokens 的 Tailwind theme.extend,或令牌文件)。存在则标记完成。不存在则提供运行 /tokens 的选项;用户拒绝则标记降级,并说明影响——没有令牌主干时 craft 会建立最小内联令牌集,无法匹配现有系统。

门禁 3 — Shape(规范):运行前先做“已有界面守卫”——若 .ui-craft/spec.md 中已存在针对该界面的 ## Surface: <name> 区块,则不要重跑 shape 并盲目追加重复区块,而是提供更新已有区块或跳过 shape 的选项。随后针对 $ARGUMENTS 描述的界面运行 /shape,产出其完整的五步输出(内容清单、ASCII 布局、状态列表、待解决问题)。在 sddesign 流水线中,shape 的第 6 步“规范持久化”默认开启,除非用户明确选择不持久化;持久化会写入 .ui-craft/spec.md 或追加界面区块。用户明确选择不持久化时标记为降级,并说明影响——craft 将基于 shape 打印到终端的结果构建,验收标准不会被持久化。

门禁 4 — Craft(构建):运行 /craft <surface>,其中 surface 与 $ARGUMENTS 描述一致。craft 在构建前会声明 Craft Read(references/craft-intent.md),包括界面类型、受众、主题/强调色、DESIGN_VARIANCE 以及一个标志性下注(signature bet);标志性下注在该门禁内构建,不推迟到收敛或打磨阶段。若 spec 区块指定了某种组合,Craft Read 必须与之保持一致。craft 构建前会加载 .ui-craft/spec.md;若规范已持久化,规范中选定的组合、组件清单、状态格与验收标准优先于配方默认值,规范中的每一项验收标准都必须通过后 craft 才报告完成。构建完成即标记完成。

门禁 5 — Converge:运行来自 ../skills/ui-craft/references/loops.md 的 visual-anti-slop 预设。该过程迭代进行——评估 → 修复一项 → 重新评估——直到零严重问题门禁通过或预算耗尽(默认预算:3 轮迭代)。门禁通过则标记完成;预算耗尽但仍有未解决问题则标记为“有未解决问题”,并列出未解决的发现项。

门禁 6 — Ship:运行 /finalize verdict。finalize 基于 10 轮完成度标准以及 brief/token 门禁,报告 READY / NOT READY / BLOCKED。随后打印最终判定与完整的已解决清单。

适用场景

适合希望在统一规范约束下推进界面设计工作、并让设计规范以文件形式沉淀下来以便跨会话复用的场景。命令描述指出其在需求简要、令牌、规范、构建、收敛、交付这一链路被需要时运行。

限制与说明

  • 本命令只做编排,不承担各阶段具体逻辑;有疑问时应调用对应阶段命令,而不是把其步骤内联进来。
  • 优先级规则:brief §6 学习到的约束与无障碍/正确性底线,在每个门禁处都优先于 spec.md 的组合选择。若约束与 spec.md 决策冲突,以约束为准,并更新 spec 区块以反映获胜的选择,同时标注 brief §6 引用。
  • 若某门禁被标记为降级,需在交付判定中列出这些跳过项及其下游影响,并说明这些缺口会降低交付判定的置信度。
  • 官方文本、收费、价格与平台支持等信息暂未提供。