1. 基本信息
| 项目 | 内容 | 数据来源 |
|---|---|---|
| 名称 | material-3-skill | — |
| 项目自述名称 | Material Design 3 Skill | GitHub README |
| 作者/维护者 | Ivan Morgillo（独立开发者，10 余年 Android 原生开发经验） | GitHub API + 作者个人博客 |
| 来源链接 | https://github.com/hamen/material-3-skill | — |
| 许可证 | MIT | GitHub API + LICENSE 原文核对 |
| GitHub Stars | 1,166 | GitHub API |
| Forks | 60 | GitHub API |
| 最新版本 | v1.1.1（2026-06-29 发布） | GitHub Releases |
| 安装方式 | npx skills add、Claude Code 插件市场、手动 symlink 三种渠道均可 |
官方 README |
2. 功能介绍与亮点
Material Design 3 Skill 把 Google Material Design 3（Material You）规范固化成 AI 编码助手可直接遵循的实现指南，覆盖 Jetpack Compose（主要目标平台）、Flutter 与有限的 Web（@material/web，官方已进入维护模式）。
核心能力：
- 设计令牌体系：颜色、字体排版、形状、层级（elevation）、动效六大类令牌的完整映射表，并给出 Compose / Flutter / Web 三端的具体写法
- 30+ 组件速查表：按钮、卡片、导航栏、输入框等组件在三端的名称与用法对照
- 主题生成与响应式布局：动态取色（
dynamicLightColorScheme）、5 级窗口尺寸自适应布局、可折叠设备处理 - MD3 合规审计模式：
/material-3 audit对目标代码或线上页面按色彩、排版、形状、层级、组件、布局、导航、动效、无障碍、主题 10 个维度打分，输出带具体修复建议的报告 - 已跟进 Google I/O 2026 的 Material 更新（Compose-first 路径、8dp 间距系统、表现力布局）
主要亮点：作者本人有 10 年以上 Android 原生开发背景，写作动机明确（AI 工具常默认生成过时的 MD2 风格代码）；项目 10 周内从零涨到 1,000+ star，作者在个人博客上以“我的仓库第一次破千星”记录了这一有机增长过程；仓库最近一次提交在 2026-07-15，维护活跃。
3. 适用场景
所属分类：前端与设计
适合使用 Jetpack Compose、Flutter 或 Web 技术栈、需要让 AI 编码助手准确遵循 Material Design 3 规范的 Android/移动端与前端开发者：搭建新组件或页面时避免默认输出过时的 MD2 视觉语言；批量生成符合规范的主题配色；对现有代码库或已上线页面做 MD3 合规审计并拿到可执行的修复清单。
4. 跨 Agent 兼容性
- Claude Code：原生支持——仓库自带
.claude-plugin/marketplace.json，可通过/plugin marketplace add+/plugin install两条命令完成安装，也是作者在 v1.1.1 中专门修复的安装路径 - Codex：支持——README 提供明确的手动安装步骤（clone 仓库后将
skills/material-3软链接进~/.codex/skills） - OpenClaw：未验证——README 提到“其他 SKILL.md 加载器”可用同样的软链接方式安装，但材料中未见作者或第三方针对 OpenClaw 的专门验证
- Hermes Agent：未验证——抓取材料未提及
5. 推荐理由
由资深 Android 开发者独立打造并持续维护的 Material Design 3 实现指南，用规范化的设计令牌与合规审计流程，替代 AI 工具默认输出的过时 MD2 风格代码。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 7 | 1,166 star、60 fork，10 周内有机增长（作者本人博客记录为其个人仓库首次破千星的里程碑），第三方技术博客 Bright Coding 亦撰文推荐；GitHub issue 区有至少 6 位不同用户具名互动 |
| 可用性 | 9 | npx skills add 一条命令即可安装，另提供 Claude Code 插件市场与手动 symlink 两条备选路径；SKILL.md 含完整决策树、组件表与代码示例，另配 5 份细分参考文档；最近一次提交在近 3 个月内；全程无需付费依赖 |
| 安全性 | 9 | 见下方检查清单 |
安全检查清单：
- shell 命令执行范围：技能正文本身不执行任何 shell 命令；仅在“合规审计”环节给出几条只读
grep示例供用户自行选用，不涉及写入或联网 - 联网外发：无数据外发，全部内容为设计规范知识与代码生成指导
- API key/凭据：不需要任何密钥或账号
- 可疑指令：抓取 SKILL.md 全文（约 31KB）与全部安装说明，未发现面向 AI 助手的隐蔽指令或异常代码
- 作者信誉：作者为具名个人开发者（个人博客、X 账号公开可查），星标增长有作者本人博客与第三方博客交叉印证，未见刷星或 SEO 操纵措辞
- License：MIT，已核对仓库 LICENSE 原文
- 最近维护：最近一次提交 2026-07-15，在近 3 个月窗口内，非弃置项目
7. 跟同类 Skills 相比的优势
| 同类 Skill | 定位 | 与本 skill 的差异 |
|---|---|---|
| power-design | 面向幻灯片/演示文稿的品牌化设计原则集合，聚焦“让 AI 生成的 slides 不像 AI 做的” | 服务对象是演示文稿设计而非可复用 UI 组件系统，不涉及具体设计规范的令牌体系或合规审计 |
| claude-design-card | 生成 14 种格式的设计卡片（封面图、社交分享卡、编辑排版等） | 面向营销物料与视觉素材生成，不是面向生产代码的组件/主题实现指南 |
| swiftui-design-skill | SwiftUI 前端设计规则与品牌资产指南 | 仅覆盖 SwiftUI 单一平台，不提供跨 Compose/Flutter/Web 的规范映射与合规审计能力 |
三者都属于“设计”大类下的技能，但分别指向演示文稿、营销素材、单一平台 UI 规则；material-3-skill 是目前少见的、把一份完整官方设计规范（含 Google I/O 最新更新）系统性转译为跨三端可执行实现指南、并附带自动合规审计的技能。
8. 用户评价
技术博客 Bright Coding 于 2026 年 5 月发表评价文章，称该技能“能够提炼完整的 Material Design 3 规范”，生成“生产级、符合规范的代码”，效率优于查阅官方文档或搜索 Stack Overflow；同时也指出其局限——内容是作者“尽力而为的提炼版本”，可能随 Google 官方更新出现滞后，Web 平台支持有限，生产环境仍建议对照官方文档核实。
9. 其他补充
作者在个人博客记录了项目从发布到 10 周内突破 1,000 星标、52 次 fork 的增长过程；GitHub issue 区已有 6 位不同用户报告过问题（含一次安装路径失效的 bug，作者已在 v1.1.1 中修复），显示有真实用户在持续使用。
10. 安装使用方式
- 推荐方式（适配 Codex、Claude Code、Cursor 等多 Agent场景）：
npx --yes skills add hamen/material-3-skill --skill material-3 -y - Claude Code 插件市场：
/plugin marketplace add hamen/material-3-skill /plugin install material-3@material-3-skill - Codex 或手动安装：
git clone https://github.com/hamen/material-3-skill.git mkdir -p ~/.codex/skills ln -s "$(pwd)/material-3-skill/skills/material-3" ~/.codex/skills/material-3 - 安装后无需重启，直接用自然语言描述需求（如“帮我用 MD3 规范做一个登录表单”）即可触发；审计功能需显式调用
/material-3 audit [URL 或文件路径]
11. 注意事项
- 内容是作者对官方规范的“尽力而为”提炼版本，非 Google 官方出品，且不能替代官方文档；规范更新后可能存在同步延迟
- Web 平台支持有限——
@material/web官方已进入维护模式，且不含 M3 Expressive 的最新表现力特性 - 在 OpenClaw、Hermes Agent 上的兼容性尚未经过验证，安装前建议先小范围测试
- 仓库目前由作者一人维护，长期可持续性有待观察