# 專案式 AI Agent 全域指令

*Adam's AI Instructions*

[English](README.en.md) · [繁中完整全域指令](prompts/02-claude-code-meta-instruction/prompt.md) · [中文使用指南](prompts/02-claude-code-meta-instruction/guide.html) · [English complete instruction](prompts/02-claude-code-meta-instruction/prompt.en.md) · [English guide](prompts/02-claude-code-meta-instruction/guide.en.html)

當 AI 可以進入你的專案或工作區，讀檔、改檔、執行工具，甚至準備發佈內容，問題不再只是它答得好不好。你需要知道它看過甚麼、為何這樣做，以及完成後怎樣核對。

這份**完整全域指令**是給這類 AI Agent 的工作守則。把它放進你已授權的專案或工作區後，AI 會先理解眼前任務和已有規則，再開始工作；小事直接做好，牽涉資料、機密、發佈或多處互相影響時，會把風險、結果和核對方法講清楚。

它適合 Claude Code、OpenAI Codex、Cursor、Antigravity，以及其他能在授權工作區內持續工作的 AI Agent。一般網頁版聊天工具不在本專案的使用範圍內。

## 裝上後，你會看到甚麼不同

例如你叫 AI 改一份 README，它不會一看題目就改。它會先找現有寫法、相關規則和可讀回的結果，再只改需要改的地方。

如果你要它處理研究、資料整理或準備發佈，它會分開已核實的事實、仍未確定的內容和真正需要你決定的選擇。刪除、覆寫、公開發佈、權限和費用，仍然由你最後確認。

這不是要把每件小事做成流程。清楚而可回復的小修可以直接完成；真正容易出錯或影響較大的工作，才需要多一層核對。

## 開始使用

1. 先在你的 AI 工具中開啟正確的專案或工作區。不要一開始就讓它看到不相干的個人資料夾。
2. 選擇你要的回覆語言，然後複製一份完整指令： [繁中完整全域指令](prompts/02-claude-code-meta-instruction/prompt.md) 或 [English complete instruction](prompts/02-claude-code-meta-instruction/prompt.en.md)。它就是要長期套用給 AI Agent 的全域工作規則，不是範例文字。
3. 把全文放進該工具為這個專案或工作區長期套用的指令／規則位置，儲存後開一個新任務。
4. 先用一件小而真實的工作試它，例如：「先讀這個專案的規則與測試方式，再修正 README 的一處錯字並讀回核對。」

常見工具裡，這個位置通常叫做：

| 工具 | 專案長期指令的位置 |
|---|---|
| Claude Code | `CLAUDE.md` |
| OpenAI Codex | `AGENTS.md` |
| Cursor | `AGENTS.md` 或 Project Rules |
| Antigravity | Workspace Rule |

如果你想先看 AI 在四個常見情境下會怎樣回應，可直接看[中文使用指南](prompts/02-claude-code-meta-instruction/guide.html)或 [English guide](prompts/02-claude-code-meta-instruction/guide.en.html)。

## 這份指令守住甚麼

- AI 改動前，先讀與任務有關的規則、檔案和直接上下文。
- 做研究時，分清來源、日期、事實、推論和未核實內容。
- 寫入資料後，讀回核對；不知道安全交付位置時，不會自作主張建立一套平行結構。
- 重要計劃會說明成功怎樣證明、失敗後留下甚麼狀態，以及怎樣恢復。
- 真正缺少核心資料或安全條件時，AI 會直接說明受阻，而不是交給你一份看似完整、其實不能安全採用的計劃。

## 它不會代你決定的事

這份指令不會取代工具本身的權限、沙盒、版本控制或備份，也不會把有一份 prompt 說成系統已經安全。

公開發佈、付款、推送、刪除、權限變更和其他不可逆操作，仍要由你清楚確認。它的作用是讓 AI 在你作決定前，把事情看得更清楚。

## 最新更新：v0.8.3

當 AI 暫時不能安全開始時，它會更清楚說明原因、已核實的範圍和可行的下一步；重要工作仍先查漏，小事保持直接。[了解這版改動](docs/releases/v0.8.3.md)

## 更多資料

- [繁中使用說明](prompts/02-claude-code-meta-instruction/README.md)
- [English overview](prompts/02-claude-code-meta-instruction/README.en.md)
- [中文互動指南](prompts/02-claude-code-meta-instruction/guide.html)
- [English interactive guide](prompts/02-claude-code-meta-instruction/guide.en.html)
- [更新紀錄](CHANGELOG.md)

## 延伸閱讀：Agent Handoff Kit 與 Innovation Loop

這份指令本身已可單獨使用，負責 AI 在這一輪工作怎樣判斷、修改和核對。

如你的工作會跨很多次對話或換不同 Agent，可加用 [Agent Handoff Kit](https://adamchanadam.github.io/agent-handoff-kit/agent-handoff-kit-intro.html)，保存目前狀態、交接和收工資訊。長項目需要由想法走到研究、驗證和計劃時，可再了解 [Innovation Loop](https://github.com/Adamchanadam/agent-handoff-innovation-loop)。它們是按需要加入的延伸工具，不是開始使用這份指令的前提。

## 授權與回饋

本專案採 [MIT License](LICENSE)。如果實際使用情況和指南不同，歡迎回報工具名稱、指令放置位置和可重現情境；請不要貼出機密或私人檔案內容。