메뉴
Penpot 设计↔代码桥 — read(读结构/样式/Token 实值) · sync(Token 双向同步) · generate(从设计生成组件骨架) · verify(设计↔代码一致性校验)。当 design_tool=penpot 且需在 Penpot 设计与前端代码间读取视觉数据、同步设计 Token、生成组件骨架或校验还原度时使用。read/sync 由 ui-designer 调用，generate 由 implementer 调用，verify 由 reviewer 独占。
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
项目走查 — 在隔离沙盒中以指定执行模式（缺省 standard 全阶段）把一个小型示例项目跑通整条 SDLC 工作流（初始化→核心执行链路→分支→异常→终止清理），逐路径观察各阶段/门禁/降级/恢复的真实行为，产出『框架本身 + 走查流程本身』两类改进建议，并把走查流程自身的改进经自更新协议回灌本 skill 迭代。与 framework-review 形成动静对偶：后者静态审元资产，本 skill 动态端到端自测。当用户想验证一次框架部署是否真能跑通、为非 Claude-Code 平台做行为级冒烟、或自测 workflow-framework-generator 生成的框架时使用。
测试 — 测试策略规划、测试编写与执行、覆盖率分析、缺陷记录。当需要规划测试策略、编写或执行测试套件、分析覆盖率或记录缺陷时使用。本 skill 不改源码（缺陷修复由 debug 负责），单任务 RED/GREEN 单元测试由 tdd-engine 负责，testing 聚焦集成/E2E 与覆盖盲区补充。
代码评审 — 任务粒度评审 (review) 与项目级健康度扫描 (scan) 双入口；代码质量检查、规范合规验证、安全漏洞检测、腐化指标扫描。当任务卡 GREEN 完成 / Sprint 发布前 / 用户要求扫描代码腐化时使用此 skill。审查范围限 src/ 业务代码：文档审查由 doc-review 负责；框架元资产 (.cataforge/) 审查由 framework-review 负责；Sprint 完成度由 sprint-review 负责。
统一上下文 I/O — 按需读取章节/实体、查询追溯关系、生成与写入、门禁校验。文档生命周期的单一入口；后端(知识图谱/文件)由框架按配置方案透明路由,调用方只表达意图。按操作分支见 references/。
功能走查 — 对交付项目的功能实现做验收式动态走查，两层正交判定：①功能是否兑现 spec（missing/drift/bug/pass）；②代码本身是否健康（复用 COMMON-RULES §统一问题分类体系的 code category）。用真实数据路径起真实服务复现，专捞门禁全绿仍漏的跨模块集成缝隙。当项目功能交付后需验收、Sprint 发布前做功能级复核、或用户要求走查某功能域时使用。与 framework-walkthrough 动静对偶：后者在沙盒自测框架 SDLC，本 skill 验收交付项目的功能实现。
框架元资产审查 — 对 .cataforge/ 下的 agents/skills/hooks/rules + workflow 拓扑做内容质量与一致性审查。与 platform-audit 形成内审/外审对偶；与 code-review/doc-review 服务于业务产物不同，本 skill 专审框架自身配置。当用户提到框架腐化、SKILL.md/AGENT.md 质量、agent 引用孤立、SKILL/MANIFEST 漂移、Workflow 完整性、model_tier 合规时使用。
| name | penpot-bridge |
| description | Penpot 设计↔代码桥 — read(读结构/样式/Token 实值) · sync(Token 双向同步) · generate(从设计生成组件骨架) · verify(设计↔代码一致性校验)。当 design_tool=penpot 且需在 Penpot 设计与前端代码间读取视觉数据、同步设计 Token、生成组件骨架或校验还原度时使用。read/sync 由 ui-designer 调用，generate 由 implementer 调用，verify 由 reviewer 独占。 |
| argument-hint | <op: read|sync|generate|verify> <target: UC-NNN|代码路径|sync-direction> |
| suggested-tools | file_read, file_write, file_edit, file_glob, file_grep |
| depends | ["context"] |
| disable-model-invocation | false |
| user-invocable | true |
权威划分（语义 vs 视觉实值）见 ui-spec 模板「权威源约定」。
设计工具 字段为 penpotsrc/styles/tokens.css（W3C Design Tokens 格式）+ 同步差异报告docs/reviews/design/DESIGN-REVIEW-{component_id}-r{N}.md（差异列表 + 修复建议）具体 MCP 工具名以平台 MCP 配置为准（Claude: .mcp.json / .claude/settings.json；Cursor: .cursor/mcp.json；OpenCode: opencode.json），运行时按可用工具列表自动发现。典型操作：读项目信息、读组件结构/样式/SVG、读写设计 Token、导出组件图像（export_shape）。工具列表中无 Penpot 工具时先 cataforge penpot ensure（若未部署则 cataforge penpot deploy），仍不可用返回 blocked。
程序化操作 Penpot 时以下限制不可绕过：
appendChild / insertChild 跨页静默 no-op（不抛错、返回成功但 shape 仍在原页），clone() 对非激活页 shape 返回 null，parent 只读；已有 board 无法编程搬到另一页，只能人工在 UI 剪切粘贴design_tool=penpot 时视觉稿 authoring 按 ui-spec 结构一规格一页建页：设计系统 / 各页面规格 P-NNN / 组件库分别落独立 Penpot 页面，board 创作期即落对页。Plugin API 无法事后无损重组（§Plugin API 已知限制），页面骨架必须在创作期先建好；退化路径（generateMarkup → SVG 重建）丢失 flex 布局、设计 Token、组件实例链接与文本可编辑性，不可作为重组手段。
读 Penpot 设计数据，供 sync/generate/verify 复用或独立做视觉 grounding。
export_shape 导出目标组件图像，供调用方做视觉自检（设计决策 / 还原度核对）ui-spec §1 Token 与 Penpot / tokens.css 对齐。tokens.css 是 ui-spec §1 的单向派生（非独立权威源）；ui-spec 自身的 graph 回流由 cataforge context ingest 负责，本操作只跨 ui-spec ↔ Penpot 一条边。按 sync-direction：
src/styles/tokens.css（单向投影，不读回 tokens.css 改 ui-spec）+ 差异报告cataforge context ingest 回流图后端；仅同步差异项，不全量覆盖从 Penpot 设计生成组件代码骨架。
比对 Penpot 设计与代码实现的视觉一致性。
export_shape 导出设计图像与已实现组件渲染对照，捕获逐属性比对漏掉的整体视觉偏差（布局错位 / 视觉层次失真），归入 DIFF / WARN；仅静态视觉，忽略交互/动画.cataforge/references/review-report-spec.md）cataforge penpot ensure 失败必须返回 blocked，否则 generate 在空数据上施工、sync 写空 Token