用途:处理 /moai design 的设计产物导入与三路径路由,将设计来源统一转换为 .moai/design/tokens.json 等标准产物,供 expert-frontend 消费。
主要能力: Path A(Claude Design):导入交接包,支持 ZIP(含 manifest.json、tokens.json、components/、assets/)与单文件 HTML;解析前校验格式版本白名单(默认 ["1.0"]),执行安全扫描(拒绝可执行文件、符号链接、路径穿越、绝对路径),提取 tokens.json、components.json、assets/、copy.json,并做令牌归一化与资产类型校验。 Path B1(Figma):需 moai-meta-harness 可用,动态生成项目级 .claude/skills/my-harness-figma-extractor/SKILL.md,凭据仅以环境变量名引用(如 FIGMA_TOKEN),不写入技能文件。 Path B2(Pencil):同样经 meta-harness 生成 my-harness-pencil-mcp,使用 .pen 文件与本地 MCP 端点(默认 http://localhost:11111)。
使用方式:路径选择通过 AskUserQuestion 呈现,选择结果持久化到 .moai/design/path-selection.json。品牌上下文 .moai/project/brand/ 为所有路径的约束父级,任何路径不得覆盖。输出统一写入 .moai/design/ 的保留路径。
错误码:DESIGN_IMPORT_NOT_FOUND、UNSUPPORTED_FORMAT、UNSUPPORTED_VERSION、SECURITY_REJECT、MISSING_MANIFEST;出错时引导切换 Path B(moai-domain-brand-design)。
适用场景:从 Claude Design、Figma 或 Pencil 导入设计令牌与组件,衔接设计系统与前端实现。
限制:DOCX、PPTX、PDF、Canva 链接暂不支持(属 Phase 2 规划);Path B1/B2 依赖 meta-harness 技能;版本白名单外直接拒绝且不产生部分输出。