SuperAPI AI 工具集

design-harness

设计与创作

查看项目

更新于 10-15 21:48

技能介绍

Design Harness 是一个设计流程编排技能,把产品设计的 SOP 作为可恢复、可审计的运行来执行。product-design 决定需要哪些设计工作,Design Harness 控制工作如何推进、暂停、恢复、对账与晋级,不重新定义其他技能的领域规则。

用途:当设计请求跨越多个专门技能或工具、用户说“继续/恢复/下一页”或要求完成已有设计计划、页面生成与评审审批验证需门控、修正只应失效受影响的下游产物、多页面需共享同一冻结的 shell/设计基线、工具结果未知或异步不足以证明完成时使用。一次性视觉想法、无需持久流程或证据链时不适用。

主要能力:以运行状态控制只执行下一步允许的转换;运行写入使用基于修订的 compare-and-swap 加短时文件锁,过期快照应以冲突失败;每次成功修订追加到哈希链日志以支持验证、重放、恢复与审计;稳定实体审计用 ID 而非数组位置;权限影响分析跨运行只读。调度循环:先 next-action 查看转换,再用 dispatch 发出幂等调度包,多 worker 环境用 claim-dispatch --worker-id ... 认领,长任务用 heartbeat-dispatch 续租(默认租约 900 秒),执行后通过 complete-dispatch --dispatch-id ... --worker-id ... --evidence-json ... 回传证据。

使用方式:默认入口 ensure-run,原子复用唯一活动运行或创建新运行;启动多步运行前按任务类型选择内置 SOP profile(product-to-ui、existing-product-next-page、page-family-batch、design-correction、stitch-high-fidelity-delivery、design-to-implementation)。运行时可执行:python skills/design-harness/scripts/design_harness.py status --store <project>/.design-harness --run-id <run-id>。

限制:存在多项硬性门控,如未确认行为/导航决策前不得进行视觉执行;不得绕过未完成调度回执;RunConflictError 需重载后从新状态重试;日志完整性失败阻止重放;历史审计只读,时间旅行不授权回滚;存在阻塞 guard 发现时不得晋级候选;未知写入结果进入 RECONCILING 不得盲目重试。具体配置与更多命令见 references/cli.md 等文档。