把你的設定打包成新人能重播的上手指南

新同事進來，你把專案交給他，也把常駐檔交給他。一個月後你發現他用得比你慢很多，而且他不知道有些事根本不用手動做。

差在哪？常駐檔寫的是「這個專案的規矩」，沒有寫「這裡的人怎麼用 AI 做事」。哪些工作固定交給它、哪些絕對自己來、哪個技能是解哪個痛點做的、哪些指令你每天都在打。這些全在你腦子裡。

2026 年 4 月上旬，Claude Code 加了一個指令來擠這塊東西：/team-onboarding。它從你在這個專案裡的實際使用情況，產出一份給新同事的上手指南，讓對方可以照著重播你的設定，而不是從預設值重新摸索。

常駐檔講的                  上手指南講的
專案的規矩與架構            這裡的人怎麼用它做事
AI 每次開場要知道的         新人第一週要知道的
不會過期的長期規則          你的習慣與踩過的坑

為什麼要在你最熟的專案跑

官方的說明很短，但有一句話是重點：在一個你花過真功夫的專案裡跑。因為它產的是從你的使用紀錄推出來的東西，不是從程式碼推出來的。你在這個專案只做過兩天，它就沒什麼可以萃取。

我實際跑過之後的感想是，它最有價值的部分不是技術細節，是那些「原來我一直這樣做」的東西。人交接的時候會漏掉自己的習慣，因為習慣對自己來說是不用說的。

不過它產的是草稿，不是成品。你得自己補三件事：為什麼當初這樣設定、哪些事這裡絕對不能交給 AI、以及出事的時候找誰。這三件永遠不會在使用紀錄裡。

沒有這個指令的人怎麼做

用不到這個工具的團隊，這一塊照樣要交接，只是改成人工。我的做法是一份一頁的清單，五個欄位：

第一，固定交給 AI 的工作有哪些，各自的交辦範本放在哪。第二，絕對不交給 AI 的有哪些，為什麼。第三，我們有哪些常駐規則、技能或提示詞資產，各解哪個問題。第四，踩過的坑：哪些事它做不好、哪一次出過包、後來怎麼防的。第五，出事找誰、要保留什麼紀錄。

這一頁的重點在第四欄。新人最需要的不是「怎麼用」，是「別人已經撞過哪面牆」。

動手做

在你最熟的那個專案裡打一次，先看它抓到什麼：

/team-onboarding

拿到草稿之後，用這段把它補成真的能交接的東西：

下面是從我的使用紀錄產出的上手指南草稿。請幫我把它改寫成一份給新同事的一頁文件，
補上草稿裡一定沒有的部分，缺的地方直接標「待補：」讓我填：
1. 每一項設定「為什麼這樣設」的一句話理由。
2. 這個專案絕對不交給 AI 的工作，以及理由。
3. 我們踩過的坑：曾經出錯的事、現在怎麼防。
4. 出事的時候找誰、要保留什麼紀錄。
5. 新人第一週的三個練習任務，由淺到深。
語氣平實、繁體中文，不要條列超過五層，不要 emoji。
草稿：（貼上）

做對了的樣子：你們的交接文件裡有一欄是「踩過的坑」；新人第一週有三個指定練習，不是「你先熟悉一下」；這份東西跟常駐檔分開放，因為它會隨著人換而改，常駐檔不會。

站內延伸

• 常駐檔該寫什麼、不該寫什麼 → 專案的長期記憶
• AI 猜不到的那些默會知識 → 砍完之後該加什麼
• 新人上手包的完整做法 → 找方法AI 新人上手包

來源： Claude Code：Slash commands（/team-onboarding 指令說明）；Claude Code：週報 2026-w15（2026 年 4 月上旬、v2.1.101；從本機使用情況產出上手指南，建議在熟悉的專案執行，供新同事重播你的設定）。

常駐檔交接的是專案的規矩，交接不了的是你這個人怎麼用它。現在有指令能從使用紀錄把那份習慣萃出來，但它產的是草稿：為什麼這樣設、什麼絕對不能交給 AI、出事找誰，這三件要你自己補。沒有工具的話，用一頁五欄的清單也做得到，重點在「踩過的坑」那一欄。