當前 Skills 簡介
02｜當前 Skills 簡介（附說明與盤點證據）
述職摘要：目前 main agent 可辨識 57 項技能，其中本回合可用、模型可見的技能為 21 項；36 項雖隨軟體提供，但依 CLI 檢查尚缺執行條件。技能的價值是把工具使用方法、來源查核、授權與驗收方式寫成可重複流程，而非憑安裝即可獲得所有服務能力。
一、盤點時間、範圍與結論
- 盤點時間：2026-10-20 13:57（Asia/Taipei，UTC+8）；OpenClaw 2026.9.8（fc23bc8）。
- 範圍：本 Gateway 的 main agent；實際執行
openclaw skills list --agent main --json、openclaw skills check --agent main --json，對照本回合注入的available_skills。不是其他代理、其他主機或所有個人技能庫的全面稽核。 - 57 項目錄項目；21 項 eligible / modelVisible；20 項 commandVisible；36 項 missingRequirements。 明確 disabled、allowlist blocked、agentFiltered、notInjected 均為 0。
browser-automation可供模型使用，但宣告user-invocable: false，因此 21 項模型可見不等於 21 個使用者斜線命令。- 本次只做唯讀盤點、閱讀文件及輸出報告；未逐項執行技能工作流程，未安裝套件、修改設定、呼叫模型或寫入預算資料庫。
來源分布（以本次勝出的技能定義計數）
| 來源 | 目錄總數 | 本回合可用 | 說明 |
|---|---|---|---|
| Bundled／隨 OpenClaw 附帶 | 49 | 13 | …/openclaw/skills/；其餘 36 項缺條件 |
| Custodian／系統維運技能 | 4 | 4 | …/openclaw/custodian-skills/；CLI source 為 openclaw-custodian |
| Plugin／外掛技能路徑 | 2 | 2 | ~/.openclaw/plugin-skills/；CLI 統一標為 openclaw-extra |
| Workshop／代理學習流程 | 2 | 2 | ~/.openclaw/agents/main/agent/workshop-skills/ |
| Workspace／專案技能 | 0 | 0 | 本 workspace 的 skills/、.agents/skills/ 均不存在；本次目錄沒有這類勝出項目 |
本次未發現 shared managed 或 personal-agent 來源的勝出項目；這不代表其他位置絕無檔案，也不把磁碟上的歷史副本計為可執行技能。
二、Skills 是什麼？與 Tool、代理、模型有何不同？
- Skill（技能）：以
SKILL.md的 YAML frontmatter（名稱、描述、依賴等）與正文構成的操作教材；可附 scripts、references、assets。先注入簡介，任務匹配時再讀正文及必要資源，避免每次攜帶全部文件。 - Tool（工具）：真正執行讀檔、shell、瀏覽器、查詢或服務動作的介面。例如
read、exec、browser、memory_search是工具，不另計為技能。即使工具與技能同名（如 canvas），兩者仍不同。 - Agent（代理）：承接任務與授權邊界，使用模型、技能與工具的執行角色；子代理是任務委派，不是新技能。
- Model（模型）：提供理解、推理、生成或本地視覺辨識能力。安裝技能不等於安裝模型，也不會自動取得模型服務憑證。
- 可用性分層：檔案存在 → 被目錄發現 → 通過環境／設定／binary 條件 → 本回合可見 → 實際工具可用且授權 → 任務端到端成功。前一層不保證後一層。尤其
eligible=true只代表宣告條件通過，不能證明 Notion 登入、雲端權限或瀏覽器連線正常。 - 載入優先序：workspace > project-agent > personal-agent > managed/local > Workshop > bundled/Custodian > extra/plugin；同名取較高優先來源。技能仍受工具政策、使用者指示與實際服務限制約束，不能自行擴權。
三、本回合可用技能簡介（21 項）
以下「可用」一律指 CLI eligible、modelVisible 且本回合列出，不表示本次端到端實測。來源縮寫：B＝Bundled、C＝Custodian、P＝Plugin 路徑（CLI extra）、W＝Workshop。
A. 文書與資料解析（1 項）
| 技能／中文名 | 用途與典型情境 | 來源／狀態 | 依賴或限制 |
|---|---|---|---|
budget-local-first／預算文件本地優先解析 |
預算 PDF 普通表、左右跨頁寬表、敘述文字；本地抽取、來源 gate、局部疑義處理及可追溯修正 | W／可用 | 綁定既有專案、runner、來源 manifest、現有本地模型及來源專用 family；不是任意 PDF 通用解析器。詳見第四節 |
B. 瀏覽、可視化與資訊呈現（7 項）
| 技能／中文名 | 用途與典型情境 | 來源／狀態 | 依賴或限制 |
|---|---|---|---|
browser-automation／瀏覽器自動化 |
網頁多步操作、登入狀態確認、分頁整理、過期 ref 復原 | P／可用；非使用者直接命令 | 需 browser 工具與可用 profile；先 snapshot 再動作；登入、CAPTCHA、2FA 可能需人工 |
canvas／原生展示面板 |
將 hosted widget 顯示於已連線 Mac 面板，顯示／隱藏／導覽 | P／可用 | 需合格連線節點、hosted document 路由與相關工具；host disabled 時不可用；不可任意杜撰本機或外部網址 |
control-ui／控制介面與儀表板管理 |
整理 session、分頁、面板及 widget；遠端 Control UI 排錯 | B／可用 | 使用實際提供的 typed UI tools；先讀狀態；需連線客戶端才能驗證畫面，發布不等於渲染成功 |
diagram-maker／流程與架構圖製作 |
產出獨立 SVG/HTML，或可編輯 Excalidraw；適用流程、架構及概念圖 | B／可用 | 需檔案輸出及語法檢查；獨立 SVG 模式不依賴遠端資源；Excalidraw 需正確 JSON 結構 |
visualize／互動視覺與儀表板內容 |
程式架構、執行追蹤、比較圖、互動說明及持續儀表板 | B／可用 | 需當回合提供 show_widget 等介面；CDN 有白名單，資料能力另授權；需實際渲染與互動驗證 |
meme-maker／梗圖製作 |
搜尋／推薦模板、產生本地 SVG/PNG 或託管梗圖 | B／可用 | 需 Node；模板下載需網路，PNG 需瀏覽器；Imgflip 模式另需帳密，不能因 eligible 宣稱已設定 |
weather／天氣與出行資訊 |
查當前溫度、降雨、預報及旅遊規劃 | B／可用 | 優先 web_fetch，備援 curl；需地點與外部網路；重大警報、航空航海以官方氣象來源為準 |
C. 系統維運與開發驗證（9 項）
| 技能／中文名 | 用途與典型情境 | 來源／狀態 | 依賴或限制 |
|---|---|---|---|
add-model-provider／模型供應商接入 |
設定模型路由與 SecretRef，並以真實推論確認接入 | C／可用 | 需明確授權、適用 provider/harness、有效憑證；設定完成不等於推論成功，不可洩露 key |
configure-channel／通訊渠道設定 |
接入聊天渠道、保留 allowlist 與既有存取政策、確認投遞 | C／可用 | 需供應商憑證與渠道權限；實際操作遵循本回合遮罩設定及 messaging 工具政策，不能以舊 CLI 範例繞過工具限制 |
cloud-image-bake／雲端 Worker 映像烘焙 |
建立、選用及測試預裝工具的雲端映像，降低啟動成本 | C／可用 | 需 crabbox、適用 backend、雲端憑證與支出授權；映像刪除需明確確認；本次未確認雲端依賴 |
diagnose-gateway／Gateway 唯讀診斷 |
設定、SecretRef owner、渠道、連接埠與啟動故障查因 | C／可用 | 限唯讀；doctor --lint 不等於可改用普通 doctor；不修設定、不重啟服務 |
healthcheck／主機安全健檢 |
檢視 SSH、防火牆、更新、暴露面、備份與磁碟加密 | B／可用 | 先確認主機與存取路徑；寫入及強化操作需同意，不能宣稱 OpenClaw 自動管理 OS 安全設定 |
node-connect／裝置與節點連線診斷 |
分辨 Control UI 瀏覽器與原生 app，依路由、認證、配對階段排錯 | B／可用 | 必須鎖定正確 Gateway／客戶端並證明新連線；代碼或已配對清單不等於連線成功 |
node-inspect-debugger／Node.js 偵錯 |
中斷點、非同步卡住、CPU、heap 與 CDP 調查 | B／可用 | Node 已通過宣告條件；需目標程式及權限，遠端 inspector 不得隨意對外暴露 |
python-debugpy／Python 互動偵錯 |
使用 breakpoint、pdb、post-mortem 或 debugpy 排查局部狀態 | B／可用 | Python3 通過條件；debugpy 套件與 PID attach 權限未因此保證；先最小重現，確認目標後才附加 |
spike／可行性快速原型 |
以最小可跑程式及失敗案例比較方案，給出可行／部分／不可行判定 | B／可用 | 不是正式產品實作；能用文件回答就不做原型；依賴與授權按實際題目另查 |
D. 記憶、知識與流程治理（4 項）
| 技能／中文名 | 用途與典型情境 | 來源／狀態 | 依賴或限制 |
|---|---|---|---|
notion／Notion 知識庫操作 |
頁面、Markdown、資料來源、檔案、留言、搜尋與 Workers | B／可用 | metadata 為 ntn 或 curl 擇一；可用不等於已登入或已授權頁面；Workers 可能需方案／workspace 開通 |
context-compaction-verification／長對話壓縮驗證 |
區分 context overflow、單次超大輸入、timeout、restart；驗證真正保存的摘要 | W／可用 | 需正式 compact 結果及 before/after token；短測成功不能推論長對話自動復原成功，不可重設對話冒充修復 |
clawhub／技能搜尋與管理 |
能力不足時搜尋既有技能、檢查來源，再依要求安裝／更新／發布 | B／可用 | 管理安裝需明確要求；部分發布／移除流程需 standalone clawhub；本次沒有查遠端或安裝 |
skill-creator／技能設計與驗證 |
將流程整理為 SKILL.md、references、scripts、assets，檢查結構與 helper | B／可用 | 技能所有權及目前 Workshop 政策優先；本報告不建立／修補技能，不把文件閱讀當驗證腳本已通過 |
記憶搜尋／長期記憶本身在此環境屬工具與工作區規則，沒有另算一個「memory skill」。
四、重點說明：budget-local-first
1. 工作分工與預期價值
此技能是既有政府預算解析工程的可重複作業規範。正常批次由 local code／已設定本地模型處理；GPT 用於工程指揮、debug 及證據充分的局部疑義，不逐批／逐格進行常規 GPT 覆核。 Python 決定性回取的數值必須歸因於程式，不能說成模型辨識成果。
2. 標準流程（已完整閱讀現行 SKILL.md）
- 鎖定授權與來源：明確批次或剩餘文件範圍、輸出路徑、是否可寫正式庫；讀專案 README、pipeline_contract、runner
--help與來源 manifest。保存 PDF 年版、實體／印刷頁碼及 hash；恢復前檢查 checkpoint、暫停狀態與重複 worker。 - 分類本地處理：普通表用 PyMuPDF4LLM 與原生 PDF 結構／值映射；左右寬表先按來源座標配對合併、保留換行名稱與祖先表頭，再走 frozen local VLM；敘述先保存完整章節、段落、條列及跨頁文字，Gemma 摘要／分類另存 derived，失敗不阻擋 raw 保存。
- 來源 gates：保留原名、印刷代碼／繼承代碼、年份、單位、Decimal、原文、頁碼／bbox；檢查覆蓋、重複、欄位綁定、父層與跨頁附註。無法辨識、新 family 或證據不足就 pending，不以成功產生檔案冒充驗收。
- 修正重用：先查 sealed packets、已覆核封包與明確註冊的 source-verified correction store；匹配 PDF hash、契約版本、record/path/unit/old value 與來源引用。修正採 append-only corrected view，保留 raw 及歷史；單欄修正不提升整筆為人工驗證。
- 局部疑義封包：每 issue 最多 3,000 字元、合包最多 9,000 字元；完整產物留本地。必要時合併少量相關疑義，提供 inline evidence、短結構輸出，不讓 reviewer 讀整本或每格開代理。回填前驗證 ID、舊值、path、quote、bbox 與來源身份。
- 驗收與停止：分別報批次、raw/source hash、欄位與整筆指標、敘述保存、pending、冪等恢復、模型呼叫次數；來源頁覆蓋以實際引用聯集計，抵達末頁不代表前面的待處理都完成。cache replay 不算 fresh extraction，引用一致不算語意／人工驗證；到授權邊界即止。
- 正式入庫另授權：runner 與 promotion 分離，正式寫入需明確授權、backup/restore、source gates 與 append-only／idempotent 檢核，不自行開下一批或排程。
3. 現行規則衝突：來源空白不得直接改成 0
現行 SKILL.md 第 4 步仍有舊文句：清楚可見且有意義的原生數字空白「may become zero」。這與 2026-10-20 的 USER.md 現行指令衝突。執行應以 USER／有效來源契約優先，不能照舊文句補零。
單文件抽取必須以該文件為唯一原始值權威：確認的原生空白保持 blank／NULL，另存 source-blank 狀態及頁／格 provenance；文件未明示時，不擅自推定為 0、不適用或無意義。不得拿其他文件的值替換，也不得強制補空白。 衍生計算與跨文件比較另存；忠實抽取完成不以外部語意補強為必要條件。本次只揭露衝突，未自主修改 Workshop 技能。
4. 能力邊界與「已完成」的正確口徑
- 技能不是一套下載後即可解析任意 511 頁 PDF 的通用引擎。現行 README 描述歷史 frozen fixtures／source-specific family；新來源仍需 adapter、manifest、runner 及來源 gate，不能憑安裝技能就承諾全書成功。
- 來源庫的完成狀態必須即時讀目前 FINAL run-report，不能引用舊 collector、舊腳本、revision 備份或歷史剩餘缺陷數當現在結果。
- 本次實際讀取
data/kaohsiung-budget/document-116-production-20261007/FINAL-single-pdf-acceptance/run-report.json：狀態為completed_single_pdf_faithful_extraction_bounded_standards；13 個 family 通過各自明列的 bounded standards；必要結構 gate、實際轉錄 pending、remaining defects 均為 0；whole_document_faithful_extraction_complete=true、source_blank_NULLverified=true。 - 同報告記載 preferred effective records 6,074、source physical records 6,351、superseded history 277、source fields 34,834；canonical unchanged=true、worker_running=false、new_model_calls=0。這些是 live 報告所載數據，本次未重跑 DB 查核或重新逐格驗證。
- 因此可以說「該指定單一 PDF 的來源忠實抽取，已依明列 bounded standards 完成」；不可擴寫成全部預算語意驗證、全書人工逐筆驗證、跨文件計畫數統計完成，或其他 PDF 已通過。人工確認只限報告明列的局部範圍。
五、附帶但本回合未就緒的技能（36 項）
以下皆 CLI source=openclaw-bundled，eligible=false、modelVisible=false；已讀各 SKILL.md frontmatter 以確認用途及宣告依賴。它們是軟體附帶的定義，不表示相關 CLI、應用或服務已安裝／登入。表中的缺項以本次 skills check 為證；未另外探測外部服務。
| 技能／中文名 | 用途／典型情境 | 已證缺少的條件 |
|---|---|---|
1password／密碼庫操作 |
讀取／注入授權秘密 | op |
apple-notes／Apple 備忘錄 |
筆記搜尋、編修與匯出 | memo |
apple-reminders／Apple 提醒事項 |
查詢、建立及完成提醒 | remindctl |
bear-notes／Bear 筆記 |
建立及搜尋 Bear 知識筆記 | grizzly |
blogwatcher／部落格與 RSS 追蹤 |
追蹤新文章 | blogwatcher |
blucli／BluOS 音響控制 |
播放、群組及音量 | blu |
camsnap／攝影機擷取 |
RTSP／ONVIF／本機鏡頭截圖及片段 | camsnap |
coding-agent／外部程式代理委派 |
委派 Codex／Claude Code／OpenCode 開發工作 | claude／codex／opencode 至少一個；另缺 skills.entries.coding-agent.enabled 條件（不是 disabled=true） |
eightctl／Eight Sleep 控制 |
睡眠設備狀態、溫度與鬧鐘 | eightctl |
gemini／Gemini CLI 操作 |
單次摘要、生成或 Gemma 路由 | gemini；不代表本地其他 Gemma 路徑也不可用 |
gh-issues／GitHub 問題修復流程 |
取 issue、派代理、開 PR 及處理 review | gh |
gifgrep／GIF 搜尋 |
搜圖、下載與抽影格 | gifgrep |
github／GitHub CLI 管理 |
issues、PR、CI、release、API 查詢 | gh |
gog／Google Workspace 操作 |
郵件、日曆、Drive、試算表與文件 | gog |
goplaces／Google 地點查詢 |
搜尋地點、細節及評論 | goplaces、GOOGLE_PLACES_API_KEY 環境條件 |
himalaya／郵件 CLI |
IMAP／SMTP 收發與整理 | himalaya |
mcporter／MCP CLI 管理 |
設定、認證、檢視與呼叫 MCP 工具 | mcporter；MCP 工具本身不是 skill |
model-usage／模型成本統計 |
讀 CodexBar 本機成本紀錄 | codexbar |
nano-pdf／自然語言編修 PDF |
按指令改 PDF | nano-pdf；與預算抽取 skill 不同 |
obsidian／Obsidian 知識庫 |
vault 筆記、任務、連結與屬性 | obsidian |
openai-whisper／本地語音轉文字 |
離線語音逐字稿 | whisper |
openai-whisper-api／雲端語音轉文字 |
OpenAI 音訊轉錄 | OPENAI_API_KEY 環境條件 |
openhue／Hue 燈光控制 |
燈具及場景控制 | openhue |
oracle／第二模型審查 |
帶選定檔案做 review／debug | oracle |
ordercli／餐飲訂單查詢 |
Foodora 歷史及當前訂單 | ordercli；Deliveroo 仍屬 WIP |
peekaboo／macOS UI 自動化 |
畫面擷取與介面操作 | peekaboo |
sag／ElevenLabs 語音合成 |
文字轉語音 | sag；未因此判定帳戶憑證可用 |
sherpa-onnx-tts／離線語音合成 |
本地 ONNX TTS | SHERPA_ONNX_RUNTIME_DIR、SHERPA_ONNX_MODEL_DIR 環境條件 |
songsee／音訊特徵視覺化 |
頻譜及音訊分析圖 | songsee |
sonoscli／Sonos 播放控制 |
探索、播放、音量與群組 | sonos |
spotify-player／Spotify 終端播放 |
音樂搜尋與播放 | spogo／spotify_player 至少一個 |
summarize／多媒體摘要轉錄 |
網頁、影片、podcast、PDF 與本機檔案摘要 | summarize |
things-mac／Things 待辦管理 |
收件匣、今日任務、專案與標籤 | things |
tmux／互動終端會話控制 |
讀 pane、送按鍵與監控提示 | tmux |
trello／Trello 看板管理 |
board／list／card 操作 | TRELLO_API_KEY、TRELLO_TOKEN 環境條件 |
xurl／X 平台 CLI |
貼文、搜尋、私訊與媒體 | xurl |
六、證據、說明文件與尚未驗證事項
本機可追溯證據
- skills-evidence.json：57 項 CLI 狀態、來源、缺項、每個 SKILL.md frontmatter、檔案 SHA-256、去識別化路徑及 FINAL 摘要。
- 程式隨附文件根目錄：
~/.openclaw/tools/node-v24.21.0/lib/node_modules/openclaw/。docs/tools/skills.md：機制、來源、優先序及 gating。docs/cli/skills.md：list／info／check 等 CLI 語義。skills/<name>/SKILL.md、custodian-skills/<name>/SKILL.md：隨附技能說明。
- 外掛說明：
~/.openclaw/plugin-skills/{browser-automation,canvas}/SKILL.md。 - Workshop 說明：
~/.openclaw/agents/main/agent/workshop-skills/{budget-local-first,context-compaction-verification}/SKILL.md。 - 預算規則：工作區
USER.md、projects/kaohsiung-budget/pipeline-batch/README.md與第四節所列 live FINAL run-report；本次沒有修改任何規則文件。
官方說明連結
誠實揭露驗證範圍
本次實測的是 CLI 盤點介面與檔案可讀性，不是技能端到端能力。第三節全部 21 項（budget-local-first、browser-automation、canvas、clawhub、cloud-image-bake、configure-channel、context-compaction-verification、control-ui、diagnose-gateway、diagram-maker、healthcheck、meme-maker、node-connect、node-inspect-debugger、notion、python-debugpy、skill-creator、spike、visualize、weather、add-model-provider）的實際任務流程，以及第五節 36 項流程，均未在本次執行。未確認項目包括服務登入、雲端工具／憑證、面板／瀏覽器連線、可視化渲染、Python debugpy、預算新來源 adapter 與全套 source gates。必要時應按具體授權任務再做小範圍 live proof，不能寫成「全部技能均已實測正常」。