用途
impeccable-teach-impeccable 是 impeccable.style 的 /teach-impeccable 工作流在纯技能(skills-only)环境下的等价实现。它的核心目标是一次性为当前项目收集设计上下文,并将其持久化保存,使后续所有会话都能沿用这些设计约定。
该技能以 frontend-design 原则作为基础护栏,将用户提到的命令参数视为范围提示,并在上下文缺失时主动提出澄清问题。
主要能力
- 在提问之前先探索代码库,尽可能自行发现项目信息。
- 扫描内容包括:README 与文档(项目目的、目标受众、既定目标)、package.json 与配置文件(技术栈、依赖、已有设计库)、现有组件(当前设计模式、间距、排版)、品牌资产(Logo、favicon、已定义的颜色值)、设计令牌与 CSS 变量(现有配色、字体栈、间距尺度),以及任何样式指南或品牌文档。
- 记录已了解到的信息与仍不明确的部分。
- 针对无法从代码库推断的内容,向用户提出以用户体验为中心的问题。
- 将发现与用户回答综合为 Design Context 段落,并写入项目根目录的 AGENTS.md。
使用方式
技能按以下步骤执行:
第 1 步:探索代码库
在提问之前,彻底扫描项目以发现可获取的信息,包括 README 与文档、package.json 与配置文件、现有组件、品牌资产、设计令牌与 CSS 变量,以及样式指南或品牌文档。记录已了解的内容和仍不清楚的部分。
第 2 步:提出以用户体验为中心的问题
直接向用户提问,只聚焦于无法从代码库推断的内容:
- 用户与用途:谁在使用?使用时的情境是什么?他们想完成什么任务?界面应唤起什么情绪(自信、愉悦、平静、紧迫等)?
- 品牌与个性:用 3 个词描述品牌个性?有哪些参考网站或应用体现了正确的感觉,具体体现在哪里?明确不应看起来像什么,是否有反面参考?
- 审美偏好:对视觉方向是否有强烈偏好(极简、大胆、优雅、俏皮、技术感、有机等)?浅色模式、深色模式还是两者都要?有哪些必须使用或避免的颜色?
- 无障碍与包容性:是否有特定的无障碍要求(WCAG 等级、已知用户需求)?是否需考虑减少动态效果、色盲或其他适配?
若答案已能从代码库探索中明确,则跳过相应问题。
第 3 步:编写设计上下文
将发现与用户回答综合为 ## Design Context 段落,结构如下:
## Design Context
### Users
[Who they are, their context, the job to be done]
### Brand Personality
[Voice, tone, 3-word personality, emotional goals]
### Aesthetic Direction
[Visual tone, references, anti-references, theme]
### Design Principles
[3-5 principles derived from the conversation that should guide all design decisions]
将该段落写入项目根目录的 AGENTS.md。如果文件已存在,则追加或更新 Design Context 段落。完成后确认并总结将指导后续工作的关键设计原则。
适用场景
适用于需要在项目中建立统一设计上下文、并希望该上下文在后续所有 AI 会话中持续生效的场景。尤其适合在项目初期或设计方向尚未明确时使用,通过一次性设置减少重复沟通。
限制
资料未提供关于收费、价格、平台支持范围或具体效果保证的信息。该技能依赖代码库中已有的信息以及用户的回答,若两者均缺失,则设计上下文可能不完整。