Impeccable 新手教程

第四章 · /impeccable craft 实战

craft 是 Impeccable 的主力命令:先「塑形」(shape)再「构建」(build),全程带可视化迭代。本章用一个落地页从头走到尾。

1craft 的节奏

它把「AI 直接糊一版页面」拆成了有闸门的流水线,每一步你都有否决权。

/impeccable craft 需求→ shape 出 UX/UI 方案→ 你确认方向→ build 写实现→ 截图自查 + 引擎体检→ polish 收尾

如果第三章选了 buildPath=comp,中间会多一道「先看组件草图再写码」的闸门。下面按时间顺序拆开讲。

2第一步:shape,先谈方向不谈代码

把需求说清楚就交给它——注意需求里带上「给谁用、要什么感觉」,Agent 会自动读 PRODUCT.md 对齐。

你:/impeccable craft 落地页:给记账 App 的「快速上手」页,
    受众是自由职业者。想传达「三分钟记完今天的账」,
    希望页面安静、利落,别做成营销长页。

Agent:读了 PRODUCT.md(受众 / 语气)与 DESIGN.md(视觉系统)。
       shape 阶段,方案如下——
       结构:单屏为主,三段式——
         ① 首屏:一句价值主张 + 实时演示块(不是截图,是可交互小组件)
         ② 中段:「记一笔要几步」3 步流程,用真实控件示意
         ③ 尾屏:直接开记 CTA,附「无需注册,本地保存」安心话术
       视觉:延续 DESIGN.md 主色 #0F766E;
         标题用 Manrope 加字重对比,正文系统 UI;
         不用渐变横幅,靠留白与字号层级撑首屏。
       确认后我进 build;要调整吗?

这一步就是「shape-then-build」里的 shape:结构、层次、视觉方向都摊开在桌面上,你只需要回复「确认」或改两笔。返工成本最低的时刻就是现在。

3第二步:build 与自动体检

方向确认后 Agent 开始写码;写完它会自己截图检查,并顺手跑引擎的确定性检测。

你:确认,开始吧。

Agent:已实现 src/pages/quickstart/(7 个文件):
       · QuickstartHero:演示块用受控组件模拟真实记账流
       · ThreeSteps:步骤条 + 真实输入框示意
       · StartNow:CTA + 本地存储话术
       自查:dev server 截图 1280/768/390 三档视口过一遍,
       修正了 390px 下步骤条换行挤压的问题。
       引擎体检:61 条规则 0 major。
       你可以 npm run dev 看看,或者直接说感受。

注意「自查」不是模型自嗨——视口截图是引擎在本地起服务渲染后拍的,体检规则也是确定性跑出来的。你在 Cursor CLI 里随时可以自己复核:

# 不经 AI,直接对目录跑一遍确定性检测
npx impeccable detect src/pages/quickstart/

4第三步:迭代,用「力度」说话

看完第一版,你大概率不会说「把字号改成 17px」,而是「太素了」「有点吵」——这正是另外几个命令存在的意义。

你的感受输入Agent 会做什么
「太素了,没有记忆点」/impeccable bolder放大对比、强化视觉锚点,把平庸的设计推出去
「有点吵,信息过载」/impeccable quieter降噪:减色彩、减装饰、收紧层次
「花里胡哨,只要骨架」/impeccable distill剥离到本质,去掉一切可去的元素
「字看着难受」/impeccable typeset只动字体选择、层级与字号,不碰其他
「间距和节奏不对」/impeccable layout只动布局、间距、视觉节奏
「加点让人会心一笑的东西」/impeccable delight添加克制的愉悦时刻(微交互、彩蛋级细节)

这些命令也可以靶向执行,比如只调某个区块:/impeccable bolder QuickstartHero。改完随时可以再跑 /impeccable critique 听一轮结构性意见。

下一步

页面成型后,用第五章的 critique / audit / polish 做正式的审查与收尾;想「亲眼盯着调」则直接跳第七章 live。

Impeccable 新手教程