AGENT SKILL 一日工作坊 · 案例單元

一個人,建了 21 個 skill 的生態

他叫寶玉(Jim Liu)。一個人,把整套內容工作流長成 21 支互相調度的 skill。今天不逛功能,看他怎麼把「品味」這種說不清的東西,變成 AI 照著做就不會錯的明文約束

21 頁 · 案例單元 21 skills · 一人之力 素材來源:JimLiu / baoyu-skills · MIT 授權
這章的 aha:好 skill 不是「功能多」,是把專家說不清的品味與血淚,固化成可重複的配方明文的防呆出錯的退路

先認識主角

寶玉(Jim Liu):一個人,21 支,全開源

不是團隊、不是公司,是一個人。他把每天做內容的工序切成 skill,長成 21 支互相呼叫的生態。原始碼公開、MIT 授權,誰都能 clone 下來逐行讀。

👤 一個人

沒有設計團隊、沒有工程組,21 支全是他一人手寫、維護、發布。Agent 時代「個人能力被放大」的活證據。

🧩 21 支

翻譯、逐字稿、生圖、排版、配圖、發文,幾乎涵蓋內容創作者的全部工序。一支管一件事,但會互相調度。

📖 全開源 · MIT

github.com/JimLiu/baoyu-skills。MIT 授權,沒有黑箱。下面每個數字、每張配色表都是 clone 下來的真檔。

為什麼挑他當案例?因為他的作品「看得到內裡」。一個專家,怎麼把腦袋裡說不清的判斷,一支一支固化成可分發的能力。

先看整片森林

21 支不是亂長的,分成四群

一條主線把素材變成發布內容,三個衛星各管生圖、發布、雜活。不用記工具名,記住這四群在做什麼就好。

🏭 內容生產線 10 支

一條完整產線。影片進來,逐字稿、翻譯、排版、配圖,出來是可發布的文章。

🎨 生圖家族 5 支

本章主角。把封面、資訊圖、社群圖卡的視覺品味,拆成可以逐項挑的配方。

📮 發布社群 4 支

把成品送上各平台。公眾號、微博、X,格式各自就位,不用手動重排。

🔧 工具雜活 2 支

純苦力,沒判斷,但每支都救命。代表作就是壓圖,這章最後會單獨講。

今天只追三招。專挑生圖家族與壓圖,因為它們最能演示這章的三招:配方(把品味拆成選單)、防呆(寫死不准做什麼)、退路(動手前先留底)。

群一 · 內容生產線(v2a 細講過,這裡輕點)

影片進去,發布內容出來

這十支不是平行的工具,是排成一條流水線。每一站交一棒,下一站接著做。

youtube-transcript   影片  帶時間戳的乾淨逐字稿
       
translate            外文  像母語原創的譯文
       
format-markdown      雜亂稿  排好版+自動下標+生 meta
       
article-illustrator  文章  配圖
       
markdown-to-html     成稿  可貼 CMS 的 styled HTML
       
post-to-wechat       一鍵發布
一句話看懂:過去你要開六個工具、複製貼上六趟;寶玉把每一棒都做成 skill,串成一條「影片到發文」的自動產線。v2a 那章已細看過,這裡只看它在生態裡的位置。

產線裡藏的一個洞察

一支 skill,會自己去叫另一支 skill

看到中文文章,先問要不要請排版同事整理,再轉成網頁版。markdown-to-html 的 SKILL.md 寫死了這個開場三步:

# markdown-to-html 動工前的「開場三步」先看   這篇文章裡有沒有中文?沒有 → 直接轉檔
② 再問   有中文,而且隔壁排版同事在 → 問你「要不要先請他整理?」
③ 你說好  → 叫 format-markdown 整理完,再回來轉網頁版
它打破一個迷思:你以為一支 skill 要自己包山包海,其實成熟做法是把粗活外包給隔壁那支專門的 skill。會自己判斷、還會找同事的工具,比「功能多」高明得多。

產線裡藏的另一個洞察 · CTR 文案配方

format-markdown 裡,藏了 8 個下標公式

這支表面是排版器,下標題時卻用一張寫死的配方表 title-formulas.md。對靠標題搶點擊的行銷人,這是現成的牌路,不用憑感覺。以下是真檔:

#公式範例(原檔真句)
1顛覆認知"All de-AI-flavor prompts are wrong"
2直接給答案"One recipe to make AI write in your voice"
3懸念"It took me six months to find how to remove AI flavor"
4具體數字"150 lines of docs taught AI my writing style"
5反差"One doc replaced three months of AI tuning"
6結果先行"After using this method, nobody could tell it was AI"
7反問"Why can people spot your AI writing at a glance?"
8共鳴"Three months fighting AI flavor, I finally broke free"
它不只給公式,還寫死下標紅線:「前 5 字要製造資訊落差」、「具體>抽象(『150 行』贏過『一份文件』)」、「最長約 30 字,太長在 feed 會被截斷」。甚至明令禁止「震驚體」「萬字長文」「必收藏」這種會被演算法懲罰的標題。等於把一個資深編輯的下標守則,內建進一支「排版器」裡。

產線裡藏的第三個洞察 · 最貼行銷 KPI 的一個

同一支排版器,順手把 SEO meta 都生好了

每篇文章上架還要手刻 meta description、想一個 slug,最煩。format-markdown 排版的同一趟就一起交件,而且長短各生一份,分給不同用途

summary(約 50–80 字 · 短版)

一句話濃縮。給社群分享卡、SEO meta description用,就是別人轉貼時預覽框那一行。

description(約 100–200 字 · 長版)

多兩三句的版本。給文章列表預覽、電子報摘要用,賣點要講得完整一點的地方。

# format-markdown 排完版,順手生出的 frontmatter
title:       吸睛標題(用上一頁那 8 個公式挑)
slug:        network-friendly-url-slug
summary:     50–80 字 · 給社群卡與 SEO meta
description: 100–200 字 · 給文章預覽與電子報
這裡藏著上一階梯的「AI 與 script 分工」:需要動腦的事(讀懂文章、抓賣點、寫 summary 與 description)交給 AI;確定性的雜活(中英文加空格、修標點、把 YAML 排整齊)交給 script判斷歸 AI,機械歸程式,所以產出又快又穩。

別人 skill 少做的一招 · 個人化偏好檔

EXTEND.md:讓同一支 skill,記住「你的」品牌標準

別人的 skill 誰下載都長一樣。寶玉多了一份 EXTEND.md 偏好檔,把 skill 從「一次性工具」,變成「記住你品牌的助手」。

它怎麼運作

第一次用,skill 先問你幾個問題:預設語言、語氣、受眾、品牌術語、禁用詞。答案存進 EXTEND.md。之後每次執行,它先讀你的偏好,再動手

為什麼對行銷團隊特別值錢

這等於一份會自動套用的團隊風格指南。你和同事各自有各自的 EXTEND.md不用改 skill 本體,同一支 skill 各照各的品牌標準跑。

誠實標一句:EXTEND.md 是寶玉自訂的慣例,不是 Claude Code/Anthropic 官方規範(官方只認 SKILL.mdreferences/scripts/)。當「進階玩法」學它的概念就好,做 skill 不一定要它。

群二 · 生圖家族(本章主角)

把「會生圖」,升級成「可重複的配方」

你跟 AI 說「幫我做張好看的封面」。好看是什麼?沒人答得出來,於是每次生出來都不一樣,整個帳號視覺一團亂。

❌ 沒配方

「幫我做張好看的封面」
→ AI 自由發揮
→ 這張藍、那張紫、下張又換風格
帳號視覺零一致

✅ 有配方

「用 macaron 風格做封面」
→ AI 在驗證過的骨架裡填充
→ 每張同一套配色、同一種質感
帳號視覺自動一致

核心轉念:價值不在「它會生圖」,而在把「好看」拆成可以逐項挑、而且每次都一樣的配方。

配方怎麼拆 · 維度相乘

「好看」= 版型 × 風格 × 配色

寶玉把抽象的「好看」拆成幾個各自獨立、可以自由相乘的維度。infographic 的 SKILL.md 第一句就把這個思路寫死:

# infographic SKILL.md 開宗明義
Two dimensions:
  layout (information structure)
  × style (visual aesthetics)
Freely combine any layout with any style.

21

版型 layout

資訊怎麼排
(infographic)

×

22

風格 style

畫面長怎樣
(infographic)

cover-image 同思路:11 種配色 × 7 種渲染風格,自由組合

關鍵不是數字大,是把「好看」變成三個互不打架的選單:版型、風格、配色。各挑各的,所以 21 × 22 不用寫 462 個範本,21 + 22 張小抄就湊得出所有組合。說不清的「好看」就變成可重複的選擇題。

配方怎麼存 · 漸進式披露的真實應用

主檔只留索引,配方各自躺成小抄

色碼全塞進主檔,每次對話都得吞一遍,又貴又亂。寶玉的做法:主檔只當目錄,每個配方一個獨立小檔,選到哪個才讀哪個

baoyu-cover-image/
├── SKILL.md          # 只放流程+一張名字清單
└── references/
    ├── palettes/      # 11 張配色小抄
    │   ├── macaron.md
    │   ├── retro.md
    │   └── …(共 11 個)
    └── renderings/    # 7 張風格小抄
        ├── hand-drawn.md
        ├── pixel.md
        └── …(共 7 個)
主檔=目錄
SKILL.md 只列得出 11 個配色的「名字」,不放任何色碼。保持輕薄,每次對話成本低。
references=倉庫
真正的色碼、裝飾提示躺在 11+7 個小檔裡。平常不載入,AI 不必把它們吞進腦袋。
用到才讀
你選了 macaron,AI 才去翻那一個約 30 行的小檔。這就是「漸進式披露」的真實長相。
這就是階梯 3 教的「漸進式披露」,在真實作品裡長這樣。不是理論,是一個資料夾結構。skill 不怕內容多,怕的是「一次全塞給模型」。

一張配方小抄的真面目

macaron:奶油色教學風,整張表照抄都一致

這就是 references/palettes/macaron.md 的真實內容。一張表,把「奶油色教學風」固化成任何人照抄都一樣的配方。

Color Palette(真實 hex)

Sky Blue#A8D8EA
Mint Green#B5E5CF
Lavender#D5C6E0
Warm Cream#F5F0E8
Peach#FFD5C2
Coral Red#E8655A
Best For(用途欄)
「教學內容、知識分享、概念解釋、上手教材、技術摘要」。行銷人不用懂色票,看「我這篇是教學文嗎」就能對號入座。
⛔ Semantic Constraint

配方檔還寫死一條:「不准把色名、hex、角色標籤當文字畫進圖裡。」這張表是給 AI 配色用的,不是要它畫成圖。連這種坑都先堵了。

對號入座,就這麼簡單。教學文挑 macaron、懷舊文挑 retro(它的真實 hex 是 Coral Red #E07A5F、Mustard Yellow #F2CC8F…)。同一個 schema、換一組值。你的部落格、IG 帳號,從此每張圖都像同一個設計師出的手。

招牌二 · 「別這樣」才是專家經驗

最高價值的內容,是寫死「不准做什麼」

寶玉原話,值得釘在牆上:
「正向原則,模型往往已經知道;
負面邊界,才是專家經驗。

新手只會寫「要怎麼做」

「要配對比色」「標題要吸引人」「圖片要清晰」
這些模型本來就會,講了等於沒講。

老手才寫「別這麼做」

「文字生壞不准事後 P 圖」「別拿 SVG 假冒點陣圖」
這是踩過坑的人才寫得出來的邊界。

為什麼負面邊界這麼值錢?正向原則是常識,模型早就學過;「這個操作會出什麼包」,只有真正痛過的人才知道。把這種血淚寫進 skill,就是把專家跟新手的差別固化進工具。

真實防呆 ①

⛔ 不准用 SVG / HTML 假冒點陣圖

⛔ cover-image 與 infographic 都白紙黑字封死

「就算這段 SVG 看起來很像圖表,呼叫我的人已經決定要的是點陣圖。找不到生圖後端,就停下來問人不准默默吐一段 SVG 或 HTML/CSS 矇混過去。

AI 為什麼會犯這個錯?

當生圖後端連不上、或它「偷懶」想省事時,最自然的脫身方式就是吐一段 <svg> 或 HTML/CSS,因為那對它很容易,而且乍看真的很像一張圖

為什麼一定要禁?

SVG 不能上傳到只吃點陣圖的平台、不能當社群縮圖、在很多 CMS 會破版。你以為拿到一張圖,實際上拿到一個用不了的假貨,到要發布才發現,最氣。

這條規則的本質:寶玉知道 AI 會怎麼「交差了事」,提前把那條偷懶的路堵死。你要真圖,它就不准給假圖;寧可停下來問你,也不矇混。

真實防呆 ②

⛔ 文字生壞了,只能重生,不准 P 圖

⛔ 封面標題字生歪、生錯字時的鐵律

不准用任何程式(如 ImageMagick)在已生成的圖上塗蓋、改寫文字。字錯了,就改 prompt 重生一張,或換低字版型,或讓使用者從幾張裡挑一張比較不差的。」

新手的反射動作

封面上「自動化」打成「自動花」,第一直覺:拿 ImageMagick 在那塊區域蓋一塊、補上正確的字。看起來修好了。

為什麼這是地雷?

事後貼的字,字體、光影、紋理跟原圖對不起來,放大一看就是補丁,廉價感藏不住。AI 生圖的整體感,一塊補丁就毀了。正解是改 prompt 重生,讓字從一開始就長對。

這條 know-how 只有做過的人才有。沒生過圖的人不知道「事後補字」是個坑,它看起來明明是最快的解。寶玉把它寫成鐵律,AI 就永遠不走那條看似聰明、實則毀圖的捷徑。

真實防呆 ③

⛔ 覆寫前先備份,絕不一刀砍掉原檔

壓圖、轉檔、排版這類會蓋掉原檔的破壞性操作,寶玉一律先留退路。做法固定,每支 skill 都一樣:

# 寶玉所有破壞性操作的固定套路

① 新結果先寫到  output.tmp
② 確認成功後   rename 蓋上去   # 中途失敗,原檔毫髮無傷
③ 原檔不刪     改名成 xxx_original   # 永遠留一份底
寶玉自己的話:「好 skill 預設幫你留退路,不會一刀把你原檔砍了。」

這條的價值不在技術,在心理:因為它出錯時不會把你害慘,你才敢放心地一句話交辦。讓人敢交辦的,從來不是工具多強,是它出包時不會連累你。

群四 · 工具雜活 · 一支直接連到 KPI

compress-image:重點不是壓圖,是把「壓到剛好」變成永不漏的紀律

21 支裡看起來最不起眼的一支,就是壓圖。但它是對行銷人最容易算出帳的一支,因為它直接打在 Google 的排名信號上。

它做的事,一句話:你丟一張圖(或整個資料夾),它自動挑機器上最好的工具,吐出體積大砍的 WebP,還附上戰績

image.png → image.webp
(245KB → 89KB, 64% reduction)

關鍵預設:WebP、品質 80。這是肉眼幾乎無感、體積卻砍一半以上的甜蜜點,你不用懂任何參數。

為什麼 SEO 行銷人該在乎一支壓圖 skill?

沒壓過的 banner 動輒幾百 KB 到幾 MB,直接拖慢 Google 的 LCP

說人話:LCP=頁面最大那塊內容(通常是首圖)多久才出現,是 Google 打分的速度信號之一。

圖太肥 → LCP 變慢 → 行動版排名掉 → 跳出率上升 → 轉換成本變高。

一支壓圖 skill=護排名、護速度、護廣告成本,三件一次顧。

先說實話:壓圖是雜活,Squoosh、TinyPNG 都能做。skill 的價值不在「一句話叫它做」,而在把你的判斷固化成紀律:WebP 品質 80 這個甜蜜點決定一次,之後每篇、每次上線都自動照辦,不忘、不漏、不手滑。從「我記得要做對」變成「它替我永遠做對」。

📋 今天就能抄的一句:上線前跟 AI 說「把 images 資料夾壓成 WebP,品質 80」。整批瘦身、首圖變快、排名信號變好。

把這一章縮成一句

三招=把品味、經驗、破壞風險,固化成工具

這章看的三件事,其實是同一個動作的三個面。

品味 → 約束

「好看」說不清,所以拆成維度、寫成配方表(macaron、11×7、21×22)。AI 的任務從「自由設計」降級成「在驗證過的骨架裡填充」。好看不是玄學,是可拆解的常識。

經驗 → 防呆

踩過的坑寫成 (別假冒 SVG、別 P 圖補字)。正向原則模型本來就會,負面邊界才是專家跟新手的差別。這是 skill 裡密度最高的價值。

破壞 → 退路

覆寫前備份、先寫 .tmp、原檔留 _original讓人敢放心交辦的,從來不是工具多強,是它出錯時不會把你害慘。

一個對照,幫你記住整章:如果這 21 支只是「會生圖、會壓圖」,早被下一個更炫的工具取代了。真正不可取代的,是寶玉腦袋裡那套說不清的判斷skill 的價值從來不在 AI,在那個把自己經驗注入進去的人。

帶回去用

三招,你今天就抄得走

你做 SEO、做行銷,腦袋裡也有一整套說不清的判斷。把它變成 skill,就用這三招。

📋 抄「配方表」

下次要 AI 產一致風格的東西(社群圖、報告版型、信件語氣),先把「好的長怎樣」拆成幾個維度,每個維度列一張清單。別讓 AI 自由發揮,給它選單。

⛔ 抄「負向防呆」

回想你這個工序最常被 AI 搞砸的地方,把它寫成一條「⛔ 不准…」。不用寫程式,一句中文就鎖住。這是你 skill 裡最值錢的一行。

💾 抄「留退路」

任何會覆寫、會刪檔的步驟,加一句「動手前先備份」。讓你的 skill 出錯時不會把你害慘,你才敢放心一句話交辦。

最重要的一句:這三招沒有一招需要寫程式,全是自然語言。替你的 skill 裝上工程級的安全網,一行 code 都不用。AI 只是執行,判斷永遠是你的。

把帶走感壓實 · 撕下來就能用

三招速查卡,照著填就有

① 配方卡:把「好看」拆成幾個選單,每格填上自己的值。範例值取自寶玉 macaron 配方:

# 我的「一致風格」配方卡
版型 = ____________   # 資訊怎麼排
風格 = ____________   # 畫面長怎樣
配色 = 奶油教學風     # #A8D8EA / #B5E5CF / #F5F0E8…
# 每次都選同一組 → 整個帳號視覺自動一致

②+③ 防呆與退路:各一句中文,貼進你的 skill 就生效,不用寫程式:

照抄句型
「⛔ 不准 ______(你這工序最常被 AI 搞砸的地方)」
💾「任何會覆寫或刪檔的步驟,動手前先備份原檔。」
🎯 三分鐘小練習:挑你每天在做、最想交給 AI 的一個工序(下社群標、配圖、整理週報…)。(1) 把「好的長怎樣」拆成 2–3 個選單;(2) 寫一條「⛔ 不准…」;(3) 補一句「先備份」。三句話寫完,你就有一支 skill 的骨架了,一行 code 都沒碰。

把話說清楚

出處、授權,與一個重要提醒

📖 素材來源

作者:寶玉(Jim Liu
原始碼:github.com/JimLiu/baoyu-skills
授權:MIT

本單元為教學用途整理與中文化,招牌方法(配方維度、負向 gotchas、留底防呆)以自己的口吻轉述,保留原作者出處。

⚠️ 重要提醒:哪些非官方

EXTEND.md 偏好檔、baoyu- 前綴命名、metadata.openclaw 欄位,都是寶玉自訂的個人慣例不是 Claude Code/Anthropic 官方規範

官方 skill 結構只認 SKILL.mdreferences/scripts/。學員自己做 skill 不必、也不該照抄 EXTEND.md,學概念即可。

為什麼要特別講這段?因為這正是這套課的誠信底線:引用別人的招牌方法,要標出處、用自己的話轉述;看到別人的自訂慣例,要分清楚「這是他的風格」還是「這是平台標準」。把界線講清楚,學員才不會把寶玉的個人偏好,誤當成做 skill 的必要規範。