SuperAPI AI 工具集

design-handoff

办公与效率

查看项目

更新于 10-16 00:23

技能介绍

用途:位于设计与规划之间的接缝。它读取设计产物,产出 /planning:plan 前置检查所需的 design-gate 证据,并生成以产物为依据的交接摘要。

主要能力:对 design-threads.md 逐线程做二元门禁检查,要求每个线程满足之一——RESOLVED(产物中记录了决策依据,仅写“decided”不算)、directional(方向已定且剩余细节带研究标签)、TAGGED-DEFERRED(有明确研究标签指明需外部调研)。存在未解决且无标签的线程即 FAIL,列出问题线程并退回 /planning:design,不做交接。若 design-threads.md 不存在,则检查同路径的 design-resolution.md(/planning:design 的提前退出产物),两者皆无同样 FAIL。门禁通过后生成交接摘要,内容包括:已解决决策及其记录的依据、带标签的待研究项、产出的设计产物、实现的依赖顺序、扩展/配置/可观测性线程状态、评审路由说明,以及可选的机械化说明。最后输出恢复提示,便于新会话仅凭持久化产物从 /planning:plan 继续。

用法:设计产物位于 <contract_dir>/<topic-slug>/design/(默认 docs/topics/),<topic-slug> 由任务或分支名推导(kebab-case,≤40 字符,与 /planning:design 和 /planning:plan 共用);contract_tier: local 下的 memory slice 亦同。根、层级与优先级按 ${CLAUDE_PLUGIN_ROOT}/reference/topic-docs.md 的 topic-docs 绑定解析。

限制:它不做设计探索或线程解决(属 /planning:design),不做实现规划(属 /planning:plan),也不是会话中期保存点。不得因线程“看起来次要”而把 FAIL 弱化为警告;本技能是唯一规范的门口实现。