Pencil Design Bridge 是 UI/UX Agent Skill System 中的 Pencil 层技能。它的定位是设计工具桥接与可编辑设计工作区,而不是整个系统的核心架构者,也不是把 .pen 文件当作纯文本处理的解析器。
用途 该技能用于把已批准的 UI/UX 方向简报桥接到 Pencil 设计工作流。它适用于项目需要 Pencil MCP/工具或具备 Pencil 能力的智能体参与设计交接的场景。
运行模式 技能提供五种运行模式:
- brief:把已批准的方向简报转化为可供 Pencil 使用的设计简报。
- canvas-handoff:为 Pencil MCP/工具或具备 Pencil 能力的智能体准备指令。
- review-output:依据 UX、SEO/LLM、无障碍、品牌与实现约束评审 Pencil 输出。
- figma-code-handoff:为 Figma 或代码实现准备 Pencil 结果。
- config-check:在不直接读取 .pen 文件的前提下,检查当前运行时是否具备 Pencil 工具。
必需工作流 技能规定的工作流包括:读取 references/pencil-bridge-contract.md;确认来源简报已由 senior-ui-ux-orchestrator 批准或来自明确的用户决定;确认输入,包括产品/UX 旅程、面向公开页面的 SEO/LLM 约束、ui-ux-pro-max 设计智能、可选的 Stitch 输出或 Figma 约束、所需资产与禁止声明;使用 assets/pencil-handoff.template.md 生成交接包;仅通过 Pencil MCP/工具访问 .pen 文档,不得使用 shell 读取、grep、cat 或临时 JSON 解析;把 Pencil 输出视为候选设计产物,在进入 Figma、代码或生产使用前仍需评审。
安全规则 技能要求:不得在 Pencil 交接中存储 API 密钥、令牌、cookie、私有 URL、私有截图或 .env 值;除非确实调用了可调用的 Pencil 工具并存在产物路径或工具响应,否则不得声称 Pencil 工具已运行;如果 Pencil 工具不可用,应生成手动交接并将执行标记为 Skipped 或 Planned;如果 Pencil 输出与无障碍、可见事实、SEO/LLM 结构或实现可行性冲突,应转交 council 处理。
交接结构 交接包包含以下字段:Mode、Approved direction、Pencil tool availability、Input artifacts、Data excluded、Prompt or canvas instructions、Design-system constraints、Review criteria、Next owner、Checks。
校验 编辑该技能时需运行以下命令: python3 $CODEX_HOME/skills/.system/skill-creator/scripts/quick_validate.py $CODEX_HOME/skills/pencil-design-bridge python3 $CODEX_HOME/skills/senior-skill-architect/scripts/lint_production_skill.py $CODEX_HOME/skills/pencil-design-bridge python3 -m json.tool $CODEX_HOME/skills/pencil-design-bridge/evals/evals.json >/dev/null
适用场景与限制 该技能适用于需要把已批准 UI/UX 方向简报桥接到 Pencil 设计工作流、并进一步交接给 Figma 或代码实现的项目。其限制包括:必须依赖 Pencil MCP/工具访问 .pen 文档,工具不可用时只能手动交接;输出仅为候选设计产物,需经评审;不得在交接中携带敏感凭据或私有信息。关于收费、价格、平台支持范围等事实,资料中暂未提供。