實作指南 / 15 分鐘
把重複工作封裝成 Skills
Workflow 用 focused SKILL.md；需要 distribution/connections 才用 plugin。
Skills 封裝 instructions、references、scripts 與 assets，Codex 選中後才載入完整內容。Plugins 透過已配置 marketplace 分發 skills 與可選 MCP；安裝前先列出並檢查 marketplace，再選明確 plugin。
CLI
已驗證 Terminal Sequence
- ›
$skill-creator - ›
/skills - ›
$skill-name - $
codex plugin marketplace list - $
codex plugin marketplace add owner/repo --ref main - $
codex plugin list - $
codex plugin add <PLUGIN>@<MARKETPLACE>
A
工作原則
一個 Skill 一項工作
Precise description 改善 explicit selection 與 implicit trigger。
Progressive disclosure
Metadata 常駐；SKILL.md/references/scripts 需要時才讀。
Distribution 分離
先 local authoring；多人安裝、多 skills、connectors 才 package plugin。
Marketplace 是信任決策
加入 local config/cache 前先 review Git/local source 並列出可用 plugins。
B
實地程序
- 01
定義 trigger
先寫何時該/不該觸發。
- 02
使用 creator
呼叫 $skill-creator 後親自檢查 SKILL.md。
- 03
窄化 deterministic helpers
只有 deterministic processing 明顯更可靠才加 script。
- 04
測 explicit/implicit
用 $skill-name 與應觸發/不觸發 prompts 測試。
- 05
選 distribution
Repo workflow 放 .agents/skills；穩定共享才 plugin。
- 06
實際驗證安裝路徑
列出 marketplaces/plugins，加入明確 selector，驗證 capability，lab 結束後移除。
PASS / FAIL
驗收清單
- Description 有 scope/trigger。
- Inputs/outputs/verification 清楚。
- Scripts 不隱藏多餘 authority。
- Marketplace origin 與 plugin selector 已 review。
- Plugin 有真實 distribution need。
WATCH / REJECT
失敗模式
- 做 giant universal skill。
- 新 workflow 使用 custom prompt。
- Prose 足夠卻加入 scripts。
- 只因 plugin 名稱熟悉就從未審查 marketplace 安裝。