SuperAPI AI 工具集

ui-design-feature

设计与创作

查看项目

更新于 10-15 21:48

技能介绍

用途:当功能名称已存在,但角色、动作、状态、权限、失败路径或完成证据不清晰时,或团队准备依据单薄需求直接画界面、做实现时,用本技能把功能想法转化为可观察的产品行为契约。它不用于选择视觉风格、生成最终 UI、设计后端架构或重写已批准的导航模型。

主要能力:建立事实来源,区分已确认、提议和待决策内容;定义结果,说明执行者、情境、期望结果与范围外行为;建模产品对象,识别业务对象、生命周期归属、版本/范围键及关系;定义动作,为每个用户或智能体动作记录前置条件、输入、可见结果、副作用、证据、取消/撤销与失败处理;定义状态,覆盖正常、空、加载/运行、等待人工、阻塞/冲突、失败、取消和恢复等状态;定义权限,记录谁可查看、修改、批准、覆盖、导出或执行自动化,未知权限保持待决策;定义证据与验收,状态标签不等于证明,需说明何种产物、事件、批准或运行时结果证明成功;发布契约,使用 references/feature-contract.md 的结构,导航问题交给 ui-design-nav,页面延续约束交给 ui-design-continuity。

使用方式:在调用方提供的规范功能/页面区段内工作,保留 ID、版本和任务引用;若已有契约覆盖所需行为,应检查并复用,返回阶段证据而非重写;不要创建并行产品规格或重新设计导航。单功能请求可独立使用本技能;Harness 调度仅限其行为阶段,证据返回该调度,不重启 ui-design-spec 入口。

适用场景:功能需求不明确、UI 工作早于动作/状态/权限/证据定义、需在不重设计已批准 IA 或品牌结构的前提下细化产品行为、需要让“完成”“已批准”“已交付”具有可验证含义。

限制:不负责视觉风格、最终 UI、后端架构或导航模型重写;不得虚构权限,批准、覆盖、AI 执行和破坏性操作需明确规则;提案须标注,不能伪装成已确认行为;最终确定前参见 references/anti-patterns.md。