結論先說
- 技能包的核心優勢是「漸進式加載」,不會常駐佔滿上下文。會話啟動時 Codex 只讀取每個
SKILL.md頭部極短的name與description;只有當前任務匹配(或主動調用)時,才按需載入詳細說明、模板與文檔。 - 把確定性動作放進
scripts/,把大段規則拆進references/,把樣板放進assets/。讓模型直接執行經過評審的腳本而非現場拼複雜命令,既降低出錯率,也只把腳本輸出結果送進上下文,不浪費 Token 讀腳本源碼。 - 團隊共享技能直接提交在倉庫的
.agents/skills/<技能名>/下。隨 Git 版本管理與 PR 評審流轉,新人拉下代碼立刻自動擁有團隊發版、單測與排錯能力;個人通用技能則放在~/.agents/skills/。 description的觸發邊界寫得好不好,決定技能會不會被誤觸發或漏觸發。務必用一兩句清楚寫明「何時該用」與「不要在什麼場景下用」,避免多個相似技能互相搶佔。- 在團隊倉庫持續迭代、調試多個帶腳本與參考文檔的技能包需要頻繁試跑驗證。國內無外幣卡的用戶可在本站開通 ChatGPT Plus 或高配額的 ChatGPT Pro,團隊多人協作可了解 ChatGPT Business 團隊定製。

圖:本站根據 OpenAI Codex 官方文檔:Build skills 整理的示意圖
本文根據 OpenAI Codex 官方文檔《Build skills》《Skills and plugins》及 Agent Skills 開放規範整理,資料核對於 2026-11-19。配圖為本站整理的示意圖,不是介面截圖。本站(bigolab.com)不是 OpenAI 官方網站。
適用於誰
- 團隊裏已經寫了一份很長的
AGENTS.md,但發現每次啟動 Codex 都消耗大量上下文、規則一多反而容易顧此失彼的研發負責人; - 想把內部發版清單、單元測試夾具模板、日誌脫敏排錯腳本打包成可複用資產,讓全員在 Codex 裏一鍵複用的工程師;
- 剛學會安裝別人現成技能,準備按標準規範從零編寫團隊專屬
SKILL.md技能包的開發者。
一、標準技能包目錄結構與 AGENTS.md 的分工
很多團隊會把技能和 AGENTS.md、自定義斜槓提示詞混着寫(區別可對照 /guides/codex-skills-how-to-use-install 與 /guides/codex-memories-how-to-use-vs-agents-md)。簡單原則是:每次對話都要遵守的全局鐵律(構建命令、目錄約定、代碼風格)留給 AGENTS.md(讀取機制見 /guides/codex-agents-md-how-it-reads);只在特定任務才觸發的流程、腳本與模板全部封裝成技能包。
一個標準團隊技能包目錄如下:
text
.agents/skills/release-check/
├── SKILL.md # 必填:YAML 元數據 + 精簡操作步驟
├── scripts/ # 可選:確定性校驗或格式化腳本(.py / .sh / .js)
│ └── verify_changelog.py
├── references/ # 可選:長篇檢查清單、錯誤碼錶、歷史故障手冊
│ └── rollout-checklist.md
└── assets/ # 可選:輸出模板、樣板文件、配置文件骨架
└── release-notes.md
四個層級的分工非常明確:
| 目錄或文件 | 職責定位 | 上下文開銷特點 |
|---|---|---|
SKILL.md | 聲明觸發條件(Frontmatter)與執行主流程 | 啟動僅讀頭部元數據,命中後載入正文 |
scripts/ | 封裝校驗、脫敏、版本檢查等確定性邏輯 | 模型直接運行腳本,只回收執行結果 |
references/ | 存放長文檔、規範細則與錯誤碼索引 | 僅在流程明確指引查閱某文件時按需讀取 |
assets/ | 存放標準發版模板、測試腳手架等靜態素材 | 供代理複製或按佔位符填充生成目標文件 |
二、三套可直接套用的團隊技能包範本
本站建議團隊優先把最高頻、最怕漏步的三類流程做成獨立技能,分別放在 .agents/skills/ 下維護:
1. 內部發版校驗技能(release-check)
用於發版前自動檢查版本號、核對變更日誌並按統一模板輸出發佈說明草稿:
markdown
---
name: release-check
description: 核對即將發佈分支的版本號、Changelog 完整性並生成內部發版說明。僅在準備打 Tag、彙總發版變更或檢查發版前項時使用;普通日常功能提交不要觸發。
---
# 內部發版前檢查流程
1. 先運行 `python .agents/skills/release-check/scripts/verify_changelog.py` 檢查版本號與未歸檔條目。
2. 如腳本報告缺失項或存在破壞性變更,查閱 `references/rollout-checklist.md` 核實灰度與回滾要求。
3. 以 `assets/release-notes.md` 為模板生成發佈草稿,明確列出涉及數據庫遷移的服務名與人工覆核清單。
4. 禁止自動執行 `git tag` 或 `git push`,所有命令僅停留在生成本地草稿階段。
2. 團隊單元測試編寫技能(unit-test-author)
把公司規定的 Mock 寫法、命名規範和夾具骨架抽成模板,避免 AI 每次寫出來的單測風格各異:
SKILL.md:規定先跑一遍現有測試基線,新增用例必須覆蓋正常路徑、空值邊界與異常分支,嚴禁為了跑綠而刪改已有業務斷言;assets/test-fixture-template.ts:放一份標準的工廠函數與清理鉤子樣板;references/mock-rules.md:列明哪些外部依賴允許 Mock(如短訊、支付網關),哪些核心計算必須走真實邏輯。
3. 線上報錯快速排錯技能(prod-triage)
用於把線上告警日誌做本地脫敏、對照內部錯誤碼錶並定位到倉庫源碼路徑:
scripts/redact_logs.py:先過濾手機號、令牌與內網密鑰再交由模型分析;references/error-codes.md:維護核心業務錯誤碼與歸屬模組映射表,減少盲目全倉搜尋;SKILL.md:要求先輸出「觸發路徑、直接根因、影響範圍、最小止血方案」四段結構化結論,再徵求確認是否落盤修復。
訂閱與帳號準備提示:開發並反覆試跑團隊多套技能包時,經常需要連續做多輪觸發測試與腳本聯調。若 Plus 檔配額在高頻調試期不夠用,可在本站升級 ChatGPT Pro 充值 或選用 ChatGPT Pro 5x iOS 可覆蓋檔;若新註冊 OpenAI 帳號在手機驗證環節受阻,也可查看 Codex 註冊手機驗證服務。
三、編寫高質素團隊技能包的六項規範檢查

圖:本站根據 Agent Skills 開放規範 整理的示意圖
為了讓技能包在多人協作與長期迭代裏一直好用,上線合併前建議按下面六條逐一覆核:
name使用簡短小寫字母加連字符(如release-check),且與所在文件夾名稱保持完全一致;description明確寫出觸發場景與排除場景,防止模型在普通問答時頻繁誤載入大段流程;SKILL.md正文保持精煉、聚焦操作順序與紅線禁忌,長篇查表類資料全部下沉到references/按需讀取;scripts/中的腳本具備冪等性與清晰的退出碼,且僅做本地檢查或只讀轉換,高危寫操作必須由人工二次確認;- 所有腳本和模板均走常規 Git PR 評審合入,嚴禁在技能包裏寫入任何真實密鑰、內部帳號密碼或繞過權限的指令;
- 定期清理廢棄技能,並在簡單單輪文本複用場景下區分好自定義提示詞與技能包的邊界(對比見 /guides/codex-custom-prompts-slash-commands-guide)。
常見問題
問:團隊技能放在 .agents/skills/ 裏提交到 Git 後,成員還需要每人手工安裝嗎?
答:不需要。倉庫級技能放在項目 .agents/skills/<技能名>/ 下並隨代碼提交後,成員只要拉取最新分支並在該項目目錄啟動 Codex,客戶端就會自動發現這些技能的元數據並按需加載。
問:技能包裏的 scripts/ 腳本如果執行失敗了,Codex 會怎麼做?
答:模型會收到該腳本的標準輸出與報錯訊息,並據此向你彙報失敗的具體校驗項或退出原因。因此編寫腳本時盡量輸出清晰、單行定位明確的錯誤提示(例如指明缺失的字段名或文件路徑),能大幅提升排錯準確度。
問:國內沒有外幣信用卡,或者公司需要開增值稅發票報銷,怎麼開通適合全隊使用自定義技能包的 Codex 訂閱?
答:可通過本站 AI 會員充值總覽 辦理 ChatGPT Plus 卡密自助兌換 或高配額 ChatGPT Pro,多人研發團隊可直接選擇 ChatGPT Business 團隊定製。支持支付寶、微信支付及 AlipayHK 付款,無需交出帳號密碼,可開具增值稅發票;實時價格以商品頁展示為準,售後遵循掉訂閱按剩餘天數折退、封號不在質保範圍的規則。
相關教學
- Codex Skills 技能怎麼安裝與使用
- Codex 怎麼讀取 AGENTS.md 與層級優先級
- Codex Memories 記憶功能怎麼用?與 AGENTS.md 的區別
- Codex 自定義提示詞與斜槓命令配置指南
參考資料
- OpenAI Codex 官方文檔:Build skills — https://learn.chatgpt.com/docs/build-skills
- OpenAI Codex 官方文檔:Skills and plugins — https://learn.chatgpt.com/docs/skills-and-plugins
- Agent Skills 開放規範:Specification — https://agentskills.io/specification
0 條評論
還沒有評論,來搶沙發~