幫我把一段難讀的程式碼加上清楚註解與命名建議

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

提示詞範本
我接手一段沒人寫註解、變數命名也很隨便的程式碼,想把它整理得未來的人(包含我自己)看得懂。

程式語言:()
這段程式碼大概在做什麼(我目前的猜測):()
程式碼:
(貼上來)

請幫我:
1. 用白話一段話總結這段程式碼實際在做什麼
2. 在不改變邏輯的前提下,加上重點處的繁體中文註解(只註解會讓人困惑的地方,不要每行都註)
3. 列出命名不清楚的變數/函式,並給更達意的命名建議,做成對照表
4. 指出有沒有看起來可能藏 bug 或之後會難維護的地方,各給一句說明。

怎麼用這則提示詞

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

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