C# 静态成员与非静态成员的实现方式实用指南
2026-10-17 3467985
2026-09-30 0
工作中遇到相关需求时，roast-my-design-system值得先读说明，因为它主要用于AI设计系统扫描器+mcp服务器，对存储库评分 0-100，编写修复提示， 20K+ npm 下载。对部署与运行环境任务来说，权限、依赖和环境差异会放大维护成本往往决定它能否落地，不能只用安装成功来判断。我的评估方法是在非生产环境复现一次安装与运行，然后检查依赖锁定、权限边界、日志、回滚和资源消耗是否与文档一致。我的判断是，它更适合愿意维护环境并重视故障恢复的工程团队；若眼下没有这类需求，先保留观察即可。
烘焙我的设计系统
查找您的 AI 代理将在哪里发明 UI。
您的AI可以写入UI。这可确保它写入您的UI。
npx roast-my-design-system@latest
在 UI 存储库的根目录下运行它。一秒钟后，将打开一份报告。 没有帐户。没有网络。没有遥测。您的存储库中没有任何变化。
当前版本：9.1。 CHANGELOG.md 中的版本历史记录。
这个想法
特工复制其发现的内容。
它发明了仓库没有答案的地方。
我们在 10 个真实的开源产品、259 个代理会话（使用或不使用此工具）上进行了测试。
添加的每个会话的结果，按此工具自己的规则进行计数：
| 任务 | 型号 | 不带烤 | 烘焙 MCP 并安装规则 | 烘焙编辑挂钩 |
|---|---|---|---|---|
| 添加面板、构建仪表板、收紧列表（80 个会话） | 十四行诗 5 | 7 | 9 | 不运行 |
| 圣诞主题，10 种产品 | 十四行诗 5 | 28 | 2 | 不运行 |
| 一个新图表，4 个产品，每个产品运行 5 次 | 十四行诗 5 | 20 次运行中 10 次 | 20 次运行 0 次，钩子也安装了，但它从来不需要说话 | |
| 一张新图表，4 种产品 | 俳句 4.5 | 25 | 39 | 15 次运行中有 14 次为 0 |
| 图表、状态颜色、空状态、新组件 | 俳句 4.5 | 16 场比赛中 42 次 | 16 场比赛中 49 次 | 51 次中的 3 次 |
无论哪种方式，日常工作都会保留在系统上。发明发生了漂移。
Sonnet 在大约三分之一的会话中调用了 MCP 工具。 Haiku 从未这样做过，因此对于 Haiku 而言，MCP 本身没有任何改变。编辑挂钩在没有询问的情况下运行，并且该列变为零。
代理是哪里发明的？回购协议没有什么可复制的。 Dub 没有图表调色板。它自己的图表硬编码了 17 种颜色。当要求提供图表时，俳句又硬编码了 9 个。
因此，代理添加的混乱是系统中漏洞的地图。
该工具绘制地图。
烤。教。警卫。
烘烤仓库以找到其真正的设计系统、其中的混乱和差距。
通过生成的规则和本地 MCP 服务器来训练代理。
守护每次编辑，因此代理不必记得询问。
ROAST what is in the repo, and what is missing
↓
TEACH rules in the agent files, answers over MCP
↓
GUARD every edit checked, the PR gated
你得到什么
你的代理人必须猜测哪里？
报告的可以先：回购协议尚未给出答案或“未发现差距”的地方。
今天，有一个漏洞是众所周知的，因为运行发现了它：在没有图表调色板的存储库中对颜色进行图表硬编码。 126 个公共存储库中有 43 个看起来像这样。测量完成后，间隙就会加入列表。
修复代理猜测的问题
代理将复制的混乱情况，按照修复的价值进行排名。
修复，重新扫描，按下一步按钮。
您可以在会议中捍卫的分数
0 到 100。每次运行相同的数字。
根据三个标准进行衡量：设计系统的理想规范、以 112 个存储库基准为核心的 34 个产品存储库的中位数，以及 10 个信誉良好的系统（Primer、Polaris、Carbon、shadcn/ui 等）。
Monorepos 对每个包进行评分。 packages/ui 在 80 处停止隐藏 apps/web 在 40 处。
每个发现及其文件路径
还有8种，都在测量的是什么。一个 HTML 文件。打开它，放松它，通过电子邮件发送它。
您的代理人的规则
从您的存储库生成到 design-system-rules.md：
canonical components
the token file
known duplicates to avoid
spacing steps
typefaces
the kit's own vocabulary
--apply 将它们写入您拥有的每个代理文件中：Claude、Cursor、GitHub Copilot、Windsurf。每次扫描还会检查您已有的规则是否存在过时的引用。
脚本进行计数
每个数字都来自对文件的确定性读取。克劳德写下了解释，标记为 AI 所写，并与数字分开。
跑步是如何完成的
Claude Code，无头，关于 10 个公共产品，每个产品固定一个提交：cal.com、Dub、Metabase、Plausible、SigNoz、trigger.dev 以及另外四个。 259 个会话，Sonnet 5 和 Haiku 4.5，2026 年 9 月。每个更改的文件都会在会话结束时和固定提交时根据此工具的规则进行判断；仅当会话添加了结果时，该结果才算数。
什么都没有渲染。零发现意味着按照这些规则进行系统：地板，而不是设计审查。方法、表格和限制在研究文章中，将单独发布。
实例
十一份报告，完全按照工具编写的方式托管。每个数字都是确定的，每条路径都是真实的。
vercel/ai-chatbot 的完整报告。判决回答了智能体将在这里学到的内容，间隙部分首先出现，然后是“回购协议教智能体什么”，克劳德读到的扫描：
轻型模式下的相同报告（一个文件，内置切换）：
为什么这些数字成立
tools/benchmark/。scoreHarvest(harvest) 以纯数据形式返回分数和指标。该报告和 CI 检查得到相同的数字。长版本包含扫描范围以及插件在您的计算机上运行的内容，位于 docs/reference.md 中。
与
框架
反应，Next.js，混音，Vite 模板、照明、自定义元素
套件和造型
Tailwind、shadcn/ui、MUI、Mantine、查克拉 UI、蚂蚁设计 CSS 模块、Sass、Less、情感、样式组件、香草提取物、CVA、缝合
四种存储库：产品、库、shadcn 安装、注册表。每个都与以相同方式构建的存储库进行比较。
已识别，尚未测量
Vue、Angular、Svelte：在标题中命名，计算颜色和间距，未测量组件。报告是这么说的。 HeroUI、NextUI、Radix Themes、Fluent UI、React Bootstrap、Grommet：在标头中命名，无套件规则。
每个命令
一次扫描即可为所有功能提供动力；标志决定磁盘上的内容。自由组合。
自己运行一下
| 命令 | 你得到什么 |
|---|---|
npx 烘焙我的设计系统@latest |
扫描并design-system-roast.html，在浏览器中打开 |
... <路径> |
扫描与当前目录不同的存储库 |
... --apply |
生成的代理规则注入到您拥有的每个代理文件中：CLAUDE.md、AGENTS.md、.cursorrules、.cursor/rules/、.windsurfrules 和 .github/copilot-instructions.md，位于标记块内。重新运行仅替换该块，而不替换您自己的文本。 |
... --rules |
相同的规则写入 design-system-rules.md，用于手动粘贴 |
... --card |
roast-card.svg：一张可共享的 1200x630 卡，其中包含分数和最差结果。纯SVG，嵌入README |
... --sarif |
design-system-roast.sarif 用于 GitHub 代码扫描：将其上传到 CI 中，结果显示在“安全”选项卡中，并在文件上进行注释 |
... --check |
在终端中根据设计系统检查工作树的更改文件。发现结果后退出 1，因此它会插入脚本中 |
/roast-my-design-system:review（克劳德代码） |
在聊天中进行相同的检查，来自插件的第二项技能：每个更改文件的结果都带有命名的修复程序，然后应用修复程序并重新运行检查 |
... --排除 lab/ |
将文件夹排除在扫描之外（重复标记或逗号分隔）。或者列出存储库根目录下的 .roastignore 文件中的文件夹。不管怎样，报告的标题中都是这样说的 |
... --json |
标准输出上的扫描摘要为 JSON，适用于脚本和管道。包括 schemaVersion、使用的基准以及每个指标的数字，因此可以比较两次扫描 |
...--“Dwayne Hicks” |
在报告标题中添加一个名称，供您为其他人运行时使用 |
... - 主题 light / --out <文件> / --no-open / --open |
轻报表，自定义报表路径，永不打开浏览器，始终打开 |
为您的代理人
| 命令 | 你得到什么 |
|---|---|
... --注释 |
代理阅读此扫描，嵌入报告中作为“存储库教代理的内容”：哪些发现很重要，哪些好的数字是意外的，首先要修复什么。标记为AI，并与测量数字分开存放。克劳德代码技能自动编写并传递；旗帜就在这里，任何特工都可以 |
... --部分“标题” |
在注释之后再由代理编写一章，相同的样式，相同的标签，允许使用小标题。可重复 |
... --hook |
对于手动安装的设置，每次编辑后都会运行克劳德代码插件的检查：读取标准输入上的挂钩事件，检查更改的文件，仅打印编辑添加为 JSON 的结果。总是退出0 |
... --mcp |
作为本地 MCP 服务器进行扫描：代理在写入 UI 时调用的 5 个工具，以及从全新扫描中提供最佳修复的 roast-fix 提示。查看 通过 MCP 的实时答案 |
/roast-my-design-system（克劳德代码） |
完整的体验：聊天中的讨论和嵌入报告中，作为“存储库教代理的内容”，规则提供，以及与克劳德在您自己的数字上的修复循环 |
“为什么这很重要”是通用的，随该工具一起提供，并且在每个报告中都具有相同的内容。 “回购协议教给代理的内容”是您的代理对您的回购协议的读取，并且仅在代理通过它时才会出现。
通过 MCP 进行实时解答
报告和规则文件描述了扫描时的存储库。当您的代理工作时，--mcp 保持相同的引擎运行，因此问题可以从现在的代码中得到回答，并且错误可以在错误发生之前被捕获。
| 工具 | 它回答的问题 |
|---|---|
roast_get_context |
在接触 UI 之前我应该了解什么？按正在编辑的文件夹路由 |
roast_find_component |
是否已经有一个组件可以实现这一点，哪个组件是规范的？通过一个真实的使用示例。当两名候选人打平时，它会这样说并列出两人的名字 |
roast_find_token |
我手上有#111111 / 13px。我应该用什么？ |
roast_validate |
我正要保存这个。它会破坏系统吗？ |
roast_review |
查看我更改的文件。读取 git diff 本身，因此不会粘贴回任何代码 |
循环：构建前的上下文、构建时查找、保存前验证、完成前检查。
一场真实的交易所，针对 在 60/100 释放，一种 MUI 产品。代理手里有灰色，心里有填充：
roast_find_token #6b7280
→ Nearest token: #607d8b, 11 channel steps from #6b7280. Unless the difference is a deliberate decision, use the token.
roast_validate (first draft)
→ ✕ L5 Colour #6b7280 written onto an MUI component, and the theme has no such colour.
Fix: Add it to the theme once (frontend/src/themes/dark-theme.ts), then read it there: color: 'text.secondary' in sx.
✕ L5 Pixel size p: 12px on an MUI component.
Fix: 12px is between steps 1 (8px) and 2 (16px). Keep it with a comment, or use the nearest step in sx.
roast_validate (second draft: color: 'text.secondary', p: 1.5)
→ No measured violations found. Checked: hardcoded colours vs the token set, near-identical colour twins, off-scale spacing …
四次调用，低于 800 个标记，新组件读取主题而不是添加颜色编号 44。
图表有自己的规则，因为图表需要几种彼此不同的颜色，而大多数设计系统从不命名它们。在存储库保留图表调色板的情况下，在图表文件中手写的颜色是命名调色板的发现。如果存储库有图表但没有调色板，则手动绘制的新图表会收到一个警告，指出现有图表执行相同操作并要求调色板一次。该警告就是实时差距报告。
服务器按照报告的方式读取存储库。在基于 MUI、Mantine、Chakra UI 或 Ant Design 构建的产品上，上下文命名主题文件和套件自己的读取方式，roast_find_token 以间距步骤进行回答，检查标记写入套件组件（其中主题具有值）的颜色或像素大小。在 Tailwind 主题或 shadcn 存储库上，它们标记了一个调色板类，例如 text-gray-500，其中主题命名了此类颜色。粘贴到组件中的令牌的原始值用令牌的名称进行标记，并且从头开始构建的按钮（其中存储库已经有一个常用的按钮）会收到一条警告，指定要使用的导入行。
roast-fix 提示提供从新扫描开始的顶部移动，与报告的复制按钮字节相同。在Claude Code中输入/mcp__roast__roast-fix，添加一个号码来插队。修复它，再次询问，下一步已经上升到顶部：扫描是进度条。
安装了Claude Code插件吗？ 服务器已经有了。否则：
claude mcp add roast -- npx roast-my-design-system@latest --mcp
在 Claude Code、Cursor 和 Windsurf（现在的 Devin Desktop）中进行了验证。 每个都经过端到端测试：服务器连接、列出所有 5 个工具、编辑者自己的聊天中的真实答案。本地、只读、启动时一次扫描、无端口、无帐户。
光标：将其放在项目内的 .cursor/mcp.json 中（项目，因此扫描会看到一个存储库，而不是整个磁盘），然后第一次在“设置”→“工具”和“MCP”下启用 roast：
{ "mcpServers": { "roast": { "command": "npx", "args": ["roast-my-design-system", "--mcp"] } } }
Windsurf (Devin Desktop)：其 MCP 配置是全局的 (~/.codeium/windsurf/mcp_config.json)，因此命名项目文件夹以将扫描范围限制在一个存储库：
{ "mcpServers": { "roast": { "command": "npx", "args": ["roast-my-design-system", "--mcp", "/path/to/your/repo"] } } }
任何其他 MCP 客户端都可以注册相同的 stdio 命令。
在CI
扫描仪使用 SARIF，因此将其连接到 GitHub 代码扫描需要 6 行。结果显示在“安全”选项卡中，并在文件本身上进行了注释：
- uses: actions/checkout@v5
- run: npx roast-my-design-system@latest . --sarif --no-open
- uses: github/codeql-action/upload-sarif@v3
with:
sarif_file: design-system-roast.sarif
要仅在新的混乱情况下使拉取请求失败，请使用 Guard-my-design-system。
安装
无需安装，无需克劳德：
npx roast-my-design-system@latest
克劳德代码（推荐）：
/plugin marketplace add gregkozakiewicz/roast-my-design-system
/plugin install roast-my-design-system@roast-my-design-system
它安装的内容：两项技能，一项本地 MCP 服务器和一项编辑挂钩，仅此而已。 烤（/roast-my-design-system，或“烤我的设计系统”）扫描整个存储库，用克劳德读取的其中数字编写报告，然后与您一起进行修复。 审查（/roast-my-design-system:review，或“审查我的 UI 更改”）仅检查更改的内容，大约一秒钟。该钩子在代理编辑每个文件后运行，并返回编辑添加的结果；没有任何新内容的文件不会收到任何消息。
如果这些命令出错，则说明您的克劳德代码早于插件市场。更新它，或使用手动路线：
git clone https://github.com/gregkozakiewicz/roast-my-design-system.git
cp -r roast-my-design-system/skills/roast-my-design-system roast-my-design-system/skills/review ~/.claude/skills/
（在存储库中使用 .claude/skills/ 与您的团队共享。review 技能旁边需要 roast-my-design-system 文件夹。）
OpenAI Codex CLI（相同的 SKILL.md，相同的文件夹）：
git clone https://github.com/gregkozakiewicz/roast-my-design-system.git
cp -r roast-my-design-system/skills/roast-my-design-system ~/.codex/skills/
使用 $roast-my-design-system 调用。在存储库中使用 .codex/skills/ 与您的团队共享。
npx skills： npx skills add gregkozakiewicz/roast-my-design-system 适用于读取 ~/.agents/skills/ 的代理。克劳德代码读取 ~/.claude/skills/，因此更喜欢上述路线之一。
需要节点 18+。
使用
在您想要烘焙的存储库中打开 Claude Code 并输入：
/roast-my-design-system
一旦您拥有值得保护的设计系统，第二项技能将仅检查您更改的内容：
/roast-my-design-system:review
它对 git diff 中的文件运行与 --check 相同的检查，并在 MUI、Mantine、Chakra、Ant Design 或 Tailwind 主题存储库上的套件自己的词汇表中列出每个发现及其修复。没有分数，没有报告：周二下午的小额支票。克劳德还从简单的词语中提取出它，例如“检查我的 UI 更改”或“我是否破坏了设计系统”。
您可以在聊天室中获得信息，并在您的存储库根目录中获得 design-system-roast.html，这是一个独立的页面，其中包含：
design-system-rules.md 包裹在报告内作为礼物。解开包装，然后复制或下载扫描生成的代理规则烘焙后，该技能会将 design-system-rules.md 写入磁盘并将其合并到 CLAUDE.md、.cursor/rules 或 AGENTS.md 中。
四种尝试提示
Roast my design system.
How bad is my CSS? Scan this repo and show me the receipts.
连接 MCP 服务器后：
Is there already a Button component in this repo, and which one should I use?
日常的，在你改变了一些 UI 之后：
Review my UI changes against the design system.
故障排除
.roastignore 或 --exclude 进行扫描。design-system-roast.html。在任何浏览器中打开它；它不需要服务器，也不发出请求。claude mcp list显示是否已连接。它需要 Node 18 或更高版本。支持
错误和问题请转至 GitHub 问题。其他所有内容均通过 gregkozakiewicz.com 到达 Greg。安全问题：参见SECURITY.md。
隐私
该工具读取您指向的存储库，并将其输出写入它旁边。它不发出网络请求，不收集数据，也不进行遥测。 MCP 服务器通过同一本地扫描进行应答。您的代码、提示或对话的任何内容都不会发送给任何人，包括作者。
它衡量什么
| 公制 | 理想的设计系统 | 34 个存储库核心机群的中位数 | 10 个信誉良好的系统的中位数 |
|---|---|---|---|
| 不同的颜色 | ~24 | 118 | 14 |
| 灰色阴影 | 最多 13 个 | 21 | 2 |
| 超出比例的间距值 | ~12 | 23 | 5 |
| 字体 | 2 至 3 | 3 | 1 |
| 超比例边界半径 | 最多 10 个 | 14 | 0 |
| 重复的组件 | 0 | 21 | 9 |
| 内联样式块 | 0 | 51 | 12 |
| 任意顺风值 | ~20 | 77 | 0 |
| 几乎相同的颜色对 | 0 | 8 | 1 |
| !重要声明 | 0 | 5 | 3 |
| 从未进口过的组件 | 0 | 0 | 0 |
是的，回购中位数已经一团糟了。这就是重点。到达其中的特工将忠实地复制混乱，并在混乱耗尽的地方添加一些自己的。
您的AI可以写入UI。这确保它写入您的UI。