跳到文件正文
oh-my-design
問題排解

排除問題

遇到問題時,先確認下一步

先執行 doctor。它會依工具檢查技能、代理角色、參考目錄與專案啟用狀態,不會因為找到一個檔案就判定安裝正常。

先執行一次診斷

CI 使用 JSON 輸出;給使用者看的報告可以直接貼給 AI 程式助理。degraded 狀態會回傳非零結束碼。

npx oh-my-design-cli@latest doctor
npx oh-my-design-cli@latest doctor --json

安裝後看不到技能

重新啟動 AI 程式助理,再執行 doctor。

doctor 回報參考目錄缺失

針對正確工具重新執行最新版安裝程式。

AI 程式助理表示沒有設計脈絡

請它建立專案設計系統,並在寫入 DESIGN.md 前確認方案。

想保留的行為也被改寫

只還原相關變更,明確說明要保護的行為,並用 omd:remember 記錄修正。

參考中出現沒有依據的字型或元件

只移除未解決欄位或空群組,不用系統字型或通用元件冒充品牌事實。