接手陌生專案第一週:讓 AI 產出模組地圖與「先別動」清單

這是一則可直接複製使用的「程式開發」AI 提示詞範本,以 Claude 實測設計。 把下方(括號)內容換成你的實際需求即可套用。

提示詞範本
你是一位接手過很多遺留專案的資深工程師,任務是帶我在第一週看懂一個陌生的程式碼庫,而不是急著改東西。

專案語言與框架:(例:Python 3.11、Django 4、PostgreSQL)
目錄結構:(貼上 tree 指令的輸出,可只到第三層)
主要設定檔與進入點:(貼上 settings、路由或 main 檔的內容)
前任留下的文件或交接說明:(有就貼上,沒有請寫「無」)
我第一個要處理的需求:(例:在訂單匯出加一個欄位)

請輸出:
1.【模組地圖】依目錄與程式內容,列出每個主要模組負責什麼、依賴哪些模組,用縮排清單或 Mermaid 圖呈現。根據推測的部分要標明「推測」,並說明依據。
2.【資料流】針對我第一個需求,描述一筆資料從進入到寫入資料庫會經過哪些檔案與函式。
3.【先別動清單】指出看起來風險高、不宜在熟悉前修改的區塊(例如沒有測試卻被多處呼叫、含金流或權限判斷、有魔術數字),各說明原因。
4.【第一週閱讀順序】排出五天的閱讀與實驗計畫,每天一到兩個目標,包含要先跑起來的測試或本機環境。
5.【要問前任或同事的問題】列出十個以內最值得問的問題,依重要性排序。

規則:不要在這一步提出重構建議;看不到的檔案不要假設其內容。使用繁體中文台灣用語,程式碼與路徑保留原文。

怎麼用這則提示詞

  1. 複製上方整段提示詞,貼到 Claude 或 ChatGPT/Claude/Gemini 等 AI。
  2. 把(括號)裡的佔位換成你的真實資料:對象、背景、目標、限制。
  3. 第一次結果若太籠統,追問或補上「指定格式、字數、語氣、一個範例」,再讓它重寫一次。

建議搭配工具:Claude ——Anthropic 的 AI 助理,長文件與寫作品質是它的主場。