跳至主要内容

05|把 51 本書變成 Skill(wondelai/skills)

把書變成 Skill

🎯 一行簡述:51 個來自暢銷書與業界風格指南的框架 + 14 條 guided journey(metaskill)——不是教 Agent 怎麼操作工具,而是給它一整套「該用哪個框架思考」的知識。

wondelai/skills README

標題把定位講完:來自暢銷書的商業、行銷、UX 與工程框架。截圖當時 README 寫 62 個 skill(50 個框架 + 12 條 journey),現在的 README 寫 65 個(51 個框架 + 14 條 metaskill),支援 Claude、Claude Code、Claude Cowork、Codex、Cursor、OpenClaw、Hermes 等 agent。

基本資料​

項⁠目說明
出⁠自Wondel.ai(GitHub 組織 wondelai),skills.wondel.ai
組⁠織⁠介⁠紹GitHub 組織頁沒有公開簡介,repo 描述為「Business, Marketing, UX & Coding Frameworks from Bestselling Books」。README 與文章都沒有交代團隊成員或背景,能確認的是它維護 65 個 skill,每個 skill 的 frontmatter 標註 metadata.author: wondelai 與版本號。
動⁠機repo 未說明。文章整理出的做法是:LLM 讀過這些書但不會主動使用,所以每個 skill 的 description 都寫滿「什麼時候該想到這本書」的觸發語。
目⁠的把暢銷書與業界風格指南的框架做成 skill,另用 14 個 metaskill(guided journey)依序帶使用者完成建立、改善、成長一個事業、網站或 App,以及程式品質、技術債、架構設計。journey 的狀態存在專案的 docs/ 資料夾,可跨 session 續跑。
使⁠用⁠方⁠法Claude Code 執行 /plugin marketplace add wondelai/skills,再用 /plugin install code-craftsmanship@wondelai-skills 這類指令安裝要的集合;也可用 npx skills add wondelai/skills --all --global 一次裝全部,或 npx skills add wondelai/skills/clean-architecture --global 只裝一個。README 沒有逐一列出觸發語,文章指出由各 skill 的 description 自動帶出。

🤖 直接請 Agent 安裝​

看不懂底下的指令沒關係,把整段貼給你的 Agent(Claude、Claude Code、Cursor、Codex 等)即可:

請幫我安裝 Wondel.ai 的 Skills 收藏(github.com/wondelai/skills,MIT,
共 65 個 skill:51 個框架 + 14 條 guided journey):

1. 把這個 repo clone 或安裝到我目前 Agent 的 skills 目錄。
2. 先列出 14 條 guided journey 分別是什麼、各自對應什麼情境,
不要一次把 51 個框架全部塞進 context,讓我先從入口 journey 開始用。
3. 確認安裝完成後,示範一次怎麼觸發其中一條 journey。

Wondel.ai 是一個把「商業與工程經典書」系統性轉成 Agent Skill 的團隊。他們的立場很明確:LLM 讀過這些書,但不會主動用——除非你在對的時機把框架推到它面前。所以每個 Skill 的 description 都塞滿了「什麼時候該想到這本書」的觸發語。

每個 Skill 的 frontmatter 都帶 metadata.author: wondelai 與版本號(如 1.4.0),代表這是有版本管理的知識資產,不是一次性筆記。


9 個知識類別(共 51 個框架)加 1 個 metaskills 集合​

類別代表框架
Product StrategyJobs to Be Done、The Mom Test、談判、Monetizing Innovation、Lean Analytics
UX DesignRefactoring UI、iOS HIG、UX Heuristics、Hooked、Improve Retention(Tiny Habits)、Web Typography、Top Design、Lean UX、Microinteractions、Design of Everyday Things、Steve Jobs Design Review
Marketing & CROCRO Methodology、StoryBrand、Scorecard Marketing、Contagious、1-Page Marketing
Sales & InfluenceInfluence(影響力)、Predictable Revenue、Made to Stick、$100M Offers
Product InnovationLean Startup、Design Sprint、Design of Everyday Things、Inspired、Continuous Discovery、37signals Way
Strategy & GrowthCrossing the Chasm、Blue Ocean Strategy、Traction/EOS、Obviously Awesome、Good Strategy Bad Strategy、Cold Start Problem
Team MotivationDrive(自主、精熟、目的)、High Output Management
Code CraftsmanshipClean Code、Refactoring、A Philosophy of Software Design、Pragmatic Programmer、DDD、Working Effectively with Legacy Code、Technical Documentation(Google 開發者文件風格指南)
Systems ArchitectureDDIA、System Design、Clean Architecture、Release It!、High Performance Browser Networking、Team Topologies
Metaskills14 條 guided journey,見下方「三個設計特點」

實際安裝的五個(shark-agent/.claude/skills/)​

Skill出處特性
clean-architectureUncle Bob《Clean Architecture》圍繞 Dependency Rule 組織程式:相依方向永遠由 framework → use case → entity。觸發語涵蓋「這段商業邏輯該放哪一層」「怎麼跟資料庫解耦」「不重寫就能換框架嗎」,內容含 component 原則、邊界與 SOLID
domain-driven-designEric Evans《DDD》bounded context、aggregate、ubiquitous language、anti-corruption layer、context mapping、domain event。特別點名「程式跟業務對不上」「這個大系統要怎麼切」也算觸發情境
release-itMichael Nygard《Release It!》生產環境的穩定性模式:circuit breaker、bulkhead、timeout、retry。觸發語含「服務一直掛」「retry 風暴」「防止連鎖故障」「零停機部署」,涵蓋 deploy 與 release 解耦、可觀測性、容量規劃
ux-heuristicsNielsen 十大啟發式 + Krug可用性稽核:嚴重度分級、cognitive walkthrough、暗黑模式辨識、無障礙。觸發語是很白話的「使用者很困惑」「表單好難填」「這東西好用嗎」
good-strategy-bad-strategyRichard Rumelt策略核心三件套:誠實的診斷 → 引導方針 → 一致的行動,用來拆穿「把目標與願景當策略」的 bad strategy。可拿來稽核一份策略文件或 pitch deck 有多少空話

三個設計特點​

  1. Skill 之間互相轉介。每個 description 結尾都寫「For X, see Y」——例如 clean-architecture 指向 clean-code 與 domain-driven-design,ux-heuristics 指向 refactoring-ui 與 cro-methodology。等於在 Skill 層做了一張知識地圖。
  2. Progressive disclosure。每個 Skill 依序給:基礎概念 → 實務應用 → 範例 prompt → 作者脈絡,不會一次倒完。
  3. 14 條 guided journey(metaskill)。把多個框架串成有順序的流程,並把狀態存在專案的 docs/ 資料夾裡,跨 session 續跑:
    • Business:Create / Improve / Grow
    • Digital Product:Create / Improve / Grow(網站或 App)
    • Code Quality:改善程式品質 / 清技術債 / 設計架構 / 優化既有架構(architecture-optimization)
    • Conversion:優化單一轉換流程(conversion-optimization)

適合誰​

適合「知道有這些書、但不會在對的時候想起來」的人。它的價值不在替你讀書,而在讓 Agent 在你談到某個症狀時,自動搬出對應的框架——例如你說「使用者一直填錯表單」,它就開 Nielsen 十大啟發式來查。