# AGENTS.md — temp_workspace 操作規則（範本）

先讀 `DESIGN.md`（一件工作一個子目錄；狀態在各子目錄的 README）。跨專案守則依 root `~/projects/AGENTS.md`。

## 開工

1. **新工作就開新子目錄** `YYYY-MM-DD-<短名>/`（日期＝今天 `date +%F`，短名用使用者給的名字，沒給就用簡短描述），輸入、腳本、輸出都放裡面。讀完使用者給的檔案（zip、腳本、資料）就直接開始做，不必先問要不要建文件。
2. **只看自己那個子目錄**。別的子目錄是已結案的工作：搜尋、grep、find 一律限定在當前子目錄，不改別的子目錄、不把輸出寫進去；除非使用者明確說「去查之前的某某東西」。理由：舊工作互不相干，掃全部只會撈到無關的檔。
3. 暫存檔（中間結果、測試腳本、venv）放 `/tmp`，不留在子目錄；留下的要能重跑。
4. 做完在子目錄留 `README.md`：任務一句話、產出（檔案與交付去處）、怎麼做的／怎麼重跑、坑；沒收的尾巴寫「待辦」。根目錄不放任何工作檔。

## 交付給使用者

依「誰要看」選管道，在子目錄 README 記交付去處：

- **只給使用者自己看**：`<你的預設交付方式>`（例：上傳雲端硬碟的固定資料夾、或放到只有自己 VPN 內看得到的網頁；見 INFRA.md）。
- **要公開到 internet 的**（例：分享給朋友的介紹頁）走靜態網站服務（INFRA.md 情境 E），README 記專案名與「不要了怎麼刪」。公開前檢查個資與秘密。

## 常見工具的坑（累積用，寫你自己踩到的）

- 系統 pip 被 PEP 668 鎖住，要裝套件就開 venv。
- `<例：某工具沒裝、替代方案是什麼>`