SuperAPI AI 工具集

aile-pencil-design

设计与创作

查看项目

更新于 10-16 09:52

技能介绍

用途:当 Story 涉及 UI/交互变更时,本技能在阶段 2 产出可审查、可执行、可回溯的设计产物;纯后端、数据处理、脚本、配置调整等无可见 UI 变化时可跳过,但需在 analysis.md 写明无 UI 设计及理由。

主要能力:以 MCP-first 方式把设计描述升级为设计执行规范与证据化门禁。产出 docs/plans/{Story-Key}/design.pen(推荐),并在同目录 analysis.md 回填 UI 设计章节,含页面结构、核心交互流程、状态设计、与 PM UI 示意对照说明、关键截图与布局检查结论。

使用方式:先固化输入契约(页面/模块边界、正常/空/加载/异常状态矩阵、交互路径、复用策略)。执行前做 Pencil MCP 可执行性预检,确认 Pencil 已启动、MCP 已连接、目标文件位于工作区、约定保存策略;失败时标记阻塞并输出最小线框说明。随后按顺序调用 open_document、get_editor_state、get_guidelines、batch_get、get_variables。分批构图,每批 batch_design 不超过 25 个操作,先骨架后细节。每批做质量门禁:snapshot_layout(problemsOnly=true)检查重叠/裁剪/越界、常规复核结构、get_screenshot 抽样关键节点。最后回填 analysis.md 并准备 G2 审查材料。

限制:MCP 不可用时须标记阻塞并降级为线框说明,不得跳过 UI 章节;权限/连接异常先检查 Pencil 是否运行、MCP 是否可见、工作区权限;关键批次后需手动保存并落 Git。进入开发前须满足 UI DoD:产出并保存 design.pen 或明确无 UI 设计、四态覆盖、主流程与失败回路有反馈、检查与截图验收通过、analysis.md UI 章节回填完整。