代理就緒修復
透過僅套用安全變更來提升程式碼庫的就緒度。引擎會規劃並寫入配置樣板；你則負責 Git 操作及編寫任何說明文字。分為三個類別，三個不同的安全層級。
步驟
-
確保報告存在。 如果缺少
.agents/readiness/latest.json，請先執行 ra1-report 技能。 -
試運行計畫以查看將變更的內容：
python3 "$(dirname "$0")/scripts/readiness/cli.py" fix --project <repo-path>它會印出三個類別：自動套用（安全配置樣板）、提案（供審閱的草稿）、GitHub 設定（手動）。
-
先建立本地分支（切勿在預設分支上工作）：
git -C <repo-path> checkout -b readiness/fixes -
套用安全樣板（冪等；若工作目錄不乾淨則拒絕執行；絕不覆蓋非空檔案）：
python3 "$(dirname "$0")/scripts/readiness/cli.py" fix --project <repo-path> --apply -
自行撰寫「提案」項目——README 章節、客製化的
AGENTS.md、操作手冊、第一個測試。將這些寫成供使用者審閱的草稿；切勿憑空捏造關於程式碼庫的事實。templates/AGENTS.md是一個起始骨架——根據程式碼庫實際的用途來填寫。 -
顯示差異並在本地提交。 總結變更，然後：
git -C <repo-path> add -A && git -C <repo-path> commit -m "chore: raise agent readiness"在提交訊息結尾加上必要的
Co-Authored-By結尾。 -
重新執行 ra1-report 以顯示等級差異。
合約（不得違反）
- 在未經使用者明確確認的情況下，絕不推送，也絕不開啟拉取請求。 先在本機建置並提交。
- 僅自動套用配置樣板。 README/AGENTS.md/測試/操作手冊是使用者審閱的提案草稿——自動撰寫說明文字有「紀錄虛構內容」的風險。
- 絕不將 GitHub 設定變更（分支保護、密碼掃描、標籤）與程式碼提交捆綁在一起。將其以
gh指令清單的形式呈現，讓使用者執行並確認。 - 尊重不乾淨的工作目錄：未經詢問，不得使用
--force覆蓋未提交的工作。