Impeccable buildPath选择指南comp-first与code-first构建路径完整对比【免费下载链接】impeccableThe design language that makes your AI harness better at design.项目地址: https://gitcode.com/GitHub_Trending/im/impeccableImpeccable 是一个为 AI 编码代理提供前端设计指导的开源项目包含 1 个技能、23 个设计命令和 59 条确定性检测规则。其中buildPath构建路径是初始化时的一个关键设置决定 AI 创建新界面时是先用 AI 绘图生成高保真设计稿再写代码comp-first还是直接写代码、把设计野心写进方向契约并在收尾时校验code-first。本文带你 10 分钟搞懂这两条路径的差异、如何选择、以及如何随时切换。一、两条构建路径分别是什么当 AI 为你的项目设计一个新界面新 surface时Impeccable 只有两种开工方式对比维度 comp-firstcomp⚡ code-firstcode工作方式先生成一张全保真设计稿comp再写代码去匹配它直接在代码中构建设计野心写入方向契约direction contract完成时再检查视觉野心更敢做、构图更大胆相对克制、以实用为主速度更慢每张卡片约需 1~2 分钟图片生成更快、更轻量前提条件必须有图片生成能力harness 原生绘图工具或 API 兜底无额外要求无图片生成时这是唯一路径适合场景品牌官网、落地页、作品集等视觉驱动的界面应用 UI、仪表盘、工具型产品或追求迭代速度的团队 一句话记忆comp-first 用图片先定标准code-first 用契约先定标准。相关说明可参考 README.md 中的 Build path: comp-first or code-first 章节。二、buildPath 在哪里设置执行/impeccable init初始化时只要你的工具链具备图片生成能力且项目尚未记录过buildPathImpeccable 就会单独问一次新界面应该用哪种方式开工注意这是一个独立问题不会捆绑在其他提问里。你的回答会被写入项目根的.impeccable/config.json{ buildPath: comp }合法值只有两个comp和code没有其他值。设置细节见 skill/reference/init.md。关于默认值有 3 个容易踩坑的点不回答 走 comp-first 默认有图片生成能力但未记录时新工作默认走 comp-first。Impeccable 会明确告诉你本次走了哪条路径、但未存储而不是默默替你决定。已记录的值会被静默遵守重跑 init 时不会再次询问——但它是默认而非锁随时可改。无图片生成能力就没有这道题此时 code-first 是唯一路径不会记录任何值。此外skill/scripts/lib/staleness.mjs 中的checkBuildPathUnset检查会发现已经跑过视觉方向工作、却从未记录 buildPath的老项目并提醒你在有图片生成能力时补做一次性选择——避免每一轮方向讨论都在无人知晓的情况下走默认路径。三、如何切换构建路径无需重跑 init这是 buildPath 设计里最贴心的部分你不需要重跑 init也不需要手动编辑文件。1️⃣ 决策页脚部开关推荐每个方向决策页面direction page的页脚都有一个 Comp first / Code first 分段切换开关旁边还有一行说明当前选择的取舍。切换的说明文案定义在 skill/scripts/serve-question.mjs。切到 code-first零成本立即生效不弹任何确认。切到 comp-first会先弹一个确认框——每张卡片约需 1~2 分钟渲染设计稿确认开始因为图片生成是分钟级的开销。无论怎么切只绑定当前会话session绝不写回配置文件。2️⃣ 老项目的迁移路径对于设置诞生前的老项目在决策页用开关纠正默认值切换后 Impeccable 会问一次是否保留这个选择回答后即写入配置。这就是全部的迁移流程。3️⃣ 单人机器覆盖config.local.json在 gitignored不提交到版本库的.impeccable/config.local.json中写buildPath可以只在本机覆盖团队提交在config.json里的值——典型场景就是你的 harness 没有图片生成能力而团队共享配置是comp。4️⃣ Monorepo 策略在仓库根目录提交一次config.json即可全局生效某个子工作区workspace想要不同路径时只在自己的目录下设置即可。四、怎么选按场景对号入座做品牌站、落地页、作品集→ 选comp。视觉表达是核心卖点值得多花几分钟让设计稿先立起来代码再去匹配。️做应用 UI、后台、工具→ 选code。功能正确性优先方向契约 完成时审计足以保证野心不缩水速度优势明显。️工具链没有图片生成能力→ 无需纠结code-first 是唯一路径系统也不会问这道题。团队共享仓库→ 团队共识写进config.json个人机器环境特殊时用config.local.json悄悄覆盖。五、常见疑问速答Q1buildPath 是产品配置吗会写进 PRODUCT.md 吗不会。它是工作流偏好只存在于.impeccable/config.json。写进 PRODUCT.md 会产生一份第二副本在设置被改掉后继续误导后续的每一轮设计——这正是 Impeccable 明确禁止的。Q2切换开关改了配置吗没有。页脚开关只绑定单次会话。唯一会写回配置的场景在从未记录过的项目上切换后你确认保留此时才写入。Q3config.local.json 会被提交吗不会它在 README.md 推荐的.gitignore块中。config.json才是需要提交给团队的共享配置。六、小结决策点建议视觉驱动项目comp让图片先定标准功能驱动项目 / 求快code让契约先定标准本机无图片生成code自动唯一路径想临时体验另一条路页脚开关切一下只影响本次会话buildPath 的整个设计哲学就是问一次、记一处、随时可改。初始化时认真回答那一个问题剩下的交给开关和配置文件——这就是 Impeccable 让 AI 设计工作可追溯的关键细节。 延伸阅读初始化完整流程skill/reference/init.md方向轮次执行规则skill/reference/new-work.md配置失效检查逻辑skill/scripts/lib/staleness.mjs图片生成能力检测skill/scripts/context.mjs【免费下载链接】impeccableThe design language that makes your AI harness better at design.项目地址: https://gitcode.com/GitHub_Trending/im/impeccable创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
Impeccable buildPath选择指南：comp-first与code-first构建路径完整对比
Impeccable buildPath选择指南comp-first与code-first构建路径完整对比【免费下载链接】impeccableThe design language that makes your AI harness better at design.项目地址: https://gitcode.com/GitHub_Trending/im/impeccableImpeccable 是一个为 AI 编码代理提供前端设计指导的开源项目包含 1 个技能、23 个设计命令和 59 条确定性检测规则。其中buildPath构建路径是初始化时的一个关键设置决定 AI 创建新界面时是先用 AI 绘图生成高保真设计稿再写代码comp-first还是直接写代码、把设计野心写进方向契约并在收尾时校验code-first。本文带你 10 分钟搞懂这两条路径的差异、如何选择、以及如何随时切换。一、两条构建路径分别是什么当 AI 为你的项目设计一个新界面新 surface时Impeccable 只有两种开工方式对比维度 comp-firstcomp⚡ code-firstcode工作方式先生成一张全保真设计稿comp再写代码去匹配它直接在代码中构建设计野心写入方向契约direction contract完成时再检查视觉野心更敢做、构图更大胆相对克制、以实用为主速度更慢每张卡片约需 1~2 分钟图片生成更快、更轻量前提条件必须有图片生成能力harness 原生绘图工具或 API 兜底无额外要求无图片生成时这是唯一路径适合场景品牌官网、落地页、作品集等视觉驱动的界面应用 UI、仪表盘、工具型产品或追求迭代速度的团队 一句话记忆comp-first 用图片先定标准code-first 用契约先定标准。相关说明可参考 README.md 中的 Build path: comp-first or code-first 章节。二、buildPath 在哪里设置执行/impeccable init初始化时只要你的工具链具备图片生成能力且项目尚未记录过buildPathImpeccable 就会单独问一次新界面应该用哪种方式开工注意这是一个独立问题不会捆绑在其他提问里。你的回答会被写入项目根的.impeccable/config.json{ buildPath: comp }合法值只有两个comp和code没有其他值。设置细节见 skill/reference/init.md。关于默认值有 3 个容易踩坑的点不回答 走 comp-first 默认有图片生成能力但未记录时新工作默认走 comp-first。Impeccable 会明确告诉你本次走了哪条路径、但未存储而不是默默替你决定。已记录的值会被静默遵守重跑 init 时不会再次询问——但它是默认而非锁随时可改。无图片生成能力就没有这道题此时 code-first 是唯一路径不会记录任何值。此外skill/scripts/lib/staleness.mjs 中的checkBuildPathUnset检查会发现已经跑过视觉方向工作、却从未记录 buildPath的老项目并提醒你在有图片生成能力时补做一次性选择——避免每一轮方向讨论都在无人知晓的情况下走默认路径。三、如何切换构建路径无需重跑 init这是 buildPath 设计里最贴心的部分你不需要重跑 init也不需要手动编辑文件。1️⃣ 决策页脚部开关推荐每个方向决策页面direction page的页脚都有一个 Comp first / Code first 分段切换开关旁边还有一行说明当前选择的取舍。切换的说明文案定义在 skill/scripts/serve-question.mjs。切到 code-first零成本立即生效不弹任何确认。切到 comp-first会先弹一个确认框——每张卡片约需 1~2 分钟渲染设计稿确认开始因为图片生成是分钟级的开销。无论怎么切只绑定当前会话session绝不写回配置文件。2️⃣ 老项目的迁移路径对于设置诞生前的老项目在决策页用开关纠正默认值切换后 Impeccable 会问一次是否保留这个选择回答后即写入配置。这就是全部的迁移流程。3️⃣ 单人机器覆盖config.local.json在 gitignored不提交到版本库的.impeccable/config.local.json中写buildPath可以只在本机覆盖团队提交在config.json里的值——典型场景就是你的 harness 没有图片生成能力而团队共享配置是comp。4️⃣ Monorepo 策略在仓库根目录提交一次config.json即可全局生效某个子工作区workspace想要不同路径时只在自己的目录下设置即可。四、怎么选按场景对号入座做品牌站、落地页、作品集→ 选comp。视觉表达是核心卖点值得多花几分钟让设计稿先立起来代码再去匹配。️做应用 UI、后台、工具→ 选code。功能正确性优先方向契约 完成时审计足以保证野心不缩水速度优势明显。️工具链没有图片生成能力→ 无需纠结code-first 是唯一路径系统也不会问这道题。团队共享仓库→ 团队共识写进config.json个人机器环境特殊时用config.local.json悄悄覆盖。五、常见疑问速答Q1buildPath 是产品配置吗会写进 PRODUCT.md 吗不会。它是工作流偏好只存在于.impeccable/config.json。写进 PRODUCT.md 会产生一份第二副本在设置被改掉后继续误导后续的每一轮设计——这正是 Impeccable 明确禁止的。Q2切换开关改了配置吗没有。页脚开关只绑定单次会话。唯一会写回配置的场景在从未记录过的项目上切换后你确认保留此时才写入。Q3config.local.json 会被提交吗不会它在 README.md 推荐的.gitignore块中。config.json才是需要提交给团队的共享配置。六、小结决策点建议视觉驱动项目comp让图片先定标准功能驱动项目 / 求快code让契约先定标准本机无图片生成code自动唯一路径想临时体验另一条路页脚开关切一下只影响本次会话buildPath 的整个设计哲学就是问一次、记一处、随时可改。初始化时认真回答那一个问题剩下的交给开关和配置文件——这就是 Impeccable 让 AI 设计工作可追溯的关键细节。 延伸阅读初始化完整流程skill/reference/init.md方向轮次执行规则skill/reference/new-work.md配置失效检查逻辑skill/scripts/lib/staleness.mjs图片生成能力检测skill/scripts/context.mjs【免费下载链接】impeccableThe design language that makes your AI harness better at design.项目地址: https://gitcode.com/GitHub_Trending/im/impeccable创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考