SuperAPI AI 工具集

ui-design-harness

设计与创作

查看项目

更新于 10-15 21:48

技能介绍

用途:ui-design-harness 用于把 ui-design-spec 的 SOP 作为可恢复、有证据支撑的设计运行来执行。ui-design-spec 决定需要什么设计工作,本技能控制工作如何推进、暂停、恢复、对账与晋级,避免重复已完成阶段或丢失授权。

主要能力:跨专家技能/工具持久协调;恢复已有设计执行或继续下一页/阶段;对页面生成、评审、审批、验证设置门禁;纠错时只使受影响的下游产物失效;多页面共享同一冻结外壳/设计基线;处理工具结果未知、异步或不足以证明完成的情况。

使用方式:默认入口为 ensure-run,用于“继续/恢复/下一页”及已知产品/范围/档案身份的新多步工作;先选择内置 SOP 档案(如 product-to-ui、existing-product-next-page、page-family-batch、design-correction、stitch-high-fidelity-delivery、design-to-implementation)。多步执行使用内置纯标准库运行时,例如:python skills/ui-design-harness/scripts/design_harness.py status --store <project>/.design-harness --run-id <run-id>。调度循环为:run next-action 查看转换,run dispatch 发出幂等调度包,多 worker 环境用 claim-dispatch --worker-id ... 认领(默认租约 900 秒),长任务用 heartbeat-dispatch 续约,执行指定 handler,再通过 complete-dispatch --dispatch-id ... --worker-id ... --evidence-json ... 返回结果。

适用场景:需要跨专家技能持久协调的设计工作流、需要门禁的页面生成/评审/审批/验证、需要最小范围纠错、多页面共享基线、工具结果不确定需对账的情况。

限制:不要仅因规范含多文档就使用,也不用于无需持久工作流、审批或证据链的一次性视觉想法;“继续规范”仍留在 ui-design-spec 规范模式。硬门禁包括:行为/导航决策未确认前不得视觉执行;专家执行不得绕过未完成的调度回执;RunConflictError 需重载后重试,不得强写陈旧快照;日志完整性失败阻断重放/恢复;历史审计只读,时间旅行不授权回滚;ui-design-review 有阻塞性 FAIL 或 NEEDS DECISION 时不得晋级候选;无明确批准不得进入用户审批状态;仅凭设计渲染证据不得声称实现/交付验证;未知写入/工具结果进入 RECONCILING,不得盲目重试。停止条件包括授权冲突需产品决策、需明确用户批准、提供方结果未知且对账未完成、所需证据/工具不可用、存在阻塞性门禁发现、请求动作会跳过阶段门禁。输出契约要求每轮报告运行身份与范围、当前状态、权威契约版本、新消费证据、已执行或拒绝的转换、失效的下游产物、下一允许动作、是否需要人工输入。