符合台灣
新人交接文件撰寫指令|讓接手的人一週內自己跑起來
一句話結論輸入系統架構、開發慣例與常見踩坑,AI 幫你產出結構完整的新人交接文件,讓新加入的工程師不需要一直問前輩,自己就能在一週內跑起來。
指令介紹
「我幫你講一遍就好」——每次有新人加入,資深工程師都要重複說同樣的東西,但這些「口耳相傳的知識」不寫下來,人一離職就消失了。好的交接文件不只是給新人看的,也是讓知識留在組織的方式。這組指令幫你把腦中的系統知識,整理成讓新人真正能靠自己上手的文件。
適用情境
新人交接技術文件知識管理工程師帶人
懶人貼上・複製就能用
已填好範例複製就能直接用
▸ 想換成你自己的內容?點開填一填選填
AI 指令庫編輯的話
編輯實測好的交接文件把「隱性知識」轉換成「顯性步驟」,包括不成文規定和「要向誰要什麼」這種口耳相傳的細節;Day 1-5 學習路徑讓新人有結構地吸收,不會因為資訊量太大而不知道從哪開始。 這組「新人交接文件撰寫指令|讓接手的人一週內自己跑起來」是 Prompts 編輯團隊實測整理的職場 AI 指令(Prompt),適合用 ChatGPT、Claude 執行,特別適合「0」等台灣在地場景。複製上方指令範本即可使用,免費、免註冊。
模型實測對照
# OrderHub 新人交接文件
## 系統一頁速覽
OrderHub 是公司內部的訂單管理中樞,整合蝦皮、Shopify、91App 的訂單資料,讓客服和出貨團隊在一個介面處理所有訂單,每天約處理 2 萬筆交易。
## 第一週行程建議
- **Day 1**:設定開發環境、跑起來 local,讀這份文件
- **Day 2**:讀懂 API Server 的 router 結構,跑一次訂單同步流程
- **Day 3**:了解 BullMQ Worker 的 Job 類型,在 local 觸發一次 Email Job
- **Day 4**:看 Admin 前端的 Next.js 架構,改一個小 UI 並提 PR
- **Day 5**:和 TL 做第一次 1-on-1,確認理解方向
## 開發環境設定
```bash
git clone git@github.com:company/orderhub.git
cd orderhub && npm install
cp .env.example .env # 向 TL 索取真實的 API key
# 重要:確認 TZ=Asia/Taipei
echo 'TZ=Asia/Taipei' >> .env
npm run dev
```
## 常見踩坑 FAQ
**Q:訂單時間顯示差 8 小時?**
→ .env 加上 `TZ=Asia/Taipei`,重啟 server
**Q:staging webhook 收不到?**
→ 用 ngrok 建 tunnel,把網址更新到 Shopify admin webhook 設定
實測(ChatGPT):Day 1-5 學習路徑讓新人有明確節奏而非自己摸索,踩坑 FAQ 直接回答最常見的卡住點,開發環境指令加上「TZ=Asia/Taipei」這種細節才是新人真正需要的。
產出完整新人交接文件:系統一頁速覽、Day 1-5 學習路徑、含 TZ 時區設定的開發環境指令序列、架構文字描述(三服務職責)、五題踩坑 FAQ(含 ngrok webhook 問題),語氣友善如資深同事寫給新人。
實測(Claude):把「向 TL 索取 .env」這種隱性步驟也寫進指令序列,讓新人的第一天不會卡在「我不知道我不知道什麼」的困境。
為這個指令評分
常見問題
如果是交接給離職前的繼任者,文件重點跟新人交接一樣嗎?
不一樣。繼任者交接應著重「未完成的任務清單、已知的 bug 與技術債、正在進行的溝通與決策」,在 gotchas 欄位加上「這是離職交接,請特別標注 WIP 項目和未解決的問題」。
如果系統太複雜,一份文件寫不完,怎麼辦?
建議先用這組指令產出「骨架文件」,再分別對每個章節(架構/開發慣例/FAQ)再丟一次指令做深度擴充,分而治之比試圖一次寫完更實際。
相關指令
猜你喜歡
每週 5 組最新台灣 AI 指令,寄到你信箱
免費訂閱電子報,第一時間收到新指令與實測心得;現在訂閱立即領取「50 組必備 AI 指令懶人包」。
訂閱成功!懶人包連結已寄到你的信箱,請收信。
不寄垃圾信,隨時可取消訂閱。