1. 數(shù)字員工場(chǎng)景下為什么你的 Agent Skills 總是“跑一次就廢”數(shù)字員工這個(gè)詞這兩年很熱但真正落地時(shí)大多數(shù)人卡在同一個(gè)地方零散操作沉淀不下來(lái)。一個(gè)運(yùn)營(yíng)同事每天要做的“拉取日?qǐng)?bào)數(shù)據(jù) → 清洗 → 生成圖表 → 發(fā)到群里”你讓他錄個(gè)屏錄完就是一段 20 分鐘的視頻沒(méi)人愿意看第二遍你讓工程師寫成文檔寫出來(lái)的又是給人看的 SOPAgent 讀不懂、執(zhí)行不了。我試過(guò)把這類任務(wù)直接丟給大模型結(jié)果很典型模型能復(fù)述步驟但一到“點(diǎn)擊哪個(gè)按鈕、等哪個(gè)元素出現(xiàn)、失敗了怎么重試”就全靠編。原因不復(fù)雜——自然語(yǔ)言 SOP 和可執(zhí)行 Agent Skill 之間缺了一層“蒸餾”。所謂 Agent Skills 快速蒸餾就是把原始素材錄屏、歷史文檔、聊天記錄經(jīng)過(guò)語(yǔ)義解析、SOP 精化最終封裝成一份結(jié)構(gòu)化的SKILL.md再配上 Tools 和 Prompts讓 Agent 能真正跑起來(lái)。而 Playwright 驗(yàn)證是檢驗(yàn)這份 Skill 到底“能不能用”的最后一道關(guān)。這篇文章聚焦數(shù)字員工場(chǎng)景給你三樣能直接抄的東西一份可復(fù)制的SKILL.md模板、一份蒸餾檢查清單、一段 Playwright 驗(yàn)證腳本。同時(shí)演示怎么用 TaoToken 的統(tǒng)一 Key/API 通道把“蒸餾 → 調(diào)用 → 結(jié)果校驗(yàn)”串成一條線。適合誰(shuí)適合正在做企業(yè)內(nèi)部 Agent 平臺(tái)、想把業(yè)務(wù)專家經(jīng)驗(yàn)變成可復(fù)用 Skill 的工程師和產(chǎn)品同學(xué)。核心檢索詞先擺出來(lái)Agent Skills 蒸餾、SKILL.md 結(jié)構(gòu)、Playwright 自動(dòng)化驗(yàn)證、TaoToken 統(tǒng)一 Key。下面從方法論到代碼一步步來(lái)。2. TaoToken 前置準(zhǔn)備統(tǒng)一 Key 打通蒸餾與驗(yàn)證鏈路在講 SKILL.md 之前先把“通道”這件事說(shuō)清楚。數(shù)字員工場(chǎng)景里蒸餾階段要調(diào) LLM 做語(yǔ)義解析和 SOP 生成驗(yàn)證階段要調(diào) LLM 做結(jié)果校驗(yàn)如果每個(gè)環(huán)節(jié)各接一個(gè)模型供應(yīng)商Key 管理會(huì)非常亂。TaoToken 的價(jià)值就在這里一個(gè) Key、一個(gè) Base URL覆蓋多個(gè)模型的調(diào)用蒸餾和驗(yàn)證走同一條通道省掉反復(fù)配置的麻煩。你需要準(zhǔn)備三件套缺一不可配置項(xiàng)值說(shuō)明Base URLhttps://taotoken.net/api統(tǒng)一 API 入口不加任何多余路徑API Key在控制臺(tái)創(chuàng)建形如sk-xxxx只顯示一次務(wù)必保存Model ID按需選擇蒸餾用長(zhǎng)上下文模型驗(yàn)證用快模型獲取 Key 的入口在控制臺(tái)創(chuàng)建后建議立刻寫進(jìn)環(huán)境變量不要硬編碼在腳本里export TAOTOKEN_API_KEYsk-你的key export TAOTOKEN_BASE_URLhttps://taotoken.net/api如果你用的是 Claude Code 這類編碼 Agent配置方式略有不同需要寫進(jìn) settings 文件。下面這段是可直接復(fù)制的 JSON 片段路徑按你的實(shí)際安裝位置調(diào)整{ env: { ANTHROPIC_BASE_URL: https://taotoken.net/api, ANTHROPIC_API_KEY: sk-你的key, ANTHROPIC_MODEL: 你的Model ID } }注意Base URL 和 Key 必須成對(duì)出現(xiàn)只改其中一個(gè)會(huì)出現(xiàn) 401。Model ID 要和你在控制臺(tái)看到的名稱完全一致大小寫敏感。為什么強(qiáng)調(diào)“統(tǒng)一 Key”因?yàn)檎麴s流程里至少有兩類調(diào)用一類是語(yǔ)義解析把錄屏動(dòng)作序列轉(zhuǎn)成結(jié)構(gòu)化 SOP需要長(zhǎng)上下文另一類是結(jié)果校驗(yàn)判斷 Playwright 跑出來(lái)的結(jié)果是否符合成功標(biāo)準(zhǔn)需要低延遲。用同一個(gè) Key 切換 Model ID 即可不用維護(hù)兩套憑證。配置完成后先用一條最小請(qǐng)求確認(rèn)通道是通的curl https://taotoken.net/api/v1/chat/completions \ -H Authorization: Bearer $TAOTOKEN_API_KEY \ -H Content-Type: application/json \ -d { model: 你的Model ID, messages: [{role: user, content: 回復(fù) OK}] }返回里能看到choices[0].message.content就說(shuō)明通道正常。這一步別跳過(guò)后面所有蒸餾和驗(yàn)證都依賴它。如果這里就報(bào)錯(cuò)先去看第 5 節(jié)的排障對(duì)照表。3. SKILL.md 結(jié)構(gòu)拆解與可復(fù)制模板含蒸餾檢查清單SKILL.md 是 Agent Skills 的核心載體。它和普通文檔最大的區(qū)別是它是給 Agent 讀的不是給人讀的。所以結(jié)構(gòu)必須固定、字段必須可解析、觸發(fā)條件必須明確。一份合格的 SKILL.md 至少包含六塊Goal目標(biāo)、When to Use觸發(fā)場(chǎng)景、Workflow工作流、Success Criteria成功標(biāo)準(zhǔn)、Tools Required依賴工具、Never Do反模式。下面這份模板可以直接復(fù)制把占位內(nèi)容替換成你的業(yè)務(wù)即可# Skill: 日?qǐng)?bào)數(shù)據(jù)自動(dòng)匯總 ## Goal 從指定數(shù)據(jù)源拉取當(dāng)日指標(biāo)清洗后生成圖表輸出到指定目錄。 ## When to Use - 用戶提到日?qǐng)?bào)數(shù)據(jù)匯總生成圖表 - 觸發(fā)詞日?qǐng)?bào)、匯總、指標(biāo)、圖表 ## Workflow 1. 拉取數(shù)據(jù) - 動(dòng)作調(diào)用數(shù)據(jù)接口獲取當(dāng)日指標(biāo) - 工具DataFetcher - 輸出原始 JSON 2. 清洗數(shù)據(jù) [決策點(diǎn)] - IF 存在空值 → 用前一日值填充并記錄 - IF 字段缺失 → 跳過(guò)該指標(biāo)并告警 3. 生成圖表 - 動(dòng)作調(diào)用繪圖工具輸出 PNG - 工具ChartBuilder 4. 結(jié)果校驗(yàn) - 動(dòng)作檢查圖表文件是否存在且非空 ## Success Criteria - [ ] 輸出目錄存在當(dāng)日 PNG 文件 - [ ] 文件大小 10KB - [ ] 無(wú)未處理異常 ## Tools Required - DataFetcher數(shù)據(jù)接口封裝 - ChartBuilder圖表生成 ## Never Do - 不校驗(yàn)文件是否存在就直接返回成功 - 硬編碼日期必須用運(yùn)行時(shí)日期模板有了關(guān)鍵是怎么從零散素材蒸餾出這些內(nèi)容。給你一份檢查清單逐項(xiàng)打勾檢查項(xiàng)要求為什么重要WHAT WHEN 觸發(fā)詞清晰描述做什么、何時(shí)做Agent 能自主判斷調(diào)用時(shí)機(jī)專家知識(shí)占比 70% 非基礎(chǔ)常識(shí)確保 Skill 有獨(dú)特價(jià)值行數(shù)控制 300 行保持原子性便于組合調(diào)試When to Use明確觸發(fā)場(chǎng)景避免誤調(diào)用代碼示例可執(zhí)行片段降低使用門檻Never Do反模式警示防止常見錯(cuò)誤蒸餾的四個(gè)層次從下往上遞進(jìn)原始素材錄屏/文檔→ 語(yǔ)義層動(dòng)作意圖→ 結(jié)構(gòu)化 SOP步驟決策點(diǎn)異常→ Agent Skill可執(zhí)行。大多數(shù)人失敗在第二層直接把錄屏丟給模型讓它“總結(jié)一下”結(jié)果得到一段廢話。正確做法是先解析成動(dòng)作序列再生成 SOP最后封裝。舉個(gè)具體例子。錄屏里專家做了“打開后臺(tái) → 篩選日期 → 導(dǎo)出 CSV → 上傳到共享盤”四步其中“篩選日期”時(shí)他停頓了一下說(shuō)“如果昨天數(shù)據(jù)沒(méi)跑完就選前天”。這句話就是隱性知識(shí)必須進(jìn) SKILL.md 的決策點(diǎn)2. 篩選日期 [決策點(diǎn)] - 默認(rèn)選擇昨日 - IF 昨日數(shù)據(jù)未就緒 → 選擇前日并記錄原因沒(méi)有這一步Agent 遇到數(shù)據(jù)延遲就會(huì)卡死或報(bào)錯(cuò)。這就是蒸餾和“讓模型總結(jié)”的本質(zhì)區(qū)別。4. Playwright 驗(yàn)證腳本用統(tǒng)一 Key 校驗(yàn) Skill 是否真能跑SKILL.md 寫完不算完必須驗(yàn)證。數(shù)字員工場(chǎng)景里最直接的驗(yàn)證方式是用 Playwright 把 Skill 描述的操作跑一遍再用 LLM 判斷結(jié)果是否符合 Success Criteria。先裝依賴npm init -y npm install -D playwright/test npx playwright install chromium下面是一段可復(fù)制的驗(yàn)證腳本它做兩件事執(zhí)行頁(yè)面操作然后把執(zhí)行結(jié)果發(fā)給 TaoToken 做語(yǔ)義校驗(yàn)。import { test, expect } from playwright/test; const BASE_URL process.env.TAOTOKEN_BASE_URL!; const API_KEY process.env.TAOTOKEN_API_KEY!; const MODEL_ID process.env.TAOTOKEN_MODEL_ID!; async function verifyWithLLM(executionLog: string): Promiseboolean { const resp await fetch(${BASE_URL}/v1/chat/completions, { method: POST, headers: { Authorization: Bearer ${API_KEY}, Content-Type: application/json, }, body: JSON.stringify({ model: MODEL_ID, messages: [ { role: system, content: 你是驗(yàn)證器。根據(jù)執(zhí)行日志判斷是否滿足成功標(biāo)準(zhǔn)只回復(fù) PASS 或 FAIL。, }, { role: user, content: 成功標(biāo)準(zhǔn)輸出目錄存在當(dāng)日 PNG 文件且大小 10KB。\n執(zhí)行日志${executionLog}, }, ], }), }); const data await resp.json(); const verdict data.choices?.[0]?.message?.content?.trim(); return verdict PASS; } test(日?qǐng)?bào) Skill 端到端驗(yàn)證, async ({ page }) { const logs: string[] []; await page.goto(https://你的后臺(tái)地址/login); logs.push(打開登錄頁(yè)成功); await page.fill(#username, process.env.TEST_USER!); await page.fill(#password, process.env.TEST_PASS!); await page.click(button[typesubmit]); await page.waitForURL(**/dashboard); logs.push(登錄成功進(jìn)入 dashboard); await page.click(text數(shù)據(jù)導(dǎo)出); await page.waitForSelector(.export-panel); logs.push(打開導(dǎo)出面板); await page.click(button:has-text(導(dǎo)出 CSV)); const download await page.waitForEvent(download); const path await download.path(); logs.push(下載完成${path}); const passed await verifyWithLLM(logs.join(\n)); expect(passed).toBe(true); });運(yùn)行TAOTOKEN_MODEL_ID你的Model ID npx playwright test實(shí)測(cè)下來(lái)這套流程能抓出 SKILL.md 里 80% 的模糊描述。比如你寫“點(diǎn)擊導(dǎo)出按鈕”但頁(yè)面上有兩個(gè)同名按鈕Playwright 會(huì)直接報(bào) strict mode violation逼你把選擇器寫精確。這正是驗(yàn)證的價(jià)值——把自然語(yǔ)言的模糊性在自動(dòng)化階段暴露出來(lái)。提示驗(yàn)證腳本里的選擇器要和 SKILL.md 里描述的元素一致。如果 Skill 寫“點(diǎn)擊導(dǎo)出按鈕”腳本里卻用坐標(biāo)點(diǎn)擊那驗(yàn)證就失去意義了。5. 常見報(bào)錯(cuò)排查401、local proxy failed 與 reading choices蒸餾和驗(yàn)證過(guò)程中報(bào)錯(cuò)集中在幾個(gè)地方。下面按真實(shí)錯(cuò)誤信息對(duì)照排查。401 Unauthorized。最常見九成是 Key 或 Base URL 配錯(cuò)。檢查順序環(huán)境變量是否真的導(dǎo)出echo $TAOTOKEN_API_KEY、Key 是否有多余空格、Base URL 是否誤寫成帶/v1的完整路徑。注意 Base URL 就是https://taotoken.net/api請(qǐng)求路徑里再拼/v1/chat/completions。local proxy failed / connection refused。這類錯(cuò)誤通常出現(xiàn)在本地網(wǎng)絡(luò)環(huán)境異常時(shí)。先確認(rèn)你的請(qǐng)求地址拼寫正確再檢查是否有本地工具攔截了請(qǐng)求。如果是在公司內(nèi)網(wǎng)確認(rèn)出口策略允許訪問(wèn)該域名。不要試圖通過(guò)任何非正規(guī)網(wǎng)絡(luò)手段繞過(guò)合規(guī)環(huán)境下的正常配置即可。Cannot read properties of undefined (reading choices)。說(shuō)明返回體里沒(méi)有choices字段通常是請(qǐng)求體格式不對(duì)。檢查messages是否是數(shù)組、model字段是否拼寫正確。如果返回的是錯(cuò)誤對(duì)象先打印完整響應(yīng)再解析const data await resp.json(); if (!data.choices) { console.error(原始響應(yīng), JSON.stringify(data)); throw new Error(響應(yīng)缺少 choices 字段); }OAuth / token expired。如果你用的是 Claude Code 或類似編碼 Agent配置寫進(jìn) settings 后仍報(bào)鑒權(quán)失敗檢查三件套是否齊全Base URL、Key、Model ID。缺任何一個(gè)都會(huì)失敗。特別是 Model ID必須和控制臺(tái)顯示完全一致。Playwright 超時(shí)。waitForSelector超時(shí)多半是選擇器寫錯(cuò)或者頁(yè)面加載慢。先用page.pause()打開調(diào)試器手動(dòng)確認(rèn)選擇器再寫進(jìn)腳本。不要用waitForTimeout硬等那是反模式SKILL.md 的 Never Do 里應(yīng)該明確禁止。報(bào)錯(cuò)根因處理401Key/URL 配錯(cuò)核對(duì)環(huán)境變量與 Base URLlocal proxy failed網(wǎng)絡(luò)環(huán)境異常檢查請(qǐng)求地址與出口策略reading choices請(qǐng)求體格式錯(cuò)打印原始響應(yīng)再解析OAuth 失敗三件套缺失補(bǔ)全 Base URL Key Model IDPlaywright 超時(shí)選擇器錯(cuò)誤用 page.pause() 調(diào)試排查完這些你的蒸餾鏈路基本就穩(wěn)了。剩下的就是持續(xù)迭代每次 Agent 執(zhí)行失敗把失敗案例回流成新的錄屏素材重新蒸餾進(jìn) SKILL.md。6. 從蒸餾到驗(yàn)證把統(tǒng)一 Key 用成數(shù)字員工的底座回到最開始的問(wèn)題為什么很多團(tuán)隊(duì)的 Agent Skills 跑一次就廢因?yàn)槿绷恕罢麴s”和“驗(yàn)證”這兩個(gè)閉環(huán)。蒸餾把隱性知識(shí)變成結(jié)構(gòu)化 SKILL.md驗(yàn)證用 Playwright 把模糊描述逼成精確操作而 TaoToken 的統(tǒng)一 Key 讓這兩步走同一條通道不用在多個(gè)供應(yīng)商之間來(lái)回切換。你可以這樣操作先拿一個(gè)高頻、邊界清晰的業(yè)務(wù)任務(wù)比如日?qǐng)?bào)匯總按第 3 節(jié)的模板寫一份 SKILL.md用第 4 節(jié)的腳本跑一遍驗(yàn)證。跑通之后再把這個(gè)模式復(fù)制到第二個(gè)、第三個(gè)任務(wù)。每復(fù)制一次檢查清單過(guò)一遍失敗案例回流一次。需要?jiǎng)?chuàng)建 Key 或查看接入細(xì)節(jié)可以從這里進(jìn)API Keys 管理在 console接入文檔在 doc。想先驗(yàn)證模型對(duì)話效果用 模型對(duì)話 快速試如果是長(zhǎng)期做編碼類 AgentCoding Plan 更合適。最后一個(gè)實(shí)用技巧SKILL.md 里的 Success Criteria 一定要寫成可機(jī)器判斷的形式?！皥D表好看”不行“文件大小 10KB”才行。你寫驗(yàn)證腳本時(shí)會(huì)發(fā)現(xiàn)凡是能被 Playwright 斷言的才是真正可執(zhí)行的 Skill。