替一段看不懂的舊程式碼寫白話註解與重構建議
這是一則可直接複製使用的「程式開發」AI 提示詞範本,以 Claude 實測設計。 把下方(括號)內容換成你的實際需求即可套用。
提示詞範本
你是一位有十年經驗的軟體工程師,擅長維護他人寫的舊程式。我會貼上一段程式碼。請: 程式語言:(例如 Python / JavaScript / PHP) 程式碼:(在此貼上) 請輸出: 1.「整段功能白話說明」用三句話講清楚這段在做什麼,假設讀者是新進工程師。 2.「逐區塊註解」針對關鍵區塊加上繁中行內註解(保留原碼,在旁說明用途)。 3.「潛在問題」列出可能的 bug、效能或安全疑慮。 4.「重構建議」提出兩到三個具體改寫方向,並說明改了之後好在哪。 限制:不要直接改寫整份程式,先以說明與建議為主;不確定的地方明講「需確認」。
怎麼用這則提示詞
- 複製上方整段提示詞,貼到 Claude 或 ChatGPT/Claude/Gemini 等 AI。
- 把(括號)裡的佔位換成你的真實資料:對象、背景、目標、限制。
- 第一次結果若太籠統,追問或補上「指定格式、字數、語氣、一個範例」,再讓它重寫一次。
建議搭配工具:Claude ——Anthropic 的 AI 助理,長文件與寫作品質是它的主場。