在使用 AI Agent時，我們經常需要編輯 .md 格式的指令文件。但你有沒有遇過一種狀況：想在檔案裡留下一段筆記或舊指令，卻又不希望 AI 真的去執行它？
agent.md 中有效「註解」與「停用內容」的實作方法。一、 基礎語法：HTML 註解標籤
這是最標準的 Markdown 註解方式。雖然在一般的閱讀器（如 GitHub 或 VS Code 預覽）中看不見，但能保留在原始碼中。
- 單行註解： ``
- 多行註解： ```markdown
注意： 有些精明的 AI 模型在預處理時仍會讀取到 HTML 註解內的文字。如果你希望 AI 「絕對不要執行」，建議搭配後續的方法。
二、 明確標註：Internal Note 寫法
如果你希望這段文字是寫給「人類開發者」看的，或者是為了提醒 AI 某種邏輯邊界，可以使用 (Internal Note: ...)。這種寫法能讓 AI 意識到這是一段「元指令（Meta-instruction）」，而非要執行的任務。
應用範例
- 邏輯說明：
規則： 必須檢查變數命名。 (Internal Note: 此規則是為了符合 2026 年新制定的規範，若使用者要求使用舊版，請委婉拒絕。)
- 開發階段標註：
輸出格式： 請統一使用 JSON。 (Internal Note: 目前正在測試 XML 相容性，若 JSON 穩定，下週將移除此備註。)
- 處理邊界案例：
語氣指南： 保持專業。 (Internal Note: 若使用者開始謾罵，請觸發安全防禦機制，不要與其爭辯。)
三、 進階技巧：如何徹底停用指令
當你希望某段指令留在檔案中備份，但要 AI 完全無視它時，請使用「物理隔離」的概念：
1. 使用代碼塊 (Code Block) 包裹
利用 Markdown 的代碼塊將指令包起來，並在上方標註已停用。這是最推薦的方法，因為格式的改變會讓 AI 意識到這只是「文本資料」而非「執行邏輯」。
[DISABLED] 以下區塊已停用
(Internal Note: 此段邏輯因 API 遷移暫時停用，請 Agent 務必無視以下內容)
### 執行指令
1. 每日早上 9 點發送天氣預報。
2. 自動彙整當日新聞。
---
### [DISABLED / DEPRECATED] 以下區塊已停用，請勿執行
> **(Internal Note: 此段邏輯因 API 遷移暫時停用，Agent 請無視以下所有內容)**
> ```markdown
> 3. 自動同步資料至舊版資料庫。
> 4. 偵測特定關鍵字並自動回覆。
> ```
---
2. 建立「封存指令」區塊
將不再使用的內容移至檔案末尾，並明確劃分邊界。
封存指令 (Archived / Reference Only)
(Internal Note: 以下內容僅供開發者參考，Agent 嚴禁讀取或執行以下邏輯)
## 指令集 (Active)
- 任務 A
- 任務 B
## 封存指令 (Archived / Reference Only)
**(Internal Note: 以下內容僅供開發者參考備份，Agent 嚴禁讀取或執行以下邏輯)**
- [已廢棄] 任務 C
- [已廢棄] 任務 D
結語：為什麼不能只靠傳統註解？
- 防止指令注入：AI 有時會過度解讀註解內容，若註解中包含敏感指令，可能導致非預期的行為。
- 降低干擾：明確標註 [DISABLED] 或 [DEPRECATED] 能讓 AI 在推導時自動過濾雜訊，大幅提高任務執行的準確度。
最保險的做法依然是：不再需要的指令就直接刪除。但若必須保留，請務必使用「代碼塊包裹」加上「明確否定」的標註，才能確保你的 AI Agent 乖乖聽話！
