給 agent 的大型重構作戰手冊:先唯讀盤點『影響範圍 / blast radius』(哪些檔案、呼叫點、測試會受影響),再把改動切成多個小批次,每批保持行為不變、各自跑測試、各自一個原子 commit。拒絕「一次改 40 個檔案然後 build 紅了不知從何救起」。
大型重構最怕 agent 一口氣改幾十個檔案、最後 build 全紅、根本不知道哪一步壞的。
這支指令逼它:① 先唯讀盤出完整影響範圍 ② 切成小批、每批行為不變 ③ 每批各自跑測試 + 各自一個原子 commit,壞了能精準回退。
[ 登入後可看完整內容 ]適用情境:跨多檔的結構性重構(搬移模組、改命名慣例、抽共用邏輯、換掉某個 API 的所有呼叫點)。為什麼有效:① 強制『先唯讀盤 blast radius 再動手』,這是專業重構的核心紀律,避免 agent 漏掉呼叫點導致 build 紅;② 分批 + 每批保持『可編譯、測試綠、可單獨 commit』,壞掉時能精準二分定位,而不是面對一坨改動束手無策;③ 原子 commit、不混 refactor 與行為變更,讓 PR review 變快、出事好回退;④ 明確禁止『順手改不相干程式碼 / 改不該動的格式』,把 diff 控制在最小可審範圍。技巧:搭配 Claude Code 的 plan mode(Shift+Tab 兩下)或 Codex 的 read-only sandbox 跑 Phase 1,效果最好;VERIFY_COMMAND 填你能一鍵驗證的指令。所有提到的能力(read-only 探索 / plan mode / 分批 commit)都是真實工作流。
## Phase 1 — Blast radius Direct targets: src/api/*.ts 裡 11 處裸 fetch() Call sites & ripple: 23 個元件/hook import 這些函式(清單附檔名) Tests covering: api.test.ts(8 例)+ 4 個元件測試 = 安全網;profile 流程無測試 → 已標記 Risk hotspots: auth header 注入、401 重導邏輯(行為必須完全保留) Batch plan: - Batch 1/4:新增 apiClient(不改任何呼叫點)— 加法、零風險 - Batch 2/4:搬 read-only GET 端點 → apiClient - Batch 3/4:搬含 auth 的 POST/PUT(高風險批,逐一比對 header) - Batch 4/4:刪除舊裸 fetch + 死碼 每批結束:編譯通過、測試綠、單一 commit。 → 等你核准計畫,我再開始 Phase 2。
以上為此 Prompt 丟進 Claude Code / Codex 後可得到的描述性成果,實際畫面會因填入的變數而有差異。
這組 prompt 專為 Claude Code / Codex 設計。把 prompt 內 4 個方括號 [變數] 換成你自己的內容,貼進 Claude Code / Codex 執行即可。屬進階用法,建議熟悉工具後再依需求微調參數。
完整 prompt 免費。註冊並登入 PromptCraft 帳號即可複製、收藏與留言,不需付費。
prompt 文字本身你可自由使用與修改。但 AI 生成物(圖/音樂/影片/文字)的商用授權,取決於你在 Claude Code / Codex 使用的方案與其官方服務條款,請以該工具的授權規範為準。
Studio engineer 視角拆解 Suno 致命弱點(油炸 vocals、高頻 artifact)+ 4 步驟 DAW workflow + Suno Studio 修音 prompt
提案產生器 / 會議處理器 / 內容再利用 / 週五回顧 / 收工 reset — 試了 40 個只有這 5 個沒被丟掉、各省 30+ 分鐘 / 次。
適合:部落格、Medium、Notion 公開頁、Substack — 任何支援 iframe / HTML 嵌入的地方。對方點「看完整」會回到本站、是 prompt 庫的免費 backlink。
<iframe src="https://prompt.luvai.net/embed/agent-multi-file-safe-refactor-batched" width="100%" height="380" frameborder="0" style="border:1px solid #e0dcd0;border-radius:4px;" loading="lazy" title="PromptCraft Embed"></iframe>