Impeccable/impeccable无参数路由指南基于 Signals 的上下文感知命令菜单【免费下载链接】impeccableThe design language that makes your AI harness better at design.项目地址: https://gitcode.com/GitHub_Trending/im/impeccable当用户在对话中直接输入/impeccable不带任何子命令参数时他们实际上在问我现在该做什么。本文以 Impeccable Skill 的 路由参考文档 为骨架讲解如何把这一句空调用从一份静态命令列表变成一条由项目实时状态驱动的上下文感知菜单先读取impeccable context与impeccable signals输出的 JSON 信号再结合impeccable detect的本地扫描结果给出 23 条最高价值的下一条命令建议而完整命令表始终作为兜底。读完本文你将掌握无参数路由的完整决策逻辑、每条信号的具体判读规则以及如何将路由建议交给用户确认而绝不自动执行命令。一、路由参考在 Skill 中的位置路由逻辑位于 .rovodev/skills/impeccable/reference/routing.md它是 Impeccable Skill定义见 .rovodev/skills/impeccable/SKILL.md的入口分派层。SKILL.md 的 Routing 一节明确规定了三种进入方式无参数调用读取 routing.md呈现上下文感知菜单绝不自动运行任何命令显式或明确隐含的命令请求直接加载对应命令的参考文档原生平台加载原生变体工作流或命令选择类问题阅读 routing.md 的 Workflow questions 一节。也就是说/impeccable无参数调用的处理是整个 Skill 22 条命令craft、shape、init、document、extract、critique、audit、polish、bolder、quieter、distill、harden、onboard、animate、colorize、typeset、layout、delight、overdrive、clarify、adapt、optimize、live之间的智能分诊环节。二、Workflow questions只给建议不执行命令当用户提出的是工作流类问题我该怎么开始接下来做什么时路由参考给出了明确约束Give advice without executing commands; the menu below is only for bare invocations. Consult relevant command references as needed for prerequisites and scope. Link to the docs for the broader workflow guide. If the user also requests execution, follow that request.翻译成实际操作规则就是只给建议不执行命令——命令菜单仅用于裸调用即直接输入/impeccable场景必要时查阅相关命令的参考文档确认前置条件与适用范围如需完整工作流指南可引导用户阅读官方文档若用户同时明确要求执行则跟随该要求执行。这条规则避免了 Agent 在用户只是问一下时擅自动手改项目。三、No-argument routing把静态菜单变成动态决策无参数路由的核心原则是菜单是上下文感知的而不是静态的。用户输入/impeccable时Agent 的任务是回答我该做什么。3.1 先决条件Setup 已运行impeccable context路由参考要求每个会话先运行一次impeccable context见 SKILL.md Setup 一节其作用是解析 PRODUCT.md 路径并加载它加载 DESIGN.md、匹配的 surface brief 以及原生平台指引如适用遵循其指令且不重复运行。setup 完成后impeccable context的输出会携带项目状态信号。如果它报告NO_PRODUCT_MD说明项目还没有被捕获过上下文此时菜单要以/impeccable init作为置顶推荐附一行原因说明同时仍展示其余菜单不要悄悄跳进 init。3.2 运行 signals 并读取 JSON对于已经完成 setup 的项目路由参考要求Otherwise run.rovodev/skills/impeccable/scripts/impeccable signalsonce and read its JSON, then lead with the2-3 highest-value next commands, each with a one-line reason pulled from the signals, followed by the full menu (the Commands table in SKILL.md, grouped by category).即运行一次impeccable signals并读取其 JSON 输出然后置顶 23 条最高价值的下一条命令每条配一句从 signals 中提取的理由随后给出完整菜单即 SKILL.md 中按类别分组的 Commands 表绝不自动运行命令——推荐只是建议必须由用户确认。3.3 信号判读规则reason over the signals路由参考明确指出Reason over the signals; there is no score to obey——signals 中没有需要服从的分数Agent 需要基于下列规则进行推理信号判读结果setup.hasDesign为 false 且setup.hasCode为 true推荐document捕获视觉系统critique.latest为null项目从未被评审过对已 setup 且有真实 surface 的项目推荐/impeccable critique surface是强默认项critique.latest存在且score低或p0/p1非零推荐polish它将该快照作为积压清单读取在清单过期或清空时关闭它git.changedFiles指向单个 surface将audit或polish的 scope 限定到这些文件并点名这些文件devServer.running为 true可用live做浏览器内迭代为 false 则不置顶live以上都不适用按意图分组构建新东西 / 改进现有 / 视觉迭代并适配当前 surface 与setup.platform3.4 平台与 web-only 约束路由参考特别强调了两个适用范围约束live与捆绑的impeccable detect都是 web-only若setup.platform为ios、android或adaptive不要置顶live或detect——浏览器 overlay 和 HTML 规则引擎不适用于原生应用代码。这一点与 SKILL.md 命令表中audit/adapt提供.native变体audit.native.md、adapt.native.md的设计一致原生平台走另一套评估路径。3.5 用impeccable detect补充实时信号当scan.targets非空且平台不是ios/android/adaptive时路由参考要求额外运行一次.rovodev/skills/impeccable/scripts/impeccable detect --json scan.targets joined by spaces要点如下这是捆绑在 skill 脚本内的本地检测器不联网、不依赖 npx直接读取 HTML/CSS 文件因此原生项目要跳过scan.via告诉这些 target 是什么git-changes脏工作树中的 markup/style 文件最相关的一组、source-dir如src、app、html或root把命中结果折入推荐大量质量/对比度命中 →audit或polish特定 slop 家族 → 匹配的命令渐变文字或 eyebrow 徽章 →quieter/typeset扁平或灰调色板 →colorize以此类推它是真实、当前的信号胜过猜测如果 detect 报错或代码树过大扫描缓慢跳过它并建议用户自己运行audit绝不让检测阻塞推荐。以critique命令为例其参考文档 critique.md 展示了impeccable detect --json [target]的另一种用法作为评审的 Assessment B退出码 0 干净2 有发现可见 detect 既是路由阶段的轻量信号源也是深度评审的证据通道两条路径共享同一检测器。四、输出形态2-3 条精选 完整菜单兜底路由参考对最终回复形态的要求非常具体Keep it to 2-3 pointed picks with the exact command to type. The menu stays the fallback; the recommendation is the lede.即保持 23 条要点式的建议且每条给出可直接输入的确切命令完整菜单仍是兜底推荐意见才是开场。这也与 SKILL.md 中Routing: No argument: read routing.md and present its context-aware menu; never auto-run a command的规则完全一致。五、推荐背后的命令语义速查为了让路由推荐一句话理由落地以下是 SKILL.md Commands 表中与路由信号最常相关的几条命令语义完整表见 SKILL.md命令类别语义路由触发信号initBuild在 PRODUCT.md 中捕获持久产品事实NO_PRODUCT_MDdocumentBuild从现有代码生成 DESIGN.mdhasDesignfalse且hasCodetruecritique [target]Evaluate带启发式评分的 UX 设计评审critique.latest为 nullaudit [target]Evaluate技术质量检查a11y、性能、响应式scan.targets命中质量类问题polish [target]Refine发布前的最终质量检查critique.latest低分或 P0/P1 非零quieter [target]Refine调低过度刺激的设计强度detect 命中渐变文字等 slopcolorize [target]Enhance为单色 UI 添加战略性色彩detect 命中扁平/灰调色板liveIterate浏览器内可视化变体模式devServer.runningtrue值得注意的是polish命令polish.md正是设计为读取 critique 快照作为积压清单的它通过impeccable critique-storage latest resolved target --json取回最近一次快照比对文件内容指纹后处理其中的 P0/P1 发现处理完毕再用critique-storage close关闭快照。这正是路由信号中critique.latest低分 → 推荐 polish的底层机制——快照是活的数据不是存档。同理document命令document.md的 Scan mode 会按优先级扫描 CSS 自定义属性、Tailwind 配置、CSS-in-JS 主题文件、设计 token 文件、组件库、全局样式表乃至浏览器渲染结果自动提取颜色、字体、间距、圆角并写入符合 DESIGN.md 规范的 YAML frontmatter 与八个正文章节——这就是setup.hasDesign为 false 而setup.hasCode为 true 时推荐 document这一信号背后的实际能力。六、规则红线路由参考全文隐含并反复强调的红线包括绝不自动运行命令——推荐只是建议用户确认后才执行不是静态菜单——必须结合 signals 与 detect 结果动态生成置顶建议平台感知——live与detect只适用于 web原生平台ios/android/adaptive不置顶它们检测器可用性容忍——detect 出错或扫描过慢时跳过不阻塞推荐保持克制——23 条精选给确切命令文本不冗长。七、小结一条可复用的决策流水线把 routing.md 的完整逻辑压缩成一条可复用的流水线Setup 已运行impeccable context若输出NO_PRODUCT_MD→ 置顶/impeccable init否则运行impeccable signals读取 JSON按 3.3 的信号判读表提取 23 条最高价值命令各配一行理由若scan.targets非空且平台为 web运行impeccable detect --json把命中家族折入推荐失败则跳过输出置顶建议 完整菜单兜底等待用户确认绝不自动执行。这套先读上下文、再读实时信号、最后给建议的分层路由正是/impeccable从一句空调用变成项目专属设计顾问的入口机制。【免费下载链接】impeccableThe design language that makes your AI harness better at design.项目地址: https://gitcode.com/GitHub_Trending/im/impeccable创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考