Impeccable完整使用教程：从上下文建立到视觉规则验证
面向使用AI编程助手进行前端开发的用户，介绍Impeccable工具在维护产品一致性与视觉规范中的工作流。针对开发中容易忽视的设计细节与上下文缺失问题，本文详解如何通过/impeccable init建立产品上下文，利用/impeccable document记录DESIGN.md视觉规则，并通过critique和polish命令评审与优化特定页面。同时涵盖终端命令行检测npx impeccable detect的使用场景，帮助开发者在限定范围内高效完成代码修改与流程验证。
记录用户、任务和约束
安装并重新加载扩展后，首先在AI助手中运行 /impeccable init 命令。这一步的核心目的是建立产品上下文，你需要向助手说明产品的目标用户群体、核心任务是什么，以及哪些功能和事实是必须保留的底线。执行后，工具会将这些稳定的产品信息写入 PRODUCT.md 文件中。
如果项目中已经存在 PRODUCT.md 文件，只需补充缺失或已过时的事实即可。需要注意的是，init 命令不负责创建视觉规范文件 DESIGN.md，请不要将产品上下文与视觉设计规范混写在同一个文件中。
保留设计规则，选择修改目标
当项目已有可用的界面时，运行 /impeccable document 命令。该命令会检查并生成或更新 DESIGN.md 文件，确保其准确记录了当前的字体、颜色方案和组件样式。如果该文件已存在，请先确认本次更新的适用范围，避免覆盖已有的正确规范。
接下来，输入类似 “/impeccable critique 结账页” 的指令，让助手对指定页面进行评审。阅读生成的问题清单，并从中选择本轮需要解决的目标。例如，你可以决定只调整表单字段的层级关系和错误提示样式，而保留原有的支付流程逻辑与品牌整体风格不变。
完成修改并走通实际流程
确定修改目标后，输入 “/impeccable polish 结账页，只处理已确认的问题”，让助手完成最终的代码收尾工作。修改完成后，务必打开页面亲自走一遍完整流程，包括输入数据、触发报错以及提交操作。同时，检查窄屏下的显示效果、键盘操作的便捷性以及长文本的处理情况。
如果需要手动进行规则扫描，可以在终端执行以下命令：
npx impeccable detect src/
渲染检查可以扫描你实际启动的本地开发地址。如果项目中已经配置了自动钩子来负责相同的检查工作，则不必为了重复检查而多跑一遍命令。
最后，查看代码差异（Diff）和测试结果。需要注意的是，扫描没有发现主要问题并不代表业务流程必然正确。此外，如果在 Codex 环境中调用上述设计命令，请将 /impeccable 前缀改为 $impeccable。
火山引擎是字节跳动旗下企业级云与AI服务平台。聚焦大模型核心能力，依托字节自研豆包多模态大模型，凭借火山方舟一站式平台，提供模型精调、推理部署、智能应用搭建等全链路服务，结合高性能AI算力，助力各行业快速落地大模型数字化与智能化应用。
AirBuddy 3 是面向 macOS 的蓝牙外设增强工具，可集中查看 AirPods、Beats 与苹果设备电量，提供快速连接、播放控制、电量提醒、桌面小组件和多台 Mac 外设接力等功能。
AirServer macOS版可把 Mac 转换为无线投屏接收端，通过 AirPlay 或 Google Cast 接收手机、平板和电脑画面，并支持多设备同时连接、高清镜像及会话录制，适合家庭娱乐、课堂教学、会议演示和应用展示。
火山引擎是字节跳动旗下企业级云与AI服务平台。聚焦大模型核心能力，依托字节自研豆包多模态大模型，凭借火山方舟一站式平台，提供模型精调、推理部署、智能应用搭建等全链路服务，结合高性能AI算力，助力各行业快速落地大模型数字化与智能化应用。
PixTV 是一款在浏览器中使用的 AI 视觉内容创作平台，提供图片、视频、音频、文字生成、AI 分镜、局部重绘、提示词反推和无限画布等工具，适合短剧、漫剧、广告及社交媒体内容制作。
Autodesk Maya 是面向影视、电视、动画和游戏行业的专业三维制作软件，集多边形与 NURBS 建模、角色绑定、关键帧和动作捕捉动画、Bifrost 特效模拟、材质开发及 Arnold 渲染于一体，