AI 開發：先看這頁

直接開 Claude Code 或 Codex 就能工作，不必先安裝 RTK，也沒有專案初始化腳本或 AI 專用腳本。 Claude 讀 CLAUDE.md；Codex 由 AGENTS.md 讀同一份規則。 兩者都先查 文件索引，再讀本次修改需要的章節，不先讀全庫。 建置與測試照 開發文件 跑原本的腳本。

輸出分工

執行前先決定這一輪需要「概覽、定位、原文或驗證」，再選命令；不把所有命令機械地 包成 rtk proxy。以下範例假設 RTK 已可用；未安裝時直接使用原生命令。

目的	預設做法	升級為原文的時機
工作區／變更概覽	rtk git status、rtk git diff --stat、rtk git log -5	先分清已暫存與未暫存變更，不能把統計當成審查
找檔案或符號	先限制目錄、檔名或 rg -l；探索可用 rtk rg	要確認全部引用／宣稱不存在時，用限定範圍的無損搜尋
理解實作／護欄	定位行號後用客戶端的讀檔工具指定行號範圍	必讀護欄與相關實作要讀完；短檔才一次讀取
建置／測試	直接跑原腳本，保留結束碼	失敗後只讀錯誤附近，不重貼整份輸出
最終審查	依變更檔案分批讀無損 diff	檢查本輪全部變更；不得以壓縮 diff 代替

# 概覽先看範圍，不先印出所有差異。
rtk git diff --stat
# 長 diff 只需要內容概覽時，才使用 RTK 的有損壓縮。
rtk git diff -- CLAUDE.md
# 只回傳候選檔名；proxy 保留原文，省輸出的是查詢範圍。
rtk proxy rg --files src -g '*Theme*.cs'
# 確定要審查這個檔案後才讀完整差異。
rtk proxy git diff --no-ext-diff -- CLAUDE.md

• 需要已暫存差異時加 --cached；不要反覆讀取與本輪無關的既有變更。
• proxy 只用於需要無損輸出或 RTK 不支援的命令；不是壓縮模式。
• 輸出太大就縮小檔案／行號範圍，不提高 token 上限硬塞，也不把多個長檔併成一次輸出。 已讀且未變的區段不重讀。
• 不以有損摘要的空結果證明「不存在」。工具回報截斷時必須補讀缺漏範圍。
• 不能只比對「成功」字樣判斷建置或測試結果；看結束碼。
• RTK 已確認可用就不反覆執行版本／統計查詢；不要為追求節省率另跑一次相同命令。

文件按需讀取

先查標題／檔名，再讀命中區段。跨功能修改仍須補齊相關護欄，不能因節流而漏讀。 Markdown 單檔由檢查器限制在 5000 字元。搜尋片段不是完整證據，空結果也不代表沒有其他引用。

換設備：哪些會跟著 Git

項目	處理方式
文件	隨 Git 共用，clone 後可直接沿用
.claude/settings.json	共用 RTK Hook；有 RTK 才執行，沒裝就略過
.codex/config.toml、.mcp.json	本機 MCP 登記，可能含機器路徑，不進 Git
.claude/settings.local.json	個人覆寫，不進 Git
artifacts/	紀錄及暫存，不進 Git

換設備只要 clone、登入客戶端；需要加速工具時才照下面安裝。 不複製別台電腦的登入資料、全域設定或絕對路徑，不需要同步暫存紀錄。

選用工具

• RTK 短教學：壓縮命令輸出；Claude 用共用 Hook，Codex 依共用規則使用。
• 沒安裝 RTK 時回退原生命令，不自動安裝。

字元縮減與 RTK 統計都不是整個 task 的精確 token／帳單；比較時也要看是否漏改或重試。