AI 代理愈幫愈忙？GPT-6 Astra 技能檔撰寫指南：5 步驟幫 Codex Skill 檔大掃除

如果你過去一年用 Codex、Claude Code 這類 AI 編程代理工作，很可能已經累積了一整櫃 AI Skill，以及一份越寫越長的專案指令檔（Codex 是 AGENTS.md，Claude Code 是 CLAUDE.md）。 GPT-6 Astra 發表後，這些為了「管住」舊模型而堆出來的 Skill 與指令值得重新盤點，其中過度細化、重複甚至互相衝突的部分，很可能已經成了負擔 。

這不是外人的揣測。依 openai/codex 程式庫的更新紀錄，OpenAI 在 8 月 13 日把 Codex 內建的 skill-creator（教 Codex 怎麼寫 skill 的官方範本）從 416 行砍到 229 行，開頭第一條原則改成「假設 Codex 已經很有能力，只寫會改變它決策的資訊」。

Astra 發表隔天，Codex 團隊成員 Eric Provencher 就在 X 上發表長文〈Rethinking skills and prompts for GPT-6 Astra〉，把該刪什麼、該怎麼改講得更具體。Provencher 是 macOS 工具 Repo Prompt 的開發者，2026 年 5 月加入 OpenAI，負責 Codex 的開發者體驗；OpenAI 開發者體驗主管 Romain Huet 當時在 X 上公開歡迎他加入。

一般人拿到新模型的反應是再多裝幾個 skill、再補幾條規則。Provencher 的建議正好反過來：先做減法。

Codex Skill 裝太多會怎樣？為什麼反而拖累模型？

先弄清楚 skill 是什麼。白話說，它就是一份存成 Markdown 的提示詞，有時附帶腳本，讓模型在特定任務時照著做。每個 skill 都有名稱和描述，這兩樣會常駐在模型的 context（可以理解為模型的工作記憶）裡，模型靠它們判斷什麼時候該用哪個 skill。

問題出在預算。依 OpenAI 的 Codex 文件，開工時載入的初始 skill 清單（含每個 skill 的名稱、描述與檔案路徑）最多只能占 context 的 2%；若模型的 context 大小未知，則以 8,000 個字元為上限。裝得太多，Codex 會先把描述截短，再不夠就直接省略部分 skill 並顯示警告。這個預算只管初始清單，模型一旦選中某個 skill，仍會讀完整份 SKILL.md。

換句話說，一旦裝到超出預算，模型看到的就是一排被截短的殘缺說明。Provencher 說，結果就是模型更難判斷該挑哪一個；更糟的是，描述之間互相矛盾，或寫得太有「選我」的味道，會讓模型載入一堆對任務沒幫助的指令。

Codex Skill 怎麼整理？5步驟幫 Skill 檔大掃除

第一步：縮短 Skill 描述，說清楚「做什麼、何時用」

Provencher 的第一條規則：描述只需簡述這個 skill 做什麼、什麼時候該用，在這個前提下越短越好。他用一個資料庫 skill 當例子：

差別在後半句。前者只要任務碰到資料庫、查詢、資料模型，模型就會想套用這個 skill；後者把觸發範圍收窄到「新增、修改 migration 或檢視上線」，其他資料庫任務不會被干擾。

第二步：拆分 SKILL.md，用「路由器＋附件」節省 Context

第二條規則叫「漸進式揭露」（progressive disclosure）。模型每讀一份 skill 都要花 context，讀進來的內容還不一定跟手上任務有關。

Provencher 建議，一個 skill 若包含多種工作流程，主檔 SKILL.md 就只留共同原則和「什麼情況去讀哪份附件」的路由，細節放到 references 或 scripts 資料夾。OpenAI 新版 skill-creator 也用同樣邏輯，把 skill 資訊分成三層：名稱與描述、SKILL.md 本文、支援檔案，越後面的層級越晚才讀。簡單且自成一體的 skill 則不必硬拆，一份 SKILL.md 就夠。

第三步：刪掉 AGENTS.md 的食譜式流程

很多 skill 和 AGENTS.md 被寫成一步步的食譜。Provencher 指出，模型理解細微差異和模糊指令的能力已經大幅進步，過去有幫助的細節指令，換到 Astra 上反而礙事。

最典型的是「每次編輯前先讀完某幾份文件」：

改一個錯字也得先讀完整份架構文件，只是在燒 context、拖慢速度。Astra 自己會判斷該讀什麼，你只要告訴它哪份文件管哪件事。同理，舊模型要被催著跑測試、檢查成果，Astra 會自己做，沿用「一律要跑測試」的舊指令，可能導致不必要的測試。

第四步：把「先問再做」改成明確授權，並定義完成條件

Provencher 特別提醒兩件事。第一，如果你曾因為舊模型擅自行動而在 AGENTS.md 加了強硬的「先問再做」，Astra 會把這些邊界看得很重，可能在你其實希望它繼續的地方停下來。OpenAI 發表時公布的一項評測也呼應這點：在 OpenAI 針對困難或不可能完成任務設計的特定越權評測中，未加正式部署防護的上一代模型 GPT-5.6 Sol 有 48% 的測試案例越過授權目標，Astra 則未觀察到此行為。這是特定評測的結果，不代表日常使用的越權機率。

與其寫一堆禁令，不如給它一段明確的授權，寫清楚哪個工作流程是安全的：

OpenAI官方的GPT-6 Astra提示詞指南，另外提供了完整的授權模板，也寫明該在什麼時機才向使用者提出確認。

第二，Astra 比 Sol 更傾向做完第一版就回來找你檢視，即使工作還沒做完。OpenAI 的模型指南也提到，Astra 在額外資訊可能改變結果時，更常停下來問使用者。

解法是開工前先定義完成：如果任務包含把程式跑起來、檢查結果、修掉錯的地方，就把這三件事寫進要求裡；如果你希望它做完第一版後繼續探索，就說清楚要探索什麼、到哪裡停。

第五步：讓 GPT-6 Astra 自己盤點 Skill 與 AGENTS.md

Provencher 在文末建議，直接請 GPT-6 Astra 依上述原則對你的專案做一次稽核。原文沒有附提示詞，以下依他的建議整理成一則可直接貼入 Codex 的版本：

輸出應該有這五部分：縮短後的 description 清單、可拆分的 SKILL.md 與建議搬移的段落、可刪的 AGENTS.md 條目、改寫後的授權句、重疊的 skill 配對。缺哪一段，就在同一個對話補一句「第 N 項再展開」。

Codex Skill 哪些該留？多人、多模型共用時別急著刪

Provencher 自己留了但書：repo 裡的 skill 會被同事的 agent 讀到，對方可能用 Sol、Luna 或其他模型，對 Astra 剛好的指令對它們可能不夠。OpenAI 的模型指南另外提醒，Astra 對 skill 檔內的指令更敏感，寫得模糊或互相衝突會讓它提前停工。也就是說，這次大掃除的重點是「寫準」，不只是「寫少」。

遇到使用者指令與技能檔衝突的情況，官方建議在提示詞中明訂兩者的效力順序。

因此，這一波大掃除可以「先刪描述，再拆結構」，也就是先重新檢視過時或重複的限制，再把完成條件寫清楚。剩下的，就交給模型自己判斷。

（本文出自數位時代）