技能包

Karpathy 指南:用一份 CLAUDE.md 讓 Claude Code 先謹慎再改程式

適合要減少 Claude Code 常見編碼陷阱的人,但指南偏向謹慎而非速度,簡單拼寫或單行修改不必走滿全套。

官方來源 · andrej-karpathy-skills

安裝

/plugin marketplace add forrestchang/andrej-karpathy-skills
/plugin install andrej-karpathy-skills@karpathy-skills

適合誰

如果你主要在 Claude Code 裡改倉庫,並且希望它少踩那些 LLM 常見的編碼坑,這份材料更合適。它就是一份 CLAUDE.md,用來改善 Claude Code 的行為,來源是 Andrej Karpathy 對 LLM 編碼陷阱的觀察:

https://x.com/karpathy/status/2015883857489522876

頁面寫到:四條原則寫在同一個檔案裡,用來直接對應這些問題。可用頁面文字沒有列出這四條的名稱或正文,因此不要自行給它們起名,也不要編一套口號。你需要的是已經在用 Claude Code、並接受安裝外掛的人。只想讀貼文、不打算改本機 Claude Code 設定的人,看上面的連結即可。

3 分鐘完成第一次嘗試

官方建議安裝是連續兩步,缺一步都不算裝完。先在 Claude Code 裡執行:

/plugin marketplace add forrestchang/andrej-karpathy-skills

然後立刻安裝外掛:

/plugin install andrej-karpathy-skills@karpathy-skills

這會改 Claude Code 的外掛設定,不是唯讀查看。執行前確認目前就是你要寫入的 Claude Code 環境,並且兩步都做完。不要只加 marketplace 卻不 install。

裝好後先做一次對照,不要馬上大改倉庫。選一個非瑣碎的改動意圖,讓 Claude Code 先根據這份指南說明它打算怎麼改、會動哪些檔案,你點頭後再允許寫程式。成功訊號是:它表現出「謹慎優先於速度」,會先講清楚再動手,而不是直接鋪開大補丁。若它開始重構無關模組,先停下來。

使用案例

案例一:處理非瑣碎的編碼任務。指南存在的理由是改善 Claude Code 面對 LLM 編碼陷阱時的行為。把任務限定為「先對照 CLAUDE.md 再改」。可用頁面文字沒有寫這四條原則的標題,所以你不能要求它按某個自造原則名執行;你能要求的是:讀這一份檔案,再給出改動範圍。驗收看兩點:它讀的是這份指南,以及它先給出範圍而不是先改檔案。

案例二:判斷要不要上滿嚴謹流程。頁面寫明這些指南偏向謹慎而非速度;對瑣碎任務(簡單拼寫、一目了然的單行修改)要自己判斷,不是每次都上滿全套。當你只是改一個明顯錯字時,應明確告訴它「這是瑣碎修改,不要把流程鋪開」。它沒有定義「明顯」的自動規則,也沒有寫哪些檔案類型可以例外。因此邊界只能由你當場判定;Agent 若把改錯字升級成重構,就已經離開這個案例。

使用邊界

這是一份給 Claude Code 用的 CLAUDE.md,不是通用編輯器規則包。頁面沒有寫把它改名給其他產品使用的步驟。四條原則在同一個檔案裡,但可用頁面文字只停在「有四條、用來對應這些問題」,沒有原則清單。不要補名稱,也不要假裝已經引用了檔案裡的原句。

建議安裝就是上面的 marketplace add 再 plugin install。兩步都要做。不要再並列另一套安裝器。來源觀察在 Karpathy 的帖子裡;指南本身是衍生用法,不能代替那條帖子的上下文。

第一次停在「先說明再改」。任何超出目前任務的重構、批次重排或新加抽象,都要先讓它列出將改檔案和理由,你確認後再繼續。瑣碎修改則主動降級流程,避免為了一個拼寫走完整套。