多檔安全重構指令：先盤影響範圍，再分批改，每批可獨立驗證
給 agent 的大型重構作戰手冊：先唯讀盤點『影響範圍 / blast radius』（哪些檔案、呼叫點、測試會受影響），再把改動切成多個小批次，每批保持行為不變、各自跑測試、各自一個原子 commit。拒絕「一次改 40 個檔案然後 build 紅了不知從何救起」。
01PROMPT
大型重構最怕 agent 一口氣改幾十個檔案、最後 build 全紅、根本不知道哪一步壞的。
這支指令逼它：① 先唯讀盤出完整影響範圍 ② 切成小批、每批行為不變 ③ 每批各自跑測試 + 各自一個原子 commit，壞了能精準回退。
[ 登入後可看完整內容 ]02CONTEXT / 使用情境
適用情境：跨多檔的結構性重構（搬移模組、改命名慣例、抽共用邏輯、換掉某個 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 內 4 個方括號 [變數] 換成你自己的內容，貼進 Claude Code / Codex 執行即可。屬進階用法，建議熟悉工具後再依需求微調參數。
「多檔安全重構指令：先盤影響範圍，再分批改，每批可獨立驗證」是免費的嗎？
這組是 Pro 會員內容。免費帳號可看預覽與使用情境；訂閱 Pro 後解鎖完整 prompt、變數表與工具參數。退款條件依退款政策處理。
用 Claude Code / Codex 依這組 prompt 生成的成果可以商用嗎？
prompt 文字本身你可自由使用與修改。但 AI 生成物（圖／音樂／影片／文字）的商用授權，取決於你在 Claude Code / Codex 使用的方案與其官方服務條款，請以該工具的授權規範為準。
RELATED你可能也需要
Suno 工程師思維：4 步驟做出不像 AI 的歌
Studio engineer 視角拆解 Suno 致命弱點（油炸 vocals、高頻 artifact）+ 4 步驟 DAW workflow + Suno Studio 修音 prompt
5 個 6 月 stuck 下來的 Claude 每週 workflow
提案產生器 / 會議處理器 / 內容再利用 / 週五回顧 / 收工 reset — 試了 40 個只有這 5 個沒被丟掉、各省 30+ 分鐘 / 次。
7 個跨 model A/B 測過的 prompt 技巧（不是 vibes）
六個月在 Claude / GPT-4 / Gemini 上用人工 rater A/B 測 200+ prompt 後寫的。包含 persona+constraint stacking / anti-example / role reversal QA / cognitive scaffold / emotional priming / uncertainty CoT / steelman first。
5 個信任檢查單行 prompt（沒有 role-play）
一年的 role-play system prompt + 14-step framework 後總結：真正改變品質的是 5 個單行 prompt。沒有 role、沒有 markdown、沒有「you are an expert」。
EMBED · 嵌入 blog / Note一行 iframe HTML、貼進文章即顯示此 prompt 卡片+
適合：部落格、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>