Impeccable 是什么：把设计指导放进 AI 编程流程
Impeccable 架构：产品背景、命令与检测器
沿着一次设计请求梳理技能、运行时与复核之间的关系。
Impeccable 架构：产品背景、命令与检测器知识学习CN编辑简报更新 2026-09-29
你将学会
- 持久产品事实是输入
- 命令是工作入口
- 钩子改变反馈时机
开始前需要
- 一个页面及其用户任务
- 检查 Agent 技能与项目钩子的权限
产出有依据的设计修改，让另一位审阅者可以接受或拒绝。
先看结论
- 产品背景和视觉方向有不同寿命。
- 规则检测与 Agent 评论提供不同证据。
- 钩子并不拥有设计决策权。
持久产品事实是输入
README 说明 `init` 会将受众、约束和证据写入 PRODUCT.md。某个页面的视觉方向可以另存 DESIGN.md。命令会使用两者，但新的版式不应改写产品事实。
同一产品可能同时有营销页和高密度工作台。两者布局可以不同，却仍服务同一类用户并遵守相同的运行约束。
命令是工作入口
技能提供 `audit`、`critique`、`polish`、`distill` 等命令。有些要求 Agent 判断和编辑，检测规则则输出可重复的结果。命令名称不能说明所有建议都能机械验证。
README 区分先做视觉构图与先改代码的路线，也描述实时迭代。根据页面现状选择方法，保留设计决策所依据的证据。
钩子改变反馈时机
宿主原生钩子可在文件编辑前后反馈检测结果。它改变发现问题的时机，不改变用户和宿主对修改与项目信任的最终决定权。
架构图应分开宿主 Agent、本地启动器、引擎和项目文件。本文没有穷尽仓库中各平台适配器的所有代码路径。
如何选择
| 比较维度 | 方案 A | 方案 B |
|---|---|---|
| Best when | You need predictable behavior and easy auditing | You need adaptive optimization and have reliable telemetry |
| Main risk | May leave performance on the table | Can become difficult to explain or debug |
实施步骤
- 1
分开记录 PRODUCT.md 与页面视觉方向。
- 2
追踪一个命令到它的输出。
- 3
确定钩子何时运行、由谁批准。
可复制示例
text
PRODUCT.md -> Agent 技能命令 -> 引擎或评论
DESIGN.md -> 页面视觉方向 ----^
实际页面 + 检测结果 -> 审阅决定常见问题
产品事实放在哪里？
文档中的 init 流程会写入 PRODUCT.md。
每条命令都执行同样检查吗？
需要看对应命令和引擎契约，不能只凭名字判断。
资料来源
- Impeccable / README.md来源核查 2026-09-29
- Impeccable / .agents/skills/impeccable/SKILL.md来源核查 2026-09-29
- Impeccable / docs/ENGINE.md来源核查 2026-09-29