Claude Code /insights 報告怎麼用?搭配指令整理規則與權限

拿到 /insights 報告後,可以先挑一個最近一直遇到的問題:需求常被誤解,或每次工作都卡在相同的權限確認。找到對應紀錄,再決定要改專案規則、權限設定,還是工作流程。

下面整理幾種具體做法與可以搭配的指令,依官方文件設計,尚未以個人報告實測。範例提示詞可以直接改來用,並非實際對話紀錄。

先產生報告,挑一個問題處理

/insights 要在自己電腦上的 Claude Code 使用,不支援雲端對話。開啟對話後輸入:

/insights

報告預設儲存在 ~/.claude/usage-data/report.html。

接著明確請 Claude 讀取報告,不要假設下一個指令會自動承接內容:

請讀取 ~/.claude/usage-data/report.html,找出一個反覆發生、最值得先改善的問題。
列出報告中的依據,以及還需要核對哪些原始對話。
先給建議,不要改檔案或設定;如果沒有足夠資料,就直接說明。

如果需要核對當時怎麼交代任務,可以用 /resume 找到並開啟那次對話,再用 /export 匯出。把匯出的檔案路徑交給 Claude,請它對照報告;找不到對話時,就先把原因留作待確認,不急著改設定。官方指令說明

做到這裡,先選定一個問題就好。後面的做法依問題選用,不必把所有指令都跑過一遍。

需求常被誤解:先查規則,再用 /memory 整理

假設報告提到,Claude 多次把「只做審查」理解成「直接修改」。先核對原始對話,確認當時的要求確實清楚,再檢查專案裡是否有相反的指示。

在 Claude Code 對話執行:

/doctor prompt-audit

這個指令會檢查 CLAUDE.md、Skills 等設定裡過期或互相衝突的指示。拿到結果後,可以把範圍限縮到剛才選定的問題:

請對照剛才的 insights 報告和這次 prompt-audit 結果,
只處理「要求審查卻直接改檔」的問題。
指出相關規則在哪個檔案,提出最小修改,先用 diff 給我看。

確認修改內容後,再用 /memory 開啟並整理對應的 CLAUDE.md。如果原本已經有「審查時不修改檔案」,就先找出衝突來源,避免再加一條意思相同的規則。

/memory 也能查看自動記憶。如果找不到文中的指令,可以先更新 Claude Code,再對照官方指令說明。

權限反覆卡住:用 /permissions 看原因

auto mode 會讓 Claude 判斷操作風險,自動處理部分權限請求。如果報告提到權限確認太頻繁,可以先檢查規則:

/permissions

查看目前哪些操作允許執行、需要詢問或禁止執行。已在使用 auto mode 的人,也可以查看最近的拒絕紀錄。例如,某個測試指令一直需要確認,就先核對實際指令與規則是否相符;若是自己刻意保留的推送確認,就保留這個步驟。

insights 報告中的 auto mode 建議,會估算近期有多少權限提示可由 auto mode 處理。這個數字可以幫忙選擇要檢查的地方,但不是下次一定能少按幾次確認的保證。官方更新說明。

進階選讀:內部服務一直被 auto mode 擋住

這一段適合已經使用 auto mode,而且公司內部服務反覆被擋的人;沒有遇到這個問題可以跳過。如果拒絕紀錄顯示,Claude 不認得工作需要使用的內部服務,可以執行:

/auto-mode-setup

Claude 會依專案與近期操作草擬環境設定,協助 auto mode 辨識工作需要使用的服務。看到草稿時,核對列出的服務與網址是否確實需要,再決定是否接受。接受後會寫入使用者設定 ~/.claude/settings.json,也會影響之後的工作。

這個指令支援 Pro、Max、Team;其他使用條件與設定細節可以看官方設定流程。

同樣的要求一直重講:整理成 Skill 或開發待辦

如果報告與原始對話都顯示,你每次審查程式碼都要補充「讀完整 diff、只回報能確認的問題、附上檔案位置」,就可以把這些共同要求整理成 Skill 草稿。

在一般對話中提出需求即可:

請參考這份 insights 報告,以及我指定的幾次程式碼審查對話,
整理每次都要重複交代的要求,先列給我確認。
把只適用單一專案的規則分開,缺少依據的要求不要補上。
確認後再整理成只能手動叫用的 Skill 草稿。

先拿幾次新任務試用,再看是否仍要補充相同要求。手動叫用的設定方式可以參考讓 Skill 只在手動指定時執行。

有些問題適合直接補專案文件。例如 Claude 一再找不到測試指令,可以先核對文件中的指令是否正確,而不是立刻新增 Skill。需要留待之後處理時,可以請它草擬一則 GitHub Issue,包含報告依據、要補的內容與驗收方式,確認後再建立。

改完後,確認相同問題有沒有再出現

一次先改一件事,例如整理審查規則,或調整某個內部服務的環境設定。記下修改日期、模型與任務類型,接下來做幾次相似工作,再看原本的問題是否重現。

想順便觀察用量,可以在 Claude Code 對話輸入 /usage。只想確認原問題是否改善的話,可以跳過這一步。

/usage

它能查看對話成本、方案用量與活動統計,但用量變少不能直接證明工作流程改善;其中對話成本的美元數字也不等於訂閱方案的實際帳單。官方用量說明。

累積一些新任務後,再跑 /insights,把前後兩份報告交給 Claude 比較。報告只涵蓋各自電腦上的紀錄,工作難度與分析樣本也可能不同,最好指定比較範圍:

請比較這兩份 insights 報告,只看程式碼審查相關的問題。
這段期間我調整了「審查時不直接改檔」的規則。
請找出這個問題是否仍然出現,列出依據與無法判斷的部分。
不要把任務變少或模型更換造成的差異,直接算成規則調整的效果。

把修改前的報告另存一份,連同改過的規則一起保留。下一次再遇到相同問題,就能回頭確認當時改了什麼,以及哪個情境還沒處理到。

查看提示詞
請根據我的 Claude Code /insights 報告,協助改善日常工作流程。
報告路徑:~/.claude/usage-data/report.html(若我另有提供路徑,以該路徑為準)。

先讀報告,只找一個最值得改善的問題,簡單說明報告中的依據,再建議一個我可以做的下一步。

若檔案不存在,請提醒我先執行 /insights 並提供路徑。若需要原始對話才能判斷,請告訴我要補哪段內容,先不要猜原因。

等我確認要處理這個問題,再帶我操作需要的指令,一次一步。需要斜線指令時,請讓我在 Claude Code 對話中執行,不要當成 shell 指令。

這一輪只給分析與建議,不要修改檔案、權限或建立 Issue。

聊聊你的想法

有不同的做法,或遇到相似的問題?歡迎一起討論。

Email 不會公開,其他讀者看不到;僅用於回覆通知,可隨時取消。

免登入 · 送出後直接公開

留言與討論

正在載入留言…