1. 基本信息
| 项目 | 内容 | 数据来源 |
|---|---|---|
| 正式名称 | Material Design 3 UI Skill | — |
| 作者/维护者 | skydashnet（个人开发者） | GitHub API |
| 来源链接 | https://github.com/skydashnet/material-design-3-ui-skill | — |
| 许可证 | MIT（仓库根目录 LICENSE 全文核实为真实 MIT 文本，与 GitHub 检测结果一致） | GitHub API + 文件核实 |
| GitHub Stars / Forks | 113 / 9 | GitHub API（认证取数） |
| 最新版本 | v1.1.0（2026-08-17，CHANGELOG 记录） | 仓库文件核实 |
| 安装方式 | 一条命令跨 7 个 agent 平台安装（见第 10 章） | 官方 README |
2. 功能介绍与亮点
这是一个纯 Markdown 的设计指导型技能，帮助团队按 Google Material Design 3（M3）规范设计与审查界面，而不是停留在“看起来像 Material”的表面模仿。核心亮点：
- 十步设计工作流 + 交付前自查：从需求理解到语义化设计令牌、无障碍校验、响应式布局规格、开发者交接文档，最后跑一遍八大类自查清单才算完成，避免“能跑但不合规”的半成品。
- 渐进式加载架构：主文件
SKILL.md被设计成精简的“决策引擎”，真正的知识深度（配色系统、排版、动效、导航、表单、无障碍、常见反模式等）拆进 13 份按需加载的参考文档，既不占满上下文，又保留完整深度。 - “克制的表现力”（M3 Expressive with restraint）：明确要求色彩、形状、动效等表现手法必须服务于层级和可用性，禁止为装饰而装饰。
- 零运行时依赖：技能本体不执行任何代码、不联网、不需要凭据，只引用 m3.material.io 与 Android 官方文档供参考。
- 原生跨 Agent 设计：安装脚本一次覆盖 Claude Code、Codex、Antigravity、Kiro、OpenCode、Hermes Agent、OpenClaw 七个目标，而非事后补丁式适配。
3. 适用场景
所属分类：前端与设计
适合没有专职设计师、需要独立把 Android（Jetpack Compose）或 Web 界面做到真正符合 Material Design 3 规范的初中级开发者与小团队；也适合在交付前对已有界面做一次 M3 合规性与无障碍自查。
4. 跨 Agent 兼容性
| Agent | 结论 | 依据 |
|---|---|---|
| Claude Code | 原生支持 | 安装脚本 --agent claude，写入 ~/.claude/skills/ |
| Codex | 原生支持 | 安装脚本显式提供 --agent codex |
| OpenClaw | 原生支持 | 安装脚本显式提供 --agent openclaw，另有专用 OPENCLAW_STATE_DIR 环境变量覆盖 |
| Hermes Agent | 原生支持 | 安装脚本显式提供 --agent hermes |
技能内容是不含任何 Claude 专属工具调用的纯 Markdown 指令，四个平台均已在安装脚本层面验证过对应的技能目录写入路径。
5. 推荐理由
Material Design 3 规范容易在视觉上模仿、却很容易在语义和无障碍层面用错——这正是本技能要堵住的缺口：它不是又一份文档摘抄，而是一套带交付关卡的决策流程，逼着设计过程按规范的真实意图走完，而不是抄个圆角就算数。在同类 MD3 相关技能里，它同时做到了“MD3 专属深度”与“零依赖、可审计、七平台原生适配”，安装成本和安全风险都接近零。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 4 | GitHub 113 stars / 9 forks，star:fork 比例健康、无刷星迹象；作者为个人开发者，第三方平台未见独立讨论 |
| 可用性 | 9 | 一条命令即可跨 7 个 agent 平台安装；SKILL.md 主文件 + 13 份分级参考文档 + CHANGELOG/CONTRIBUTING/自测脚本齐全；v1.1.0 发布于 2026-08-17，在活跃维护窗口内；MIT 免费、无付费依赖 |
| 安全性 | 9 | 纯提示词/知识型技能，运行时无代码执行、无联网外发、无需任何凭据；可选的安装脚本仅复制文件到技能目录，无遥测；License 经逐字核实为真实 MIT 全文 |
综合评分：7.33
安全检查清单： ① Shell 命令/权限：技能本体不执行任何 shell 命令；可选安装脚本仅做文件复制，无需持续权限 ② 联网外发：无，正文仅引用官方文档链接供人工查阅，不发起网络请求 ③ API key/凭据：不需要 ④ 可疑指令：未发现 prompt injection 或与任务无关的品牌植入内容 ⑤ 作者信誉：GitHub 账号 2018 年创建，历史仓库记录正常，无造假迹象 ⑥ License：仓库根目录 LICENSE 为真实 MIT 全文，与 GitHub 自动检测结果一致 ⑦ 最近维护：v1.1.0 发布于 2026-08-17，距今约 3 周，在活跃窗口内
7. 跟同类 Skills 相比的优势
| 维度 | Material Design 3 UI Skill（本技能） | hamen/material-3-skill | ux-ui-agent-skills | accessibility-addyosmani-web-quality-skills |
|---|---|---|---|---|
| 定位 | MD3 决策流程 + 交付前审查，纯指导不产代码 | 面向 Compose/Flutter/Web 的 MD3 代码生成器，含十维度自动合规评分 | 覆盖设计令牌、组件、审查、无障碍、文案等 17 个环节的完整设计系统流水线 | 专注 WCAG 2.2 逐条无障碍审计并给出可落地修复代码 |
| 规模/热度 | 113★，新近发布 | 约 1.4k★，规模更大 | 892★ | 所属合集仓库 2,533★（不代表本子技能自身热度） |
| 覆盖范围 | 仅 Material Design 3 | 仅 Material Design 3，但落到具体代码产出 | 通用设计系统全流程，不限定某一套规范 | 仅无障碍单一维度，不限定设计系统 |
| 跨 Agent 支持 | 明确支持 Claude Code / Codex / OpenClaw / Hermes Agent 等 7 个平台 | 未见跨平台安装说明 | 面向“Claude Code 或任意 Claude 驱动的 IDE”，未提及其他 agent | CLI 一键安装或官方插件市场，覆盖 Claude Code / Codex / Gemini CLI |
本技能与 hamen/material-3-skill 同样深耕 Material Design 3，但定位不同：前者训练设计决策与审查能力，后者直接产出代码并打分，两者可以互补而非替代。相比覆盖面更广的 ux-ui-agent-skills，本技能牺牲了通用性换来了 MD3 专属深度与更小的安装/维护负担；相比 accessibility-addyosmani-web-quality-skills，本技能覆盖的是整套 MD3 规范而不只是无障碍这一个切面。
8. 用户评价
该技能目前在第三方平台尚无具名用户评价；仅有若干技能聚合站点（如 SkillsLLM）转载了其自述描述，其中 SkillsLLM 标注该仓库通过了其自动化安全扫描、未发现高危问题——这是一项自动化扫描结果，不构成人工评价。
9. 其他补充
仓库自带 tests/validate_skill.py 自测脚本与 CONTRIBUTING.md，方便有意贡献参考文档（如补充其他平台的组件规范）的开发者参与共建。README 明确声明本项目为社区项目，“unofficial and not endorsed by Google”。
10. 安装使用方式
macOS / Linux：
curl -fsSL https://raw.githubusercontent.com/skydashnet/material-design-3-ui-skill/main/install.sh | bashWindows（PowerShell）：
irm https://raw.githubusercontent.com/skydashnet/material-design-3-ui-skill/main/install.ps1 | iex手动安装：
git clone https://github.com/skydashnet/material-design-3-ui-skill.git
cd material-design-3-ui-skill
./install.sh --agent claude # 或 codex / antigravity / kiro / opencode / hermes / openclaw
./install.sh --all # 一次装入所有已识别的 agent
./install.sh --detect # 只装入本机已检测到的 agent安装脚本会把技能包文件复制到对应 agent 的技能目录（如 ~/.claude/skills/material-design-3-ui/），无需重启；下次涉及界面设计或 Material Design 3 相关请求时 agent 会自动加载。
11. 注意事项
- 安装脚本采用
curl | bash/irm | iex直接执行模式，建议首次使用前用手动 clone 方式查看脚本内容再运行。 - 仅覆盖 Material Design 3 这一套规范，不是跨设计系统的通用工具；也不直接生成实现代码，产出是设计决策与审查结论，需要配合具体框架的实现工具落地。
- 最近一次提交为 2026-08-17，此后约三周未见新提交，需持续关注后续维护频率。
- 非 Google 官方项目，README 已明确声明为社区维护、未获 Google 背书。