构建或维护 UI 组件时，用 imprint…

构建任何 UI 组件后或审计现有 UI 一致性时，运行 /imprint 记录关键视觉模式，让后续组件匹配已有模式。

适用场景

解决思路

1. 构建任意 UI 组件后，运行 `/imprint`，读取刚构建的内容，提取对一致性重要的视觉模式，并保存到 `ui-registry.md`。
2. 要针对特定文件时，运行 `/imprint [filepath]`，直接读取该文件。
3. 要审计现有代码库的不一致时，运行 `/imprint audit`。
4. 未提供 filepath 时，自动识别本会话中最近创建或修改的组件文件；在 components 目录及其他 UI 文件常见位置查找并读取这些文件。
5. 如果无法判断应从哪些文件捕获，询问开发者：`Which component should I capture patterns from?`
6. 在项目 UI 已存在且一致性不确定时，运行 `/imprint audit`。
7. 在多个 session 未运行 `/imprint` 时，运行 `/imprint audit`。
8. 在视觉看起来不对但难定位原因时，运行 `/imprint audit`。
9. 在现有项目首次建立 `ui-registry.md` 之前，运行 `/imprint audit`，再运行 `/imprint`。
10. 读取组件代码，只提取影响界面视觉一致性的 classes 和值，不提取全部内容。
11. 提取 Background：容器、卡片、面板使用的 `bg-` class。
12. 提取 Border：边框颜色、宽度、样式。
13. 提取 Border radius：该组件类型使用的 `rounded-` class。
14. 提取 Text colors：主文本、次要文本、弱化文本 classes。
15. 提取 Text sizes and weights：标题、正文、标签、说明文字的尺寸和字重。
16. 提取 Spacing：组件内 padding、元素间 gap。
17. 提取 Interactive states：hover、focus、active classes。
18. 提取 Shadow：若使用。
19. 提取任何 accent 或品牌色用法。
20. 不提取 Width and height：太依赖上下文，不能作为一致性规则。
21. 不提取 Flex and grid layout：属于结构，不是视觉。
22. 不提取 Positioning：absolute、relative、z-index，依赖上下文。
23. 不提取 Animation and transition timing：除非它是值得强制执行的模式。
24. 不提取 Responsive breakpoint variants：只捕获基础模式。
25. 打开 `ui-registry.md`；如果不存在则创建。
26. 为刚捕获的组件新增条目；不要覆盖已有条目，而是追加到 registry。
27. 如果该组件类型已有条目，更新它，而不是重复添加。
28. 按指定格式写条目：`### [Component Name]`、`File: [filepath]`、`Last updated: [date]`，并创建表格列 Property/Class，包括 Background、Border、Border radius、Text — primary、Text — secondary、Spacing、Hover state、Shadow、Accent usage。
29. 在条目中写 `**Pattern notes:**`，记录重要模式决策，例如为什么选择某个特定 class、该组件应始终匹配什么、允许哪些变化。
30. 写入 `ui-registry.md` 后，向开发者确认：`Imprinted [Component Name] → ui-registry.md`，并列出 Captured 的 Background、Border、Radius、Text、Spacing、Hover 等 classes。
31. 确认时说明：任何未来该类型组件都应匹配这些模式。
32. 如果提取过程中发现任何不一致或意外情况，用 `Note: [Something that looked inconsistent or worth the developer knowing about]` 标记出来。
33. 在任何涉及 UI 工作的 session 开始时，在编写任何组件之前读取 `ui-registry.md`。
34. 构建新卡片时，检查已有卡片如何构建；构建新按钮时，检查已有按钮模式；构建新状态徽章时，匹配已使用的确切 classes。
35. 遵守规则：构建组件，运行 `/imprint`，继续。每次，无例外。
36. 记住：拥有 10 条条目的 registry 有用，30 条强大，有时更新的 registry 不可靠；一致性是习惯，不是功能。
37. Audit 模式 Step 1：查找项目中的每个组件文件，读取每个文件，构建当前整个界面视觉模式使用情况的完整画面。
38. Audit 模式 Step 2：对 Border radius，列出每个 `rounded-` variant 及使用它的组件；给出标准化建议及原因。
39. Audit 模式 Step 2：对 Background colors，列出每个 `bg-` class，标记硬编码 hex 值；建议应替换为哪些 token classes。
40. Audit 模式 Step 2：对 Text colors，列出每个 `text-` 颜色 class，标记绕过设计系统的；建议应替换为哪些 token classes。
41. Audit 模式 Step 2：对 Spacing，列出 padding 和 gap 变体；建议标准化哪些值。
42. Audit 模式 Step 2：对 Border colors，列出每个 border 颜色 class；建议标准化哪个 token class。
43. Audit 模式 Step 2：对 Interactive states，列出 hover、focus、active 变体；建议标准化哪个模式。
44. Audit 模式 Step 2：对 Hardcoded values found，列出每个硬编码 hex 值、raw color class 或 non-token 值，附文件和行号；这些必须替换为设计系统 tokens。
45. Audit 模式 Step 2：给出 Recommended baseline：基于多数已正确使用和设计系统定义，给出每个属性的正确模式。
46. Audit 模式 Step 3：展示审计报告；不要修复任何内容；不要更新 `ui-registry.md`。
47. Audit 模式 Step 3：询问开发者确认：`Audit complete. [X] conflicts found across [Y] properties. Before I establish the baseline in ui-registry.md: 1. Do the recommendations above look correct? 2. Are there any conflicts you want to resolve differently? 3. Should I flag the hardcoded values as issues to fix? Confirm the baseline and I will write it to ui-registry.md.`
48. Audit 模式 Step 4：开发者确认后，将达成一致的基线写入 `ui-registry.md` 作为基础。
49. Audit 模式 Step 4：基线清楚标注 `## Baseline — Established [date]`，并注明它通过 `/imprint audit` 建立。
50. Audit 模式 Step 4：基线表格包含 Property/Correct class，包括 Card background、Card border、Card radius、Button primary、Button secondary、Text primary、Text secondary、Text muted、Input background、Input border。
51. Audit 模式 Step 5：写入基线后，生成修复列表，列出每个偏离基线的组件。
52. Audit 模式 Step 5：修复列表格式为 `## Components to fix` 和 `- [Component file] — [what is wrong] → [what it should be]`。
53. Audit 模式 Step 5：让开发者可系统修复这些偏差，或在遇到每个组件时修复；基线建立后，之后使用 `/imprint` 保持新组件一致。

适用边界 · 注意事项

• 不要用 `/imprint` 捕获 width/height、flex/grid、positioning、animation/transition timing、responsive breakpoint variants 作为视觉一致性规则；动画/过渡仅当它是值得强制执行的模式时才例外。
• 在 UI 尚未构建任何组件、没有可捕获或审计目标时，不运行 `/imprint`。
• 在 `/imprint audit` 中，开发者确认基线前不要修复代码或更新 `ui-registry.md` 基线。