臨時資料夾管理

核心原則

當 AI Agent 需要建立任何臨時、非專案正式所需的檔案時，必須：

1. 配置偵測：優先檢查專案文件（如 SPEC.md, AGENTS.md, CLAUDE.md, .agents.md 或 rules）是否定義了暫存資料夾的指示。若有定義，則使用該路徑；若無，則預設使用 .ai 資料夾。
2. 建立暫存資料夾：在指定的路徑建立資料夾（如果不存在）。
3. 確保忽略：確保暫存路徑已加入 .gitignore（如果 .git 存在，且追加時確保路徑獨立佔據新的一行）。
4. 強制分類：將所有臨時檔案放在暫存資料夾內的專屬子資料夾中（依任務或用途命名），避免檔案混亂。
5. 主動清理：任務完成或不再需要時，主動刪除相關的臨時子資料夾。

操作流程

1. 偵測並建立暫存資料夾

請根據專案配置或指令，確定暫存目錄路徑（以下稱為 $TEMP_DIR）。

# 預設使用 .ai，或依據配置使用自定義路徑
mkdir -p $TEMP_DIR/<用途名稱>

2. 更新 .gitignore

如果 .gitignore 存在，檢查是否已包含 $TEMP_DIR/。若無，追加（請注意若檔案結尾無換行，需先補上換行符號）：

<TEMP_DIR>/

3. 使用專屬子資料夾

將所有臨時檔案存放於 $TEMP_DIR/<用途名稱>/ 目錄下，例如：

• 測試腳本放 $TEMP_DIR/unit-tests/
• 生成的程式碼草稿放 $TEMP_DIR/drafts/
• 除錯輸出日誌放 $TEMP_DIR/debug-logs/

4. 任務完成後的清理

當除錯、測試或其他臨時操作結束，且確認產出的草稿或日誌不再被需要時，必須主動將建立的子資料夾刪除，以保持專案乾淨：

rm -rf $TEMP_DIR/<用途名稱>

（Tip：若是 $TEMP_DIR 底下已無任何其他目錄，也可以一併移除整個 $TEMP_DIR 資料夾。）

範例情境

• 指定自定義目錄：在 AGENTS.md 中加入 temp_folder: .tmp/ai。AI Agent 偵測後會將檔案放在 .tmp/ai/ 並忽略之。
• 無配置時：AI Agent 預設使用 .ai/。
• 日常任務："幫我寫個測試" → 測試檔放 $TEMP_DIR/unit-tests/test_*.js，測試通過且確定不需要保留後清理。
• 測試功能："產生一個範例網頁" → 範例放 $TEMP_DIR/examples/，供使用者預覽，不須馬上刪除。
• 修復 Bug："幫我 debug" → 輸出日誌放 $TEMP_DIR/debug-logs/debug.log，問題修復完成後執行 rm -rf $TEMP_DIR/debug-logs。