shield_lock
金大哥
← 返回 Skill 列表
extension
分类: 开发与工程API Key 暂未确认

Material Agent Readiness Eval - 设计系统评估

帮助设计师评估设计系统材料的 Agent 就绪度，提供证据驱动的 HTML 报告、改进建议与优化复验，帮助团队明确可交给 Agent 的工作范围。

person作者: AIDesignIntelligencehubModelScope
download下载资源包

Material Agent-readiness Eval｜设计材料的 Agent 就绪度评估

帮助设计师和设计系统团队回答：现有设计材料可以放心交给 Agent 做到哪一步，还需要补齐什么？

本 Skill 将 Figma 组件库评估与设计系统 Markdown 审计整合为一个入口。它依据实际材料判断可用范围，解释问题对设计生产的影响，并提供可验证的改进建议与 HTML 报告。

能力与价值

| 能力 | 解决的问题 | 主要产出 | |---|---|---| | Figma 组件库评估 | Agent 能否找到正确组件、理解用途、配置属性、组合实例并提取实现依据？ | 五个维度的就绪度分析、组件与变量证据、优先问题和 HTML 报告 | | Markdown 契约审计 | 文档是否足以支持视觉设计组合，或独立实现完整交互组件？ | 按用途评估的 L0–L7 覆盖、矛盾与缺口、评分和 A–F 等级报告 | | 材料准备指导 | 不知道应该提供哪些设计系统资料、由谁补充哪些决策？ | L0–L7 准备清单、最低可用材料建议与待确认事项 | | 有依据的优化与复验 | 如何修复问题，同时保留已有组件关联和设计决策？ | 分项改进方案、授权范围内的修改、同口径的优化前后对比 |

评估关注材料能否支持实际工作，而非只检查文档数量或视觉美观。每个关键问题都应说明：缺什么、会影响什么、去哪里补、具体补什么、做到什么算完成。

五个评估维度

Figma 组件库评估围绕 Agent 使用组件的五项能力展开，从“能否找到”逐步检查到“能否依据结构化信息实现”。

| 维度 | 评估什么 | 对 Agent 使用的价值 | |---|---|---| | 可发现 Discoverable | 组件命名、分类和用途是否明确，能否根据设计意图定位正确组件；具备发布库检索证据时，再验证实际检索效果 | 减少找不到组件、选错组件或重复创建的问题 | | 可理解 Understandable | 组件的用途、适用边界、层级语义、属性、可选内容和 Token 含义是否清楚 | 让 Agent 理解何时使用、如何使用，减少依赖外观猜测 | | 可配置 Configurable | Variant、Boolean、Text、Instance Swap 等属性是否合理暴露，合法配置与取值能否明确枚举 | 让 Agent 通过组件属性完成配置，减少修改内部图层的需要 | | 可组合 Composable | 嵌套组件、内容区域、替换范围和复用边界是否明确，能否在保留实例关联的前提下组合 | 支持可靠复用与页面搭建，减少重画、拆散实例或破坏关联 | | 可实现 Implementable | MCP 数据能否直接支持组件属性、层级布局、内容插槽及 Token 绑定的结构化表达 | 为 Coding Agent 提供稳定的实现依据，减少对截图和命名的推测 |

这五个维度是 Figma 工作流的评估模型。Markdown 工作流按 L0–L7 审计入口与治理、设计意图、基础规则、组件契约、实现与验证、生命周期，并区分“仅视觉组合”和“完整交互实现”；两套评分分别计算，不混为同一套标准。

核心结构

这是一个技能包，内部包含两条工作流，无需分别安装。

SKILL.md                         总入口：能力说明、依赖检查与任务路由
agents/openai.yaml               可选的宿主展示元数据
skills/
├── material-agent-readiness-eval-figma/
│   ├── WORKFLOW.md              评估 → 方案与优化 → 复验
│   ├── references/              取证、阶段、评分、宿主接入和报告规范
│   ├── scripts/                 前置检查、报告构建与校验
│   └── assets/                  HTML 模板与语言资源
└── material-agent-readiness-eval-markdown/
    ├── WORKFLOW.md              材料指导 / 审计 / 优化
    ├── references/              L0–L7 模型、用途标准与报告规范
    ├── scripts/                 静态扫描、评分、报告构建与校验
    └── assets/                  HTML 模板与语言资源
  • Figma 工作流：检查连接和取证能力 → 确认 Page 范围、评估深度和主要检索语言 → 只读评估并出报告 → 按用户批准的方案优化 → 复验。
  • Markdown 工作流：确认用途和材料范围 → 按 L0–L7 审计 → 生成报告与补全建议 → 按请求优化并复验。
  • 同时提供两类材料时，分别评估、分别输出结论；不混合两套分数，也不在缺少直接证据时声称它们与代码或彼此一致。

环境与 Figma MCP 依赖

| 场景 | 必要条件 | |---|---| | Markdown 指导、审计与优化 | 可读取提供的材料；不依赖 Figma MCP 或代码仓库 | | 生成 HTML 报告 | 本地文件访问与 Node.js 18+；使用可选 Markdown 静态扫描时另需 Python 3.10+ | | Figma 评估 | 宿主支持官方远程 MCP（Streamable HTTP + OAuth），已完成认证，实际可调用 use_figma，并通过目标文件的只读访问检查 | | 执行 Figma 优化 | 在评估条件之外，还需实际写入能力、目标文件编辑权限和获批的改进方案 |

仅有 get_figma_data / download_figma_images 等基础读取或图片导出工具，不满足本版本 Figma 流程的启动条件。安装 Skill 本身不会自动建立 Figma 连接。

通过连接检查后，再按实际证据判断评估范围：完整取证（FULL）可形成完整质量评分；受限取证（LIMITED）只报告已观察证据的得分、覆盖和限制，不给最终整体质量分或等级。证据不足以形成报告时停止；发布库就绪度须另有真实检索与发布状态证据。评估始终只读，取证能力与写入能力分别判断。

接入步骤与详细检查见 宿主接入规范。

使用方法

  1. 在支持技能的 Agent 宿主中安装本包，并确认所需的文件访问与运行环境；使用 Figma 时还需完成上述 MCP 检查。
  2. 在对话中指定 material-agent-readiness-eval，提供 Figma 链接或 Markdown 文件/目录，并说明评估或优化目标。
  3. 补充尚未明确的范围与用途，阅读评估报告；需要优化时再确认改进项目，最后查看复验结果。

示例一：评估 Figma 组件库

使用 material-agent-readiness-eval 评估这个 Figma 组件库：[Figma 链接]。
评估范围为所有 Page，深度为 FAST，主要检索语言为中文。
先只读评估，输出 HTML 报告，说明最影响 Agent 使用的三个问题。

可选深度为 FAST、STANDARD、DEEP；深度增加不会自动补齐连接缺少的证据能力。

示例二：审计 Markdown 设计系统

使用 material-agent-readiness-eval 审计我提供的设计系统 Markdown 目录。
这些材料需要支持 Coding Agent 独立实现完整交互组件。
请说明缺失的设计契约、对实现的影响、补全位置和验收标准，并输出 HTML 报告。

如果只用于视觉设计组合，将第二句替换为“这些材料仅用于视觉设计组合，不要求独立实现完整交互组件”。

示例三：准备材料或继续优化

使用 material-agent-readiness-eval，帮我准备一套用于视觉设计组合的材料清单，
按 L0–L7 说明要提供什么、谁来确认，以及最小可用版本应包含什么。

请根据刚才的评估报告提出改进方案，列出目标、依据、预期收益、风险和验证方式。
我确认执行范围后，再优化并用相同范围和标准复验。

交付结果与适用边界

  • 评估：经过脚本校验的独立 HTML 报告，以及支撑结论的数据、证据范围、优先问题和改进建议。
  • 优化：明确的修改范围、执行结果与剩余事项；需要前后对比时，保留原始基线并采用相同评估口径。
  • 材料指导：可执行的准备清单与待确认设计决策；指导本身不等于完成审计。

适用于已有 Figma 组件库、Agent 可读的设计系统文档及其准备与维护。不用于从零生成设计系统、通用代码审查、普通 Markdown 润色或页面开发。证据不可得不等于设计有缺陷；评分不替代真实的使用与实现验证。

Agent 执行入口

按材料选择并完整读取对应工作流，再按其路由加载必要参考资料。本页介绍不替代工作流中的评估、评分和变更规则。

  • Figma 组件库：Figma 工作流。首次读取前遵循其宿主检查与评估协议。
  • Markdown 设计系统：Markdown 工作流。评估前明确“视觉组合”或“完整交互实现”用途；复用用户已给出的明确答案。
  • 未说明材料类型时，先确定是 Figma、Markdown 还是两者；两者并用时分别保存证据、评分与结论。

以本文件所在目录为安装根目录。两个工作流目录分别为 skills/material-agent-readiness-eval-figma/ 和 skills/material-agent-readiness-eval-markdown/。子工作流中的 <skill-root>、<this-skill> 均指其 WORKFLOW.md 所在目录；从那里解析 references/、assets/ 和 scripts/，不要依赖当前工作目录。打开包内 WORKFLOW.md 即可，不要求宿主发现第二个技能；仓库顶层维护脚本不是运行依赖。

保持所有审计只读。修改前遵循所选工作流的范围、证据、方案批准和验证规则。保留 Figma 组件身份与实例引用；高风险变更按目标逐项确认。不得编造缺失的设计决策，或在没有直接证据时宣称外部一致性、成功发布或优化完成。