SuperAPI AI 工具集

pencil-sync-after-prototype-workflow

办公与效率

查看项目

更新于 10-16 00:00

技能介绍

用途:为 Axhub Make 项目的新建或重构原型/组件补齐 Pencil 设计稿,并强制代码、设计与规格持续同步。本技能只补充顺序约束,不重复已有细节规范。

主要能力与流程:1) 目标目录为 src/prototypes/<name>/ 或 src/components/<name>/,<name> 使用小写字母、数字、连字符;2) 先按既有规则完成 spec.md,再完成 index.tsx,并运行验收命令确认原型可交付;3) 在目标目录生成 <name>.pen,以当前 spec.md + index.tsx 为唯一基线 1:1 回建,结构、尺寸、区块层级、文案、主要交互命名须一致,不一致先修正;4) 回写 spec.md,补充 .pen 路径、主画板、模块映射,并记录进入双向同步维护状态;5) 在 index.tsx 顶部补充同步注释,注明更新时必须同步更新同目录 .pen 与 spec.md,且注释需含具体文件名 <name>.pen。

必要用法:执行生成 .pen / 截图验收前,先调用任意 Pencil MCP 工具(如 get_editor_state / open_document / get_screenshot);若 MCP 不可用或失败须立即停止并告知用户需先开启或安装本项目 MCP 环境,至少能调用 Pencil MCP。验收命令为 node scripts/check-app-ready.mjs /prototypes/<name> 与 node scripts/check-app-ready.mjs /components/<name>。交付定义:spec.md、.pen、index.tsx 三者同时存在并同步,index.tsx 顶部存在同步注释,check-app-ready.mjs 结果为 READY,并返回三个文件路径。

限制:后续任何对 spec.md、.pen、index.tsx 的修改都必须三者同步,只改代码未改 Pencil 不视为完成交付。涉及收费、价格、平台、效果等资料暂未提供。