我把 skill 和 agent 全裝進了 HTML,再沒碰過飛書

作者:縱所周知101
日期:2026年5月11日 上午7:04
來源:WeChat 原文

整理版優先睇

速讀 5 個重點 高亮

HTML建立可視化工作流鏡像,讓自己看見skill與agent的關係、進度與協同,從而保留決策主導權

整理版摘要

作者周知係一位用AI經營一人公司嘅創業者,管理69個skill同十幾個AI agent。佢發現自己雖然寫咗好多skill,但唔清楚佢哋之間嘅關係,每次都要重複造輪子。於是佢開始用HTML製作可視化工具,唔再用飛書、Notion等傳統文檔工具。

經過4個版本演進,佢總結出HTML核心價值唔係取代決策,而係讓自己「看見」工作流——從盤點關係、發現改進位、追蹤協議,到封裝進度可繼承。整體結論係:工具應該匹配工作流複雜度,而HTML作為鏡子,只反射唔替你做決定,呢條「降本不取代」原則係所有自研工具嘅元設計。

文章分享咗每個版本解決嘅具體問題同實戰經驗,適合管理大量AI組件嘅開發者參考。

  • HTML建立可視化工作流,解決「唔知道自己有咩」嘅問題,比Finder或飛書更有效
  • 三軸交叉視圖揭示技能間關係,例如ModelForge橫跨多層、覺醒系列係隱性主線
  • 決策儀表盤帶真理由、ROI徽章同死代碼考古,逼你直面下一步改邊度
  • 協同手冊用KPI同可視化讓跨module協議活起來,取代靜態markdown
  • 封裝路線圖同時服務人類同agent,做到單次可追溯、跨次可繼承
整理重點

起點 · 你有咩同佢哋之間咩關係

上週三夜晚,作者望住Finder個資料夾發呆,裏面有69個skill文件夾,但佢唔知自己有咩。呢個問題困擾佢,直到佢做咗第一個HTML——《知墨覺醒 · 69 Skill 生態》,用黑底紫光同8層明度梯度展示8層架構。

三軸一交叉就不一樣了——按L層、思維家族、覺醒系列分刀,先見到原來ModelForge有5個變體跨層,覺醒系列係一條隱性主線

呢個HTML開咗無數次,每次新會話就掃瞄——篩「覺醒系列」揾思維腳手架、篩「L6決策三件套」揾路徑選擇、篩新建標記揾最近產物。Finder畀唔到呢種按維度刀切嘅能力。

整理重點

中段 · 下一步改邊度,同埋改嘅依據

第二個HTML叫《OmniThink Writer 全景迭代決策儀表盤 v2.0.3》,有5視圖、36節點,每個節點health三色(綠32/黃4/紅0),SHIPPED 24件、BACKLOG 3件。

封裝v1.6嗰次,5 case真測試發現humanize-forge仲係v1.2老硬限≤1,冇同步到v1.6嘅密度閾值

如果只睇v1.6 SKILL.md,作者以為修完咗。但儀表盤D5時間軸一睇,「反思v1.5.1」仲紅住——先意識到要出v1.6.1 patch。第二個HTML將「下一步改邊度」由判斷題變成睇圖題。

整理重點

協同 · 跨module協議要活起嚟

第三個HTML係關於量化交易系統《來財 v3.0.5 · G6.13 協同手冊》,但形態可遷移到skill協同。187 KB,monospace終端美學,tabbar多視圖+KPI卡+bar進度條+modal+mermaid圖引擎+tailwindcss。

協議寫喺markdown冇人讀,包括作者自己。但來財協同手冊每次打開,因為KPI首屏直接顯示今日要做咩

  • 邊個module喺active狀態、邊個等輸入、邊條協議觸發咗幾次——全喺首屏
  • Markdown係線性,協議係網狀,HTML嘅可視化先對應到
  • 如果omnithink協議做成同款活手冊,就唔會再「忘記同步humanize-forge閾值
整理重點

閉環 · 單次封裝可追溯,跨次可繼承

第四個HTML係一組文件——《zhouzhis-gzh-agent v1.0 封裝路線》,包括PROGRESS.md同context-packet.yaml。5 phase串行,每步自動✅。

PROGRESS.md畀人睇,context-packet.yaml畀Agent睇——一份內容兩種受眾

下次封裝小紅書agent時,5 phase模板可以直接抄。更關鍵係context-packet.yaml,佢記錄咗V(1)8.125→V(2)9.125嘅迭代軌跡,下次Claude新會話喂返去就恢復上下文,唔需要從頭解釋。

整理重點

道與收束 · HTML係鏡子,我留拍板權

4個HTML形態唔同,但做嘅係同一件事:讓作者睇見自己嘅工作流。唔係替佢做決定,係讓佢睇見決定。

  1. 1 生態全景:我有咩 — 睇,唔可以改
  2. 2 決策儀表盤:下一步改邊度 — 睇+寫筆記
  3. 3 協同手冊:跨module協議點行 — 睇+調起對應module
  4. 4 進度地圖:今次封裝到邊步 — 睇+落盤到下次

降本不取代」係所有自研工具嘅元設計原則,HTML將呢條哲學物理化

大部分人唔需要呢種鏡子,因為佢哋嘅工作流唔夠複雜。但如果你嘅嘢多到自己睇唔清,HTML可以係讓你自己睇返自己嘅工具。作者用佢管69個skill同十幾個AI員工,下一個HTML已經喺路上。

上星期三夜晚,我眼睩睩咁望住 Finder 個文件夾發吽哣。

~/Library/Application Support/Claude/local-agent-mode-sessions/skills-plugin/.../skills/

入面有 69 個文件夾。每個文件夾都係我自己寫嘅 skill。

我有 69 個 skill,但係我唔知自己有啲乜嘢。

呢件事有啲唔妥,但我講唔出係邊度。

之前我用 MD 管理,直到我整咗第一個 HTML。之後陸續整咗第三、第四個。今日封裝完 zhouzhis-gzh-agent v1.0 之後,回望——我用 HTML 管理 skill 同 agent 呢條路,已經行咗 4 個版本。

唔係飛書,唔係 Notion,唔係 Obsidian,唔係 Roam。

係 HTML。

全文概要圖|4 個 HTML 共享一條隱性規律

01起點 · 你唔知自己有啲乜,就唯有每次重複造輪子

第一個 HTML 叫《知墨覺醒 · 69 Skill 生態》。

粘貼圖片

Bricolage Grotesque + JetBrains Mono + Noto Sans SC,黑底紫光,8 層明度梯度。打開係 8 層架構鋪開:L8 元能層 21 個、L7 通用腳手架 9 個、L6 認知引擎 14 個,一直到 L1 產品決策 4 個。

但係呢個 HTML 真正嘅作用,唔係將 69 個 skill 列曬出嚟。

係令我睇到關係。

光列清單冇用。69 個名擺喺度,同 Finder 文件夾冇分別。三軸一交叉就唔同喇——按 L 層分一刀、按思維家族(ModelForge 系 6 個變體)分一刀、按覺醒系列(Awaken 橫跨 4 層 6 成員)再分一刀。

我先至睇到原來 ModelForge 唔係孤立嘅,佢有 5 個領域專屬變體跨住 L1/L2/L5。

我先至睇到原來「覺醒系列」係一條隱性主線——L8 三件套(Think + Grill + Zoomout)+ AwakenSession 守會話 + AwakenExp 守經驗 + AwakenConstitution 守契約。

盤點唔等於睇到。盤點係將嘢擺出嚟。睇到係將關係畫出嚟。

第一個 HTML 解決嘅係:我有啲乜 + 佢哋之間嘅關係

呢個 HTML 我開過無數次。每次入新會話俾人問「你想用邊個 skill」,我會先打開佢掃一眼——篩「覺醒系列」揾思維腳手架、篩「L6 決策三件套」揾路徑選擇類、篩新建標記揾最近一個月嘅產物。Finder 俾唔到呢種「按維度刀切」嘅能力,飛書文檔都俾唔到。

插圖 1|盤點不等於看見

02中段 · 睇到唔夠,要知道改邊度

第二個 HTML 叫《OmniThink Writer 全景迭代決策儀表盤 v2.0.3》。

粘貼圖片

5 視圖(流程/架構/路由/功能/演進)、36 節點、每個節點 health 三色(綠 32 / 黃 4 / 紅 0)。SHIPPED 24 件、BACKLOG 3 件。每個節點點開係 hover tooltip + click modal + localStorage 寫筆記。

呢個 HTML 係第一個之上多做咗一件事——佢逼我直面「下一步改邊度」

儀表盤最容易死嘅方法係變成 PPT。靚嘅進度條、好睇嘅健康度,冇人睇。所以呢一版我整咗三個硬約束:

  • 節點 health 必須有真理由(reason 字段、source 字段、weakness 字段、iterationHint 字段全部填滿)
  • TOP 候選必須帶 ROI 徽章(S/M/L 改動量 + 收益 + 風險三色)
  • D5 演進時間軸必須帶死代碼考古(每版嘅「呢條路行錯咗」顯性化)

我封裝 omnithink-writer v1.6 嗰次——5 case 真測試跑出一個事實:humanize-forge 翻轉句式仍然係 v1.2 老硬限制 ≤1,冇同步到 v1.6 嘅密度閾值。

如果只睇 v1.6 SKILL. md,我以為修好咗。

打開儀表盤 D5 時間軸一睇,「反思 v1.5.1」嗰條線仲係紅色——我先至意識到:v1.6.1 patch 一定要做,要將隔籬 skill 嘅閾值同步。

第二個 HTML 解決嘅係:下一步改邊度 + 改嘅依據

我做呢個儀表盤之前,每次諗到「omnithink 應該升下一版啦」——我都要喺 SKILL. md 裏面翻 800 行揾邊度有 weakness 標註。而家 D5 時間軸一拉,36 個節點嘅紅黃綠一目瞭然,3 個 BACKLOG 候選帶 ROI 徽章排好——下一步應該改邊度唔係判斷題,係睇圖題。

03協同 · 單 skill 自洽唔夠,跨 module 協議必須可見

第三個 HTML 唔係關於 skill 嘅,係關於一個量化交易系統——《來財 v3.0.5 · G6.13 協同手冊》。

粘貼圖片

但形態完全可以遷移到 skill 協同。

187 KB,monospace 終端美學(SF Mono / Menlo / Consolas)。tabbar 多視圖 + KPI 卡 + bar 進度條 + modal + mermaid 圖引擎 + tailwindcss。

佢解決一個問題:協議寫喺 markdown 裏面冇人讀

我將 omnithink Tier-1/Tier-2 + humanize-forge 協同寫喺 SKILL. md 裏面——冇人睇。包括我自己。

但係來財 G6.13 協同手冊我每次都打開。點解?

唔係因為來財更重要。係因為佢用 KPI 令我一眼睇到今日應該做啲乜。邊個 module 係 active 狀態、邊個等緊輸入、邊條協議俾人觸發咗幾次——全部喺首屏。

呢個係 markdown 俾唔到嘅——markdown 係線性嘅,協議係網狀嘅

扯遠一句。我後來反思 omnithink 嘅 v1.6 協議——如果佢整成同款活手冊(tabbar + KPI + 跨 skill 協議觸發可視化),周知同 Claude 都唔會再「唔記得 humanize-forge 閾值要同步」。

第三個 HTML 解決嘅係:跨 module 協議點樣活起嚟

來財 G6.13 協同手冊我而家每日打開五到十次。佢唔係文檔,係我嘅工作面板。邊個 module 應該啓動咗、邊條協議觸發頻次異常、上次 G 值係幾多——首屏直接俾。我自己都唔記得呢啲數字,係佢替我記住。

插圖 2|協議寫在 Markdown 裏沒人讀

04閉環 · 單項目封裝都要有進度地圖

第四個 HTML 形態唔係單個文件,係一組——《zhouzhis-gzh-agent v1.0 封裝路線》。

~/zhou/projects/zhouzhis-gzh-agent-v1.0/PROGRESS. md + context-packet. yaml

5 phase 串行:PreFlight 調度 → AwakenThink + ModelForge 決策 → cc-agent-creator 主體 → Self-Iteration 收斂(V(1) 8.125 → V(2) 9.125)→ 端到端測試。每步完成自動 ✅。

佢解決嘅唔係「睇到」,係「可追溯"。

每次 agent 封裝係一次性事件,但流程唔係。我下次封裝第個 agent(例如 xiaohongshu-agent)嘅時候,5 phase 模板可以直接抄。

更關鍵嘅係 context-packet. yaml——呢個唔係俾我讀嘅,係俾下一次嘅 Claude 讀嘅。下一次啓動新會話,將 yaml 餵返過去,agent 就可以恢復整條上下文鏈。

PROGRESS. md 俾人睇,context-packet. yaml 俾 agent 睇。一份內容兩種受眾。

第四個 HTML 解決嘅係:單次封裝可追溯 + 跨次封裝可繼承

今次封裝 zhouzhis-gzh-agent v1.0,PreFlight 自動落盤咗 PROGRESS. md。三日後我重啓 Claude 想升級 v1.1 嘅時候,將 context-packet. yaml 餵返過去,新會話直接知道 V(1) 8.125 → V(2) 9.125 呢條迭代軌跡——唔需要我從頭解釋一次。呢啲係飛書文檔做唔到嘅事,因為飛書文檔唔會俾 agent 讀。

05道 · 4 個 HTML 共享一條隱性規律

寫到呢度你可能發現咗——4 個 HTML 形態完全不同,但佢哋做嘅係同一件事

令我睇到我自己嘅工作流程。

唔係替我作決定,係令我睇到決定


形態
睇到啲乜
我可以做到啲乜
生態全景
我有啲乜
睇,唔可以改
決策儀表盤
我下一步改邊度
睇 + 寫筆記
協同手冊
跨 module 協議點行
睇 + 調起對應 module
進度地圖
今次封裝到邊一步
睇 + 落盤到下次

← 左右滑動睇更多 →


所有 HTML 都令我「睇到」,關鍵決策權我自己留。

呢條規律喺我所有自研工具裏面都一致——cc-agent-creator 嘅信任度校準、SoloConsultForge 嘅階段化判斷、AwakenThink 嘅默會探針、啱啱封裝完嘅 zhouzhis-gzh-agent v1.0 嘅 J1-J5 協議。

「降本不取代」係我所有自研工具嘅元設計原則

HTML 將呢條哲學物理化咗。

反過來——如果某個 HTML 有一日開始自動改自己(active learning 跑出新推薦、自動調整節點 health),佢就違反咗呢條元規律。我會失去對工作流程嘅掌控感。

鏡嘅價值唔係反射得有幾靚,係佢只係反射、唔會替你作決定

06收束

大部分人唔需要呢種鏡。

佢哋嘅工作流程冇複雜到值得鏡像化——md 筆記夠、飛書文檔夠、Notion 模板夠。呢樣冇咩唔好。工具應該匹配工作流程嘅複雜度,唔係反轉嚟。

但係如果你做嘅嘢已經多到自己睇唔清——。

HTML 唔係文檔工具,係令你睇到自己嘅工具。

我用 4 個 HTML 管 69 個 skill 同十幾個 AI 員工。下一個 HTML 喺路上——係俾「小紅書 agent」嗰一版整嘅。

可能仲會有第六個、第七個。但元規律唔會變:。

HTML 係鏡。我留拍板權

插圖 3|HTML 是鏡子,我留拍板權

唔只係教 AI,仲陪你做 AI 小生意。

我係用 AI 開一人公司嘅周知,下次再傾。

周知 · 我哋一齊同 AI 覺醒超級個體


上週三晚上,我盯着 Finder 那個文件夾發呆。

~/Library/Application Support/Claude/local-agent-mode-sessions/skills-plugin/.../skills/

裏面有 69 個文件夾。每個文件夾是我自己寫的 skill。

我有 69 個 skill,但我不知道我有什麼。

這事兒哪裏不對,但我說不上來。

之前我是 MD  管理,只到我做了第一個 HTML。從那以後陸續做了第三、第四個。今天封裝完 zhouzhis-gzh-agent v1.0 之後,回頭看——我用 HTML 管 skill 和 agent 這條路,已經走了 4 個版本。

不是飛書,不是 Notion,不是 Obsidian,不是 Roam。

是 HTML。

全文概要圖|4 個 HTML 共享一條隱性規律

01起點 · 你不知道自己有什麼,就只能每次重複造輪子

第一個 HTML 叫《知墨覺醒 · 69 Skill 生態》。

粘貼圖片

Bricolage Grotesque + JetBrains Mono + Noto Sans SC,黑底紫光,8 層明度梯度。打開是 8 層架構鋪開:L8 元能層 21 個、L7 通用腳手架 9 個、L6 認知引擎 14 個,一直到 L1 產品決策 4 個。

但這個 HTML 真正的作用,不是把 69 個 skill 列出來。

是讓我看見關係。

光列清單沒用。69 個名字擺在那裏,跟 Finder 文件夾沒區別。三軸一交叉就不一樣了——按 L 層分一刀、按思維家族(ModelForge 系 6 個變體)分一刀、按覺醒系列(Awaken 橫跨 4 層 6 成員)再分一刀。

我才看見原來 ModelForge 不是孤立的,它有 5 個領域專屬變體跨着 L1/L2/L5。

我才看見原來"覺醒系列"是一條隱性主線——L8 三件套(Think + Grill + Zoomout)+ AwakenSession 守會話 + AwakenExp 守經驗 + AwakenConstitution 守契約。

盤點不等於看見。盤點是把東西擺出來。看見是把關係畫出來。

第一個 HTML 解決的是:我有什麼 + 它們之間什麼關係

這個 HTML 我開了無數次。每次進新會話被問"你想用哪個 skill",我先打開它掃一眼——篩"覺醒系列"找思維腳手架、篩"L6 決策三件套"找路徑選擇類、篩新建標記找最近一個月的產物。Finder 給不了這種"按維度刀切"的能力,飛書文檔也給不了。

插圖 1|盤點不等於看見

02中段 · 看見了不夠,得知道改哪

第二個 HTML 叫《OmniThink Writer 全景迭代決策儀表盤 v2.0.3》。

粘貼圖片

5 視圖(流程/架構/路由/功能/演進)、36 節點、每個節點 health 三色(綠 32 / 黃 4 / 紅 0)。SHIPPED 24 件、BACKLOG 3 件。每個節點點開是 hover tooltip + click modal + localStorage 寫筆記。

這個 HTML 在第一個之上多做了一件事——它逼我直面"下一步改哪"

儀表盤最容易的死法是變成 PPT。漂亮的進度條、好看的健康度,沒人看。所以這一版我做了三個硬約束:。

  • 節點 health 必須有真理由(reason 字段、source 字段、weakness 字段、iterationHint 字段全填)
  • TOP 候選必須帶 ROI 徽章(S/M/L 改動量 + 收益 + 風險三色)
  • D5 演進時間軸必須帶死代碼考古(每版的"這條路走錯了"顯性化)

我封裝 omnithink-writer v1.6 那次——5 case 真測試跑出來一個事實:humanize-forge 翻轉句式還是 v1.2 老硬限 ≤1,沒同步到 v1.6 的密度閾值。

如果只看 v1.6 SKILL. md,我以為修完了。

打開儀表盤 D5 時間軸一看,"反思 v1.5.1"那條線還紅着——我才意識到:v1.6.1 patch 必須做,得把鄰居 skill 的閾值同步。

第二個 HTML 解決的是:下一步改哪 + 改的依據

我做這個儀表盤前,每次想到"omnithink 該升下一版了"——我都得在 SKILL. md 裏翻 800 行找哪些地方有 weakness 標註。現在 D5 時間軸一拉,36 個節點的紅黃綠一目瞭然,3 個 BACKLOG 候選帶 ROI 徽章排好——下一步該改哪不是判斷題,是看圖題。

03協同 · 單 skill 自洽不夠,跨 module 協議必須可見

第三個 HTML 不是關於 skill 的,是關於一個量化交易系統——《來財 v3.0.5 · G6.13 協同手冊》。

粘貼圖片

但形態完全可遷移到 skill 協同。

187 KB,monospace 終端美學(SF Mono / Menlo / Consolas)。tabbar 多視圖 + KPI 卡 + bar 進度條 + modal + mermaid 圖引擎 + tailwindcss。

它解決一個問題:協議寫在 markdown 裏沒人讀

我把 omnithink Tier-1/Tier-2 + humanize-forge 協同寫在 SKILL. md 裏——沒人翻。包括我自己。

但來財 G6.13 協同手冊我每次都打開。為什麼?

不是因為來財更重要。是因為它用 KPI 讓我一眼看見今天該做什麼。哪個 module 在 active 狀態、哪個在等輸入、哪條協議被觸發了幾次——全在首屏。

這是 markdown 給不了的——markdown 是線性的,協議是網狀的

扯遠一句。我後來反思 omnithink 的 v1.6 協議——它如果做成同款活手冊(tabbar + KPI + 跨 skill 協議觸發可視化),周知和 Claude 都不會再"忘了 humanize-forge 閾值要同步"。

第三個 HTML 解決的是:跨 module 協議怎麼活起來

來財 G6.13 協同手冊我現在每天打開五到十次。它不是文檔,是我的工作面板。哪個 module 該啓動了、哪條協議觸發頻次異常、上次 G 值是多少——首屏直接給。我自己都不記得這些數,是它替我記着。

插圖 2|協議寫在 Markdown 裏沒人讀

04閉環 · 單項目封裝也得有進度地圖

第四個 HTML 形態不是單個文件,是一組——《zhouzhis-gzh-agent v1.0 封裝路線》。

~/zhou/projects/zhouzhis-gzh-agent-v1.0/PROGRESS. md + context-packet. yaml

5 phase 串行:PreFlight 調度 → AwakenThink + ModelForge 決策 → cc-agent-creator 主體 → Self-Iteration 收斂(V(1) 8.125 → V(2) 9.125)→ 端到端測試。每步完成自動 ✅。

它解決的不是"看見",是"可追溯"。

每次 agent 封裝是一次性事件,但流程不是。我下次封裝別的 agent(比如 xiaohongshu-agent)的時候,5 phase 模板可以直接抄。

更關鍵的是 context-packet. yaml——這不是給我讀的,是給下一次的 Claude 讀的。下一次啓動新會話,把 yaml 喂回去,agent 就能恢復整條上下文鏈。

PROGRESS. md 給人看,context-packet. yaml 給 agent 看。一份內容兩種受眾。

第四個 HTML 解決的是:單次封裝可追溯 + 跨次封裝可繼承

這次封裝 zhouzhis-gzh-agent v1.0,PreFlight 自動落盤了 PROGRESS. md。三天後我重啓 Claude 想升級 v1.1 的時候,把 context-packet. yaml 喂回去,新會話直接知道 V(1) 8.125 → V(2) 9.125 這條迭代軌跡——不需要我從頭解釋一遍。這是飛書文檔做不到的事,因為飛書文檔不會被 agent 讀。

05道 · 4 個 HTML 共享一條隱性規律

寫到這裏你可能發現了——4 個 HTML 形態完全不同,但它們做的是同一件事

讓我看見我自己的工作流。

不是替我做決定,是讓我看見決定


形態
看見什麼
我能做什麼
生態全景
我有什麼
看,不可改
決策儀表盤
我下一步改哪
看 + 寫筆記
協同手冊
跨 module 協議怎麼走
看 + 調起對應 module
進度地圖
這次封裝到哪一步
看 + 落盤到下次

← 左右滑動查看更多 →


所有 HTML 都讓我"看見",關鍵決策權我自己留。

這條規律在我所有自研工具裏都一致——cc-agent-creator 的信任度校準、SoloConsultForge 的階段化判斷、AwakenThink 的默會探針、剛封裝完的 zhouzhis-gzh-agent v1.0 的 J1-J5 協議。

「降本不取代」是我所有自研工具的元設計原則

HTML 把這條哲學物理化了。

反過來——如果某個 HTML 哪天開始自動改自己(active learning 跑出新推薦、自動調整節點 health),它就違反了這條元規律。我會失去對工作流的掌控感。

鏡子的價值不是反射得多漂亮,是它只反射、不替你做決定

06收束

大部分人不需要這種鏡子。

他們的工作流不復雜到值得鏡像化——md 筆記夠、飛書文檔夠、Notion 模板夠。這沒什麼不好。工具應該匹配工作流的複雜度,不是反過來。

但如果你做的事情已經多到自己看不清——。

HTML 不是文檔工具,是讓你看見自己的工具。

我用 4 個 HTML 管 69 個 skill 和 十幾個 AI 員工。下一個 HTML 在路上——是給"小紅書 agent"那一版做的。

也許還會有第六個、第七個。但元規律不會變:。

HTML 是鏡子。我留拍板權

插圖 3|HTML 是鏡子,我留拍板權

不只是教 AI,更陪你做 AI 小生意。

我是用 AI 開一人公司的周知,下回聊。

周知 · 我們一起和 AI 覺醒超級個體