teach-impeccable

teach-impeccable 技能概览

teach-impeccable 是做什么的

teach-impeccable 是一个用于 AI 辅助 UI 设计的一次性初始化流程。它会帮助代理先检查你的代码库，识别现有的设计信号，只补问代码里无法回答的 UX 问题，然后把最终整理出的设计指导写入你的 AI 配置，供后续会话复用。实际使用中，teach-impeccable 的重点不是立刻生成几个界面，而是先建立一套可持续复用的设计上下文，让模型以后做 UI 时更稳定。

谁适合使用 teach-impeccable

这个技能最适合已经有产品、原型或现有代码库的团队和独立开发者，他们希望从 AI 工具中获得更一致的 UI 设计协助。尤其当你希望 teach-impeccable for UI Design 能真实反映你的品牌、目标用户和当前组件模式，而不是默认套用泛化的“modern SaaS”风格时，它会更有价值。

它真正解决的问题是什么

大多数用户真正缺的，不是另一个“把它做得更好看”的提示词，而是让 AI 学会：

• 产品到底是什么
• 面向的是谁
• 现有界面里已经有哪些视觉线索
• 哪些设计方向应该避开
• 后续任务里如何保持一致

teach-impeccable 解决的正是这个初始化问题。它把探索和梳理前置，这样后续的 UI 请求就不必反复重讲背景，也更不容易风格跑偏。

这个技能的差异点在哪里

它最核心的区别在于流程顺序：

1. 先检查仓库
2. 只在代码库信息不明确的地方补问有针对性的 UX 问题
3. 把整理出的设计指导保存下来，供后续会话使用

当你的产品已经在代码、文档、tokens 或素材里藏着一部分设计意图时，teach-impeccable skill 会比泛泛的设计提示词更实用。

什么情况下它很适合

如果你符合以下任一情况，可以考虑使用 teach-impeccable：

• 已有应用，且包含组件、CSS variables 或 design tokens
• 仓库里已经有品牌线索，但还没有正式设计系统
• 经常被 AI 每次输出风格都不一样的问题困扰
• 需要让 AI 生成的 UI 与产品定位和目标用户保持一致

什么情况下它不是合适的工具

如果你想从零开始，一步就拿到完整 UI 概念稿，那就不适合用这个技能。它不能替代按页面逐项给出的详细设计说明。如果你的项目目前还没有足够有意义的仓库上下文，它的价值也会下降，因为整个流程前半段高度依赖代码库中的真实证据。

如何使用 teach-impeccable 技能

teach-impeccable 的安装上下文

该仓库没有在 SKILL.md 中提供单独的安装器，因此实际可行的 teach-impeccable install 方式，是在支持 skills 的环境里直接从 GitHub 源添加，例如：

npx skills add https://github.com/pbakaus/impeccable --skill teach-impeccable

最好在一个 AI 代理能够读取你项目文件的工作区中使用它。这个技能被明确标记为可由用户直接调用，因此在兼容环境中，你应当可以直接按名称调用它。

运行前 teach-impeccable 需要什么

当仓库里已经包含一定设计证据时，teach-impeccable usage 的效果最好。比较有帮助的输入包括：

• README.md 或产品文档
• package.json 和框架配置
• 组件目录
• 全局样式
• CSS variables 或 token 文件
• logo、icon、favicon 或其他品牌素材
• 任何已有的设计参考

如果这些内容都不存在，代理能推断的信息就会少很多，最终会更依赖你的人工回答。

teach-impeccable 内部的实际工作流

这个技能遵循一套简单但很关键的顺序：

1. 扫描代码库，提取产品和设计上下文
2. 标记哪些信息已明确，哪些仍缺失
3. 暂停并提出以 UX 为核心的问题
4. 收集你对用户、品牌个性、参考对象和审美偏好的回答
5. 将这些设计上下文持久化，供后续会话使用

这里的“停下来提问”非常关键。一个好的代理不应该在扫完仓库后，未经澄清就直接跳去产出设计。

调用时该怎么对代理说

一个较弱的调用方式是：

• “Use teach-impeccable.”

更好的调用方式是：

• “Use teach-impeccable on this app. Inspect the repo for existing UI patterns, brand signals, and tokens first. Then ask me only the design questions the code cannot answer, and save the resulting design guidance for future sessions.”

这样的提示会强化正确的执行顺序，也能降低代理跳过探索阶段的概率。

怎样准备更好的回答

这个技能提出的问题，通常围绕以下主题：

• 用户是谁、会在什么场景下使用
• 产品的核心用途
• 希望传达的情绪基调
• 品牌个性
• 参考产品
• 反向参考（不希望接近的对象）
• 整体审美方向

高质量回答通常要具体，而且最好带比较对象。比如：

不要只说：

• “Clean and modern.”

可以改成：

• “Primary users are small business owners checking cash flow on mobile between meetings. The UI should feel calm, trustworthy, and efficient. We like Linear’s restraint and Stripe’s clarity, but do not want a glossy crypto-dashboard look.”

这样的信息给模型的是可执行的约束，而不是容易被过度发挥的抽象形容词。

如何把一个模糊目标补全成完整的 teach-impeccable 提示

如果你真正的目标是“帮我重做 dashboard”，那更好的做法是先运行 teach-impeccable，并提供如下背景：

• dashboard 是做什么的
• 谁最常使用它
• 用户需要快速做出哪些判断
• 什么样的视觉特征更能建立信任
• 现有 UI 中哪些部分应该保留辨识度

等这个技能先把持久化指导保存好之后，再去请求重设计。相比一上来就让 AI 直接改版，这种两步法通常效果更好。

优先检查哪些仓库文件

针对这个仓库，建议先看：

• SKILL.md

针对你自己的项目，代理应该优先检查：

• README.md
• package.json
• app shell 和 layout 相关文件
• design system 或组件目录
• theme 文件
• CSS variable 定义
• 素材资源目录

teach-impeccable guide 故意没有附带很多支持性文件，因此它的实际价值，很大程度上取决于代理在提问前能否认真读懂你的仓库。

持久化在实际中意味着什么

技能描述说明，它会把设计上下文保存到你的 AI config file 中，供后续会话使用。这正是采用它的核心收益：设计 briefing 做一次，后面的任务就能继承这些指导。如果你的工具链实际上并不会真正持久化这类会话指导，那么 teach-impeccable skill 的价值就会明显下降，因为你仍然需要手动重复这些前置设置。

一个常见且有效的使用方式

一个实用的工作流通常是：

1. 每个项目或每次重大改版时运行一次 teach-impeccable
2. 认真回答澄清问题
3. 确认保存下来的指导准确反映你的产品
4. 在后续任务中复用这些上下文，比如组件设计、视觉整理或 UX 优化
5. 当品牌、受众或设计方向发生明显变化时，重新运行这个技能

采用前需要知道的取舍

这个技能的定位非常聚焦。它没有附带脚本、规则、参考包或示例文件。好处是容易理解、上手负担低；代价是输出质量会高度依赖以下几点：

• 仓库里到底有多少可供识别的设计信号
• 代理是否真的遵守“先停下来提问”这一步
• 你的回答是否足够具体
• 你的环境是否真的会保存这些捕获到的指导信息

teach-impeccable 技能 FAQ

teach-impeccable 比普通设计提示词更好吗

通常是的，前提是你已经有现成产品。普通提示词往往会忽略代码库里的线索，最后产出泛化风格。若你希望设计工作建立在当前组件、tokens 和品牌意图之上，teach-impeccable 会更合适。

teach-impeccable 适合新手吗

适合，但有一个前提：即便是新手，也仍然需要把产品和品牌相关问题回答清楚。这个技能能减少你在写提示词时的试错，但如果你自己都还不清楚用户是谁、语气基调是什么、审美边界在哪里，它也无法替你凭空编出一套一致的设计方向。

teach-impeccable 会自己直接生成最终 UI 设计吗

不完全会。teach-impeccable skill 本质上更像一个前置配置层。它的职责是收集并保存设计上下文，让后续 UI 设计请求更一致、也不那么模板化。

什么情况下不该用 teach-impeccable

如果项目还没有仓库、没有明确受众、产品定位也不清晰，就不要把它当成第一步。在这种情况下，你更需要先做产品探索，或者先用更直接的概念型 prompting。对于一次性的视觉小修小补、且后续不打算继续延展的任务，它也有点杀鸡用牛刀。

哪类项目最适合 teach-impeccable for UI Design

它最适合应用、dashboard、网站和各类产品界面，尤其是在品牌一致性需要长期维持的场景下。如果仓库里已经隐含了部分 UI 决策，只是一直没人把它们明确整理成文档，这个技能会特别有用。

仓库里是否包含额外自动化或参考素材

没有看到明显的支持目录。当前技能路径预览中没有可见的 rules/、resources/ 或辅助脚本。这意味着接入过程相对简单，但也代表这个技能更依赖代理本身的行为，以及你项目里的真实上下文，而不是依赖仓库附带的现成素材。

如何改进 teach-impeccable 技能的效果

给 teach-impeccable 提供更好的证据

想提升 teach-impeccable usage，最快的方法就是让你的仓库能暴露出真实的设计信号：

• 让 token 命名有语义
• 把颜色和字体集中管理
• 在 README.md 中写清产品用途
• 把 logo 和品牌素材放在清晰、稳定的位置
• 不要把关键视觉决策零散分布在大量文件中

代码库越容易读懂，这个技能就越能准确推断出你的设计基线。

回答要给约束，不要只给审美词

一个常见失败模式是：用户只给出像 “premium”“simple” 或 “modern” 这样的模糊词。这些词的解释空间太大。要提高结果质量，最好给每个审美词补上上下文：

• 用户是谁
• 他们想完成什么
• 哪种情绪最重要
• 哪些参考对象最能代表方向
• 哪些东西必须避开

这样 teach-impeccable 产出的指导，后续才真的具备复用价值。

明确说出反模式和禁区

提升效果最明显的方法之一，就是明确说明界面“不应该像什么”。高质量的反向参考能有效防止模型跑偏。例如：

• “Avoid neon gradients and crowded analytics-dashboard aesthetics.”
• “Do not make this feel playful or consumer-social.”
• “Avoid oversized marketing-site hero patterns inside the product UI.”

第一次运行后检查保存下来的指导

不要默认持久化后的上下文一定正确。运行完 teach-impeccable 后，应该检查保存的设计指导是否准确覆盖了：

• 核心受众
• 品牌个性
• 参考线索
• 反向参考
• 视觉语气
• 是否与当前产品现实情况一致

如果这些基础信息错了，后面所有 UI 任务都会继承这个错误。

产品变化后要重新运行技能

最适合刷新 teach-impeccable skill 的时机包括：

• 品牌重塑之后
• 目标用户变化之后
• 产品方向发生重大转向之后
• 设计系统大改之后
• 从原型阶段转向正式打磨阶段时

持久化上下文很强大，但过时的上下文同样很危险。

用“两阶段流程”提升后续产出质量

如果你想让后续结果更稳，最好把初始化和设计执行拆开：

1. 先运行 teach-impeccable
2. 确认保存的指导内容
3. 再请求一个具体产物，比如 settings page 改版或组件清理
4. 结合截图、代码或用户反馈继续迭代

这样可以避免把探索和执行混在一次嘈杂的请求里。

尽早识别并修正常见失败模式

如果出现以下迹象，说明这次技能运行可能过弱：

• 代理问了很多本可以从仓库中直接得出的宽泛问题
• 它完全跳过了提问环节
• 保存下来的指导听起来很泛
• 后续 UI 输出无视你已有的模式
• 设计建议更像追逐流行趋势，而不是贴合产品本身

如果你看到了这些问题，就应该用更强的调用方式和更具体的回答重新运行。

把这个技能和明确的后续任务配合使用

完成初始化之后，最好继续发起边界清晰的任务，例如：

• 优化 dashboard 的间距和字体层级
• 让某个表单流程更贴合已保存的品牌语气
• 更新 component library，使其符合已保存的设计原则
• 按持久化指导检查 UI 一致性

这正是 teach-impeccable guide 的价值真正体现出来的地方：不只是在最初那轮提问里，而是在后续整个工作流的一致性提升上。