企业官网建设流程全解析

Designer Skills开发者进阶：lint-frontmatter质量门禁与5条Skill质量标准详解

【免费下载链接】designer-skillsDesigner Skills Collection: agentic skills, commands, and plugins for design — from research to systems, UI, interaction, and delivery.项目地址: https://gitcode.com/gh_mirrors/de/designer-skills

Designer Skills（designer-skills）是一个面向 AI 智能体的设计师技能库，覆盖设计研究、设计系统、UI、交互设计与交付全流程。想为它贡献一个 Skill？核心关卡就两道：运行 scripts/lint-frontmatter.py 这个 frontmatter 质量门禁脚本，并通过 CONTRIBUTING.md 中定义的 5 条 Skill 质量标准。本文带你一次搞懂这套「机器检查 + 人工评审」的完整质量体系。

质量门禁是什么：为什么需要 lint-frontmatter

这个仓库收录了 9 个插件、100 多个 Skill 和 30 多个 Command。规模大了，格式问题就会拖垮可用性——Agent 是靠读取每个 SKILL.md 头部的元信息来发现并调用技能的，一个字段写错，技能就可能「隐身」。

lint-frontmatter就是这个仓库的质量门禁：一条命令扫遍全仓库，所有不合规的文件都会带着文件路径和行号被精准报出，提交前跑一遍，问题零遗漏 ✅

快速上手：一条命令检查全部文件

在仓库根目录执行：

python3 scripts/lint-frontmatter.py

• ✅ 全部通过：输出OK — N skills and M commands passed all frontmatter checks.
• ❌ 存在错误：逐条打印文件:行号: 错误原因，并以非零状态码退出（CI 中会直接标红失败）

CONTRIBUTING.md 明确要求：每次提交前都要跑一遍。它检查的范围是*/skills/*/SKILL.md和*/commands/*.md，即每个插件目录下的全部技能与命令文件。

lint-frontmatter 检查清单：机器帮你盯住的细节

Skill 文件检查项（每个 SKILL.md）

Command 文件检查项（每个 commands/*.md）

方括号格式是硬性要求：CHANGELOG.md 里就记录过，早期 argument-hint 不加引号导致 CLI 解析失败、技能无法加载，后来统一加引号修复。这正说明了门禁的价值——把踩过的坑固化成自动检查。

可以对照一个合格样例 interaction-design/commands/design-interaction.md，它的 frontmatter 严格遵循了上述格式。

5条Skill质量标准：机器过后的「人工关卡」

linter 只看格式，CONTRIBUTING.md 的Quality bar for skills定义了 5 条更深层的质量标准，决定你的 Skill 能不能被合入：

1️⃣ Linter 通过

python3 scripts/lint-frontmatter.py零报错。这是最低门槛，检查 frontmatter 字段、命名一致性、kebab-case 与基础文档结构。

2️⃣ description 是一个完整句子

它要同时告诉 Agent两件事：这个技能覆盖什么、什么时候适用——且控制在 120 字符以内。参考 SKILL_TEMPLATE.md 中的占位说明，一句话写清「教 Claude 什么 + 何时触发」。

3️⃣ "What You Do" 必须具体

正文要写明一个具体产出，而不是空泛话题。标准里给了经典对比：

• ✅ 「Design the confirmation strategy for a transactional email」（设计事务邮件的确认策略）
• ❌ 「Help with email design」（帮助做邮件设计）

前者是判断，后者只是主题。

4️⃣ 每个 H2 小节传授一个「判断力」

不只是罗列事实，而是编码一条 Agent 可复用的判断原则——读者读完，应该能把这条原则应用到没见过的场景里。比如 interaction-design/skills/fitts-law/SKILL.md 里「屏幕边缘是无限大目标，应留给常驻导航」就是可迁移的判断。

5️⃣ Best Practices 至少含一条「do not」

反模式往往是一段内容里价值最高的一行。「不要只做 X，而要 Y」能直接阻止常见错误，这也是该仓库技能质量普遍扎实的秘密。

附赠：Command 的 5 条质量标准

Command 是「动词」（工作流），Skill 是「名词」（领域知识），仓库遵循skills are nouns, commands are verbs的原则。Command 就绪标准同样五条：

1. Linter 通过（同上）；
2. 每一步都点名一个 Skill——步骤行末尾写「usingskill-nameskill」，如 interaction-design/commands/design-interaction.md 的 7 个步骤各驱动一个技能；
3. 禁止跨插件引用——interaction-design的命令只能引用本插件内的 Skill；
4. 3–7 步——少于 3 步只是技能调用，多于 7 步说明职责过重；
5. 产出被具体描述——写明产物的名称和章节结构，而不是「一份规格」。

动手前：两个模板与贡献流程

• 新建 Skill：复制 SKILL_TEMPLATE.md 到<plugin>/skills/<skill-name>/SKILL.md，替换所有尖括号占位符，删除全部 HTML 注释后再提 PR；
• 新建 Command：复制 COMMAND_TEMPLATE.md 到<plugin>/commands/<verb>.md。

流程上请注意：Bug 修复可直接提 PR；新 Skill 或较大改动必须先开 issue 讨论，没有对应 issue 的新技能 PR 会被直接关闭。每个 PR 聚焦一个改动（one skill per PR），并保持插件清单在同一提交中更新。

提交前自查清单 📋

1. python3 scripts/lint-frontmatter.py零报错
2. name与目录名一致，且为 kebab-case
3. description一句话讲清「覆盖什么 + 何时适用」（< 120 字符）
4. "What You Do" 指向具体产出而非话题
5. 每个 H2 小节都编码一条可迁移的判断
6. Best Practices 至少含一条反模式
7. 已先开 issue、已删除模板注释、PR 聚焦单一改动

把 lint-frontmatter 当成你的第一评审人，用 5 条质量标准打磨内容，你的贡献就能稳稳通过这道质量门禁——这正是这个技能库长期保持高可用性的原因。🚀

【免费下载链接】designer-skillsDesigner Skills Collection: agentic skills, commands, and plugins for design — from research to systems, UI, interaction, and delivery.项目地址: https://gitcode.com/gh_mirrors/de/designer-skills