impeccable 無參數路由全解析如何用 context 信號與本地檢測器生成上下文感知的命令菜單【免費下載鏈接】impeccableThe design language that makes your AI harness better at design.項目地址: https://gitcode.com/GitHub_Trending/im/impeccable導讀在 impeccable 這套 AI 設計技能體系中用戶輸入/impeccable不帶任何參數時Agent 面對的是一個開放性問題——我現在該做什么。本文圍繞 .hermes/skills/impeccable/reference/routing.md 展開系統講解 impeccable 的**命令路由Command Routing**機制如何通過impeccable context與impeccable signals收集項目實時狀態如何根據 setup / critique / git / dev-server / platform / scan 六類信號做出決策以及如何在 2-3 條高價值建議與完整命令菜單之間組織回復。讀完本文你將掌握 impeccable 技能在無參數調用場景下的完整決策協議理解每一條信號背后的含義與優先級并能將其復用到自己的 AI Agent 工具編排設計中。路由總覽三種入口一個原則routing.md 開篇定義了路由的三個入口它們共享同一條核心原則永遠不自動執行命令推薦只是交給用戶確認的建議。入口用戶輸入Agent 行為工作流問題Workflow questions詢問該用哪個命令先做什么只給建議不執行命令顯式命令請求/impeccable critique等帶參數調用加載對應 reference 并執行原生平臺加載.native變體無參數路由裸輸入/impeccable運行信號采集輸出上下文感知的推薦 完整菜單在 .hermes/skills/impeccable/SKILL.md 的 Routing 一節中這一原則被進一步細化為四層判定無參數時讀 routing.md 并展示菜單顯式或明確隱含的命令請求加載其 reference工作流/命令選擇類問題走 Workflow questions其余情況按一般設計工作處理——缺 PRODUCT.md 的新表面走 init new-work既有代碼的窄幅精修則直接推進并在事后建議 init而不是阻塞在 init 上。值得注意的是工作流問題場景下只給建議不執行命令并不意味著完全空手——routing.md 明確要求 Agent按需查閱相關命令的 reference以確認前置條件與作用范圍即建議必須建立在真實命令語義之上而不是憑記憶拼湊。無參數調用的第一步讀取 context 輸出會話開頭的impeccable context按 SKILL.md 的 Setup 流程每個會話開始都要運行一次.hermes/skills/impeccable/scripts/impeccable context啟動器腳本 .hermes/skills/impeccable/scripts/impeccable 是一個無 Node 依賴的 sh 啟動器它按IMPECCABLE_BIN→ 隨行平臺二進制 →~/.impeccable/bin→ 版本固定緩存 → PATH 的順序解析引擎最后才通過網絡下載并校驗 SHA-256。context子命令會加載 PRODUCT.md、DESIGN.md、對應的 surface brief 與原生平臺指引并在輸出中攜帶一系列關鍵信號。關鍵分歧點NO_PRODUCT_MDrouting.md 規定如果impeccable context報告了NO_PRODUCT_MD說明項目尚未捕獲任何產品上下文還沒有 PRODUCT.md。此時菜單的編排規則是置頂推薦/impeccable init并給出一行理由菜單其余部分照常展示不要靜默跳進 init——init 涉及多輪訪談與產品事實確認必須由用戶明確確認。從源碼看這一信號的產生邏輯位于 crates/context/src/context_cli.rs當項目缺少 PRODUCT.md 時context CLI 會區分兩種情況——存在既有視覺實現has an incumbent visual implementation與完全從零開始。前者建議 init 記錄既有系統后者則要求先完成訪談并寫入 PRODUCT.md。這解釋了為何 routing.md 說不要靜默跳入 initinit 的產物PRODUCT.md是后續一切命令的事實基礎。impeccable signals讀取結構化決策信號當項目已具備上下文無NO_PRODUCT_MD時無參數路由進入第二步.hermes/skills/impeccable/scripts/impeccable signals運行一次并讀取其 JSON 輸出。這些信號是路由推薦的事實依據。routing.md 特別強調Reason over the signals; there is no score to obey——信號之間不存在可機械加總的分數Agent 需要人工推理。信號的生成實現在 crates/context/src/signals.rs例如changedFiles在非 Git 倉庫時被置為空數組第 106-111 行在 Git 倉庫中則通過git diff收集第 235 行最多取前 50 個文件hasDesign直接取自ctx.has_design第 328 行。也就是說你看到的每個信號字段都對應著倉庫中一段可驗證的采集邏輯。六類信號的決策規則routing.md 給出了無參數路由的核心決策表下面逐條展開并補充每條信號背后的實現邏輯與命令語義。1. setup設計系統缺失但有代碼 →document當setup.hasDesign為 false 而setup.hasCode為 true 時推薦/impeccable document。該命令從代碼庫自動抽取顏色、排版、間距、圓角與組件模式生成遵循 Google Stitch DESIGN.md 格式的視覺設計系統文檔參見 .hermes/skills/impeccable/scripts/command-metadata.json 中document條目。其語義是記錄既有視覺系統與init捕獲產品事實和 new-work創建新視覺世界嚴格分工——.hermes/skills/impeccable/reference/init.md 明確寫道 init does not invent a visual world and does not write DESIGN.md。2. critique從未評審過 →critique surface當critique.latest為 null 時說明該項目從未做過設計評審。對于一個已完成 setup、存在真實表面的項目/impeccable critique surface是強默認推薦。critique 會運行兩個相互隔離的評估設計評審 檢測器/瀏覽器證據產出 Nielsen 十啟發式評分表、設計特異性判定、P0-P3 優先級問題、人物角色紅旗等完整報告并將快照持久化到.impeccable/critique/參見 .hermes/skills/impeccable/reference/critique.md。3. critique低分或存在 P0/P1 →polish當critique.latest存在但分數較低或帶有非零的p0/p1計數時推薦/impeccable polish。polish 會把 critique 快照當作自己的積壓清單backlog來讀取通過impeccable critique-storage latest target --json取出最近一次快照比對文件內容指紋處理其中的 P0/P1 問題并在全部清空后關閉該快照參見 .hermes/skills/impeccable/reference/polish.md。當快照過期或被清空時polish 的這一輪 backlog 也隨之關閉。這形成了 critique 發現 → polish 修復 → 快照關閉 的閉環。4. git變更指向單一表面 → 收窄范圍當git.changedFiles指向一個具體的表面surface時將audit或polish的作用域收窄到這些文件并在推薦中明確點名。從 crates/context/src/signals.rs 的實現看該信號還包含倉庫狀態判定isRepo、branch、base分支探測changedFiles最多截取前 50 個文件避免超大變更集污染推薦。5. devServer運行中 →live可用當devServer.running為 true 時說明瀏覽器內迭代工具/impeccable live可用若為 false則不要用live打頭。live 模式允許用戶在瀏覽器中選中元素、選擇設計動作獲得 AI 生成的 HTMLCSS 變體并經 HMR 熱替換參見 .hermes/skills/impeccable/reference/live.md。6. platformweb-only 邊界這是最容易踩坑的邊界條件。routing.md 明確指出live和隨附的impeccable detect僅限 Web。當setup.platform為ios、android或adaptive時兩者都不能打頭推薦——瀏覽器覆蓋層與 HTML 規則引擎不適用于原生應用代碼。audit 命令也遵循同樣的平臺分流.hermes/skills/impeccable/reference/audit.md 開篇即聲明Web only原生平臺路由到audit.native.md。而impeccable context只有在 init 寫入 PRODUCT.md 后才能真正知道平臺init 完成時若記錄的是原生平臺會自行加載 ios.md / android.md這是無參數路由推薦init后不得重跑 context 的原因之一。兜底按意圖分組當上述信號都不構成強推薦時按用戶意圖分組組織菜單構建新東西build new/ 改進現有東西improve whats there/ 視覺迭代iterate visually并針對當前表面與setup.platform定制措辭。impeccable detect本地、實時、無網絡的增量信號routing.md 給出了無參數路由中唯一的一次額外命令執行且是條件性的若scan.targets非空且setup.platform不是 ios/android/adaptive運行一次.hermes/skills/impeccable/scripts/impeccable detect --json scan.targets 以空格連接。這里的關鍵特性值得展開無網絡、無 npx這是隨附的本地檢測器直接在本地文件上運行因此讀的是 HTML/CSS——原生項目應跳過scan.via說明目標來源git-changes工作區臟樹中的標記/樣式文件最相關的一組、source-dir如src、app、html、或root命中結果映射到命令大量質量/對比度命中 →audit或polish特定 slop 族如漸變文字或 eyebrow 眉題 →quieter/typeset扁平或灰色調色板 →colorize以此類推失敗不阻塞若 detect 報錯或目錄樹過大導致緩慢直接跳過改為建議用戶自行運行audit永遠不要讓推薦被它卡住。routing.md 的措辭是它detect 結果是真實的、當前的信號勝過猜測——這正是該機制的設計意圖用一次本地掃描把推薦從基于歷史信號的外推升級為基于當前代碼狀態的實證。輸出格式精簡的推薦 兜底菜單無參數路由的最終輸出遵守兩條紀律只給 2-3 條精準的、可照抄的命令建議——每條建議附一行從 signals 推導出的理由菜單只是兜底fallback推薦才是頭條lede推薦的命令必須給出確切的、可輸入的完整命令例如impeccable critique src/pages/index.astro而不是模糊的考慮做一次評審。在回復結構上這正好與 .hermes/skills/impeccable/reference/critique.md 對報告先行、問題收尾的硬性要求互補——無參數路由的輸出同樣遵循先給結論、再給選項的信息順序把完整命令菜單放在推薦之后避免推薦被淹沒。命令菜單的語義錨點無參數路由的完整菜單并非靜態清單而是 .hermes/skills/impeccable/SKILL.md 中 Commands 表按類別分組的投影。四個類別及代表命令如下完整命令列表及描述見 .hermes/skills/impeccable/scripts/command-metadata.json類別命令一句話語義Buildshape/init/document/extract規劃、捕獲產品事實、記錄視覺系統、抽取設計系統Evaluatecritique/auditUX 評審啟發式評分 / 技術質量檢查a11y、性能、響應式Refinepolish/bolder/quieter/distill/harden/onboard收尾、放大、降噪、精簡、加固、首次體驗Enhanceanimate/colorize/typeset/layout/delight/overdrive動效、色彩、排版、布局、個性、極限Fixclarify/adapt/optimize文案、多設備適配、性能Iteratelive瀏覽器內視覺變體模式菜單中還需如實反映兩個兼容性注記craft是 new-work 的廢棄別名adds nothingteach是init的別名。這些語義在 .hermes/skills/impeccable/SKILL.md 的 Routing 與 Pin/Unpin 段落中均有明文?？偨Y從靜態菜單到信號驅動的推薦impeccable 的無參數路由本質上是把用戶問我該做什么這個模糊問題轉化為一個可證偽的決策流水線impeccable context建立項目事實基線缺 PRODUCT.md 則路由到 initimpeccable signals產出 setup / critique / git / devServer / platform / scan 六類結構化信號條件性的impeccable detect --json把本地文件掃描結果作為比猜測更真實的當前信號折入決策Agent 推理信號而非機械打分輸出 2-3 條精確命令 完整菜單兜底任何情況下不自動執行命令把確認權留給用戶。這套設計對構建 AI 工具編排的開發者有直接的參考價值用輕量、無網絡依賴的本地信號替代猜測用明確的平臺邊界防止跨領域誤推薦用推薦 兜底菜單的兩層結構保證輸出既聚焦又完備。深入研讀 crates/context/src/signals.rs 與 crates/context/src/context_cli.rs 的源碼實現可以進一步看到每個信號字段的采集成本與邊界處理——這正是一個生產級命令路由系統應有的樣子?！久赓M下載鏈接】impeccableThe design language that makes your AI harness better at design.項目地址: https://gitcode.com/GitHub_Trending/im/impeccable創作聲明：本文部分內容由AI輔助生成（AIGC），僅供參考 impeccable 無參數路由全解析：如何用 context 信號與本地檢測器生成上下文感知的命令菜單
impeccable 無參數路由全解析如何用 context 信號與本地檢測器生成上下文感知的命令菜單【免費下載鏈接】impeccableThe design language that makes your AI harness better at design.項目地址: https://gitcode.com/GitHub_Trending/im/impeccable導讀在 impeccable 這套 AI 設計技能體系中用戶輸入/impeccable不帶任何參數時Agent 面對的是一個開放性問題——我現在該做什么。本文圍繞 .hermes/skills/impeccable/reference/routing.md 展開系統講解 impeccable 的**命令路由Command Routing**機制如何通過impeccable context與impeccable signals收集項目實時狀態如何根據 setup / critique / git / dev-server / platform / scan 六類信號做出決策以及如何在 2-3 條高價值建議與完整命令菜單之間組織回復。讀完本文你將掌握 impeccable 技能在無參數調用場景下的完整決策協議理解每一條信號背后的含義與優先級并能將其復用到自己的 AI Agent 工具編排設計中。路由總覽三種入口一個原則routing.md 開篇定義了路由的三個入口它們共享同一條核心原則永遠不自動執行命令推薦只是交給用戶確認的建議。入口用戶輸入Agent 行為工作流問題Workflow questions詢問該用哪個命令先做什么只給建議不執行命令顯式命令請求/impeccable critique等帶參數調用加載對應 reference 并執行原生平臺加載.native變體無參數路由裸輸入/impeccable運行信號采集輸出上下文感知的推薦 完整菜單在 .hermes/skills/impeccable/SKILL.md 的 Routing 一節中這一原則被進一步細化為四層判定無參數時讀 routing.md 并展示菜單顯式或明確隱含的命令請求加載其 reference工作流/命令選擇類問題走 Workflow questions其余情況按一般設計工作處理——缺 PRODUCT.md 的新表面走 init new-work既有代碼的窄幅精修則直接推進并在事后建議 init而不是阻塞在 init 上。值得注意的是工作流問題場景下只給建議不執行命令并不意味著完全空手——routing.md 明確要求 Agent按需查閱相關命令的 reference以確認前置條件與作用范圍即建議必須建立在真實命令語義之上而不是憑記憶拼湊。無參數調用的第一步讀取 context 輸出會話開頭的impeccable context按 SKILL.md 的 Setup 流程每個會話開始都要運行一次.hermes/skills/impeccable/scripts/impeccable context啟動器腳本 .hermes/skills/impeccable/scripts/impeccable 是一個無 Node 依賴的 sh 啟動器它按IMPECCABLE_BIN→ 隨行平臺二進制 →~/.impeccable/bin→ 版本固定緩存 → PATH 的順序解析引擎最后才通過網絡下載并校驗 SHA-256。context子命令會加載 PRODUCT.md、DESIGN.md、對應的 surface brief 與原生平臺指引并在輸出中攜帶一系列關鍵信號。關鍵分歧點NO_PRODUCT_MDrouting.md 規定如果impeccable context報告了NO_PRODUCT_MD說明項目尚未捕獲任何產品上下文還沒有 PRODUCT.md。此時菜單的編排規則是置頂推薦/impeccable init并給出一行理由菜單其余部分照常展示不要靜默跳進 init——init 涉及多輪訪談與產品事實確認必須由用戶明確確認。從源碼看這一信號的產生邏輯位于 crates/context/src/context_cli.rs當項目缺少 PRODUCT.md 時context CLI 會區分兩種情況——存在既有視覺實現has an incumbent visual implementation與完全從零開始。前者建議 init 記錄既有系統后者則要求先完成訪談并寫入 PRODUCT.md。這解釋了為何 routing.md 說不要靜默跳入 initinit 的產物PRODUCT.md是后續一切命令的事實基礎。impeccable signals讀取結構化決策信號當項目已具備上下文無NO_PRODUCT_MD時無參數路由進入第二步.hermes/skills/impeccable/scripts/impeccable signals運行一次并讀取其 JSON 輸出。這些信號是路由推薦的事實依據。routing.md 特別強調Reason over the signals; there is no score to obey——信號之間不存在可機械加總的分數Agent 需要人工推理。信號的生成實現在 crates/context/src/signals.rs例如changedFiles在非 Git 倉庫時被置為空數組第 106-111 行在 Git 倉庫中則通過git diff收集第 235 行最多取前 50 個文件hasDesign直接取自ctx.has_design第 328 行。也就是說你看到的每個信號字段都對應著倉庫中一段可驗證的采集邏輯。六類信號的決策規則routing.md 給出了無參數路由的核心決策表下面逐條展開并補充每條信號背后的實現邏輯與命令語義。1. setup設計系統缺失但有代碼 →document當setup.hasDesign為 false 而setup.hasCode為 true 時推薦/impeccable document。該命令從代碼庫自動抽取顏色、排版、間距、圓角與組件模式生成遵循 Google Stitch DESIGN.md 格式的視覺設計系統文檔參見 .hermes/skills/impeccable/scripts/command-metadata.json 中document條目。其語義是記錄既有視覺系統與init捕獲產品事實和 new-work創建新視覺世界嚴格分工——.hermes/skills/impeccable/reference/init.md 明確寫道 init does not invent a visual world and does not write DESIGN.md。2. critique從未評審過 →critique surface當critique.latest為 null 時說明該項目從未做過設計評審。對于一個已完成 setup、存在真實表面的項目/impeccable critique surface是強默認推薦。critique 會運行兩個相互隔離的評估設計評審 檢測器/瀏覽器證據產出 Nielsen 十啟發式評分表、設計特異性判定、P0-P3 優先級問題、人物角色紅旗等完整報告并將快照持久化到.impeccable/critique/參見 .hermes/skills/impeccable/reference/critique.md。3. critique低分或存在 P0/P1 →polish當critique.latest存在但分數較低或帶有非零的p0/p1計數時推薦/impeccable polish。polish 會把 critique 快照當作自己的積壓清單backlog來讀取通過impeccable critique-storage latest target --json取出最近一次快照比對文件內容指紋處理其中的 P0/P1 問題并在全部清空后關閉該快照參見 .hermes/skills/impeccable/reference/polish.md。當快照過期或被清空時polish 的這一輪 backlog 也隨之關閉。這形成了 critique 發現 → polish 修復 → 快照關閉 的閉環。4. git變更指向單一表面 → 收窄范圍當git.changedFiles指向一個具體的表面surface時將audit或polish的作用域收窄到這些文件并在推薦中明確點名。從 crates/context/src/signals.rs 的實現看該信號還包含倉庫狀態判定isRepo、branch、base分支探測changedFiles最多截取前 50 個文件避免超大變更集污染推薦。5. devServer運行中 →live可用當devServer.running為 true 時說明瀏覽器內迭代工具/impeccable live可用若為 false則不要用live打頭。live 模式允許用戶在瀏覽器中選中元素、選擇設計動作獲得 AI 生成的 HTMLCSS 變體并經 HMR 熱替換參見 .hermes/skills/impeccable/reference/live.md。6. platformweb-only 邊界這是最容易踩坑的邊界條件。routing.md 明確指出live和隨附的impeccable detect僅限 Web。當setup.platform為ios、android或adaptive時兩者都不能打頭推薦——瀏覽器覆蓋層與 HTML 規則引擎不適用于原生應用代碼。audit 命令也遵循同樣的平臺分流.hermes/skills/impeccable/reference/audit.md 開篇即聲明Web only原生平臺路由到audit.native.md。而impeccable context只有在 init 寫入 PRODUCT.md 后才能真正知道平臺init 完成時若記錄的是原生平臺會自行加載 ios.md / android.md這是無參數路由推薦init后不得重跑 context 的原因之一。兜底按意圖分組當上述信號都不構成強推薦時按用戶意圖分組組織菜單構建新東西build new/ 改進現有東西improve whats there/ 視覺迭代iterate visually并針對當前表面與setup.platform定制措辭。impeccable detect本地、實時、無網絡的增量信號routing.md 給出了無參數路由中唯一的一次額外命令執行且是條件性的若scan.targets非空且setup.platform不是 ios/android/adaptive運行一次.hermes/skills/impeccable/scripts/impeccable detect --json scan.targets 以空格連接。這里的關鍵特性值得展開無網絡、無 npx這是隨附的本地檢測器直接在本地文件上運行因此讀的是 HTML/CSS——原生項目應跳過scan.via說明目標來源git-changes工作區臟樹中的標記/樣式文件最相關的一組、source-dir如src、app、html、或root命中結果映射到命令大量質量/對比度命中 →audit或polish特定 slop 族如漸變文字或 eyebrow 眉題 →quieter/typeset扁平或灰色調色板 →colorize以此類推失敗不阻塞若 detect 報錯或目錄樹過大導致緩慢直接跳過改為建議用戶自行運行audit永遠不要讓推薦被它卡住。routing.md 的措辭是它detect 結果是真實的、當前的信號勝過猜測——這正是該機制的設計意圖用一次本地掃描把推薦從基于歷史信號的外推升級為基于當前代碼狀態的實證。輸出格式精簡的推薦 兜底菜單無參數路由的最終輸出遵守兩條紀律只給 2-3 條精準的、可照抄的命令建議——每條建議附一行從 signals 推導出的理由菜單只是兜底fallback推薦才是頭條lede推薦的命令必須給出確切的、可輸入的完整命令例如impeccable critique src/pages/index.astro而不是模糊的考慮做一次評審。在回復結構上這正好與 .hermes/skills/impeccable/reference/critique.md 對報告先行、問題收尾的硬性要求互補——無參數路由的輸出同樣遵循先給結論、再給選項的信息順序把完整命令菜單放在推薦之后避免推薦被淹沒。命令菜單的語義錨點無參數路由的完整菜單并非靜態清單而是 .hermes/skills/impeccable/SKILL.md 中 Commands 表按類別分組的投影。四個類別及代表命令如下完整命令列表及描述見 .hermes/skills/impeccable/scripts/command-metadata.json類別命令一句話語義Buildshape/init/document/extract規劃、捕獲產品事實、記錄視覺系統、抽取設計系統Evaluatecritique/auditUX 評審啟發式評分 / 技術質量檢查a11y、性能、響應式Refinepolish/bolder/quieter/distill/harden/onboard收尾、放大、降噪、精簡、加固、首次體驗Enhanceanimate/colorize/typeset/layout/delight/overdrive動效、色彩、排版、布局、個性、極限Fixclarify/adapt/optimize文案、多設備適配、性能Iteratelive瀏覽器內視覺變體模式菜單中還需如實反映兩個兼容性注記craft是 new-work 的廢棄別名adds nothingteach是init的別名。這些語義在 .hermes/skills/impeccable/SKILL.md 的 Routing 與 Pin/Unpin 段落中均有明文?？偨Y從靜態菜單到信號驅動的推薦impeccable 的無參數路由本質上是把用戶問我該做什么這個模糊問題轉化為一個可證偽的決策流水線impeccable context建立項目事實基線缺 PRODUCT.md 則路由到 initimpeccable signals產出 setup / critique / git / devServer / platform / scan 六類結構化信號條件性的impeccable detect --json把本地文件掃描結果作為比猜測更真實的當前信號折入決策Agent 推理信號而非機械打分輸出 2-3 條精確命令 完整菜單兜底任何情況下不自動執行命令把確認權留給用戶。這套設計對構建 AI 工具編排的開發者有直接的參考價值用輕量、無網絡依賴的本地信號替代猜測用明確的平臺邊界防止跨領域誤推薦用推薦 兜底菜單的兩層結構保證輸出既聚焦又完備。深入研讀 crates/context/src/signals.rs 與 crates/context/src/context_cli.rs 的源碼實現可以進一步看到每個信號字段的采集成本與邊界處理——這正是一個生產級命令路由系統應有的樣子?！久赓M下載鏈接】impeccableThe design language that makes your AI harness better at design.項目地址: https://gitcode.com/GitHub_Trending/im/impeccable創作聲明：本文部分內容由AI輔助生成（AIGC），僅供參考