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

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

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

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

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

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

它抓得到的，多半是那些你每天在做、卻從來沒寫下來的習慣，像固定先叫它讀哪個檔、哪個指令每天都在打。這類東西交接時最容易漏，因為做的人自己不會想到要講。

它產的是草稿，有三件事你得自己補：當初為什麼這樣設定、哪些事這裡絕對不能交給 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；從本機使用情況產出上手指南，建議在熟悉的專案執行，供新同事重播你的設定）。