idea-refine：把模糊點子整理成能評估的方案
先擴展可能方案，再檢查假設並收斂成一頁式提案，適合還不該直接寫規格的早期想法。
學完會知道
- 理解 idea-refine 在開發流程裡負責的工作
- 判斷什麼情況適合使用 idea-refine
- 完成通用 Skills CLI、Codex 或 Claude Code 安裝
開始前先準備
- 可使用支援 Agent Skills 的 coding agent
- 準備一個能實際驗證的小型開發任務
這個 Skill 在做什麼
先擴展可能方案，再檢查假設並收斂成一頁式提案，適合還不該直接寫規格的早期想法。
為什麼有用
太早寫規格，常會把第一個想到的方案固定下來。這個 Skill 先做發散，再用限制與風險收斂，最後留下能交給規格流程的一頁式文件。
適合什麼場景
- 只有產品概念，還不知道該做哪一種版本。
- 團隊卡在兩三個方向，討論一直繞圈。
- 想在投入實作前先壓力測試核心假設。
和站內相近內容的差別
它和 Prompt Optimizer 都會整理模糊輸入，但用途不同。Prompt Optimizer 讓指令更可執行；idea-refine 會先產生替代方案，再決定哪個值得寫進規格。Matt Pocock 的 idea-to-ship 則更偏向已選定方向後的交付流程。
如何安裝
想先查看可選清單，可以執行：
npx skills add addyosmani/agent-skills --list只安裝這一個 Skill：
npx skills add addyosmani/agent-skills --skill idea-refine安裝完整 24 個 Skills：
npx skills add addyosmani/agent-skills這個 Skill 的資料夾還有 examples.md、frameworks.md、refinement-criteria.md 和 scripts/idea-refine.sh。手動安裝時請複製整個 idea-refine/，不要只拿 SKILL.md。
手動安裝時，先 clone 上游 repo，再把整個 Skill 資料夾放進代理使用的 skills 目錄：
git clone https://github.com/addyosmani/agent-skills.git來源資料夾是 skills/idea-refine/。如果上面列出共用 references，還要保留上游的相對路徑。
Codex
Codex CLI 0.122 以上可安裝整套原生外掛：
codex plugin marketplace add addyosmani/agent-skills
codex plugin add agent-skills@agent-skills安裝後重新開啟 session。手動指定時輸入 @idea-refine；也可以直接描述任務，讓 Codex 依 Skill 的 description 自動選用。
Claude Code
Claude Code 可從 marketplace 安裝：
/plugin marketplace add addyosmani/agent-skills
/plugin install agent-skills@addy-agent-skills此外掛也提供 /spec、/plan、/build、/test、/review、/code-simplify 與 /ship 等流程指令。這些指令會編排對應 Skills，不代表每個指令都只使用本頁這一個 Skill。
自動啟用還是手動指定
手動優先。發散會增加選項，適合刻意安排在規格之前。需求已經定案時，不必再讓代理重新打開整個問題。
在 Codex 手動呼叫的寫法：
@idea-refine
請依這個 Skill 的原始流程處理目前任務，完成後列出驗證證據。