1. 從 spec-driven-development 沒反應(yīng)說起先把宿主模型入口接對裝完 agent-skills 后我第一次在 Codex 里輸入 spec-driven-development 沒有任何反應(yīng)切到 Claude Code 又找不到 /spec。排查下來不是 Skill 沒裝好而是宿主模型入口、適配層和路由沒有對齊。我先把模型入口接到 TaoTokenhttps://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_contentusing_agent_skills_route再把 Base URL https://taotoken.net/api 填進(jìn)宿主配置才讓 using-agent-skills 正常判斷該調(diào)哪個 Skill。這篇不是 agent-skills 的新聞復(fù)述而是一份嘗鮮記錄如何用 using-agent-skills 做任務(wù)路由、如何把 25 個 Skill 變成可執(zhí)行清單、如何記錄 Token 消耗、如何用 TaoToken 的 Base URL 跑通 Claude Code / Codex / CC Switch。最后你能拿到三樣?xùn)|西路由判斷表、Skill 清單、調(diào)用記錄模板。先明確一點(diǎn)using-agent-skills 不負(fù)責(zé)實(shí)現(xiàn)它負(fù)責(zé)判斷。它看的是當(dāng)前任務(wù)處于哪個階段、缺什么信息、風(fēng)險在哪、需要什么證據(jù)然后告訴你該調(diào)用 interview-me、spec-driven-development、planning-and-task-breakdown、test-driven-development、debugging、security-hardening 等 Skill 中的哪一個或哪幾個。只有路由正確后面的 Token 才不是亂燒。準(zhǔn)備工作很簡單去 TaoToken 官網(wǎng)注冊并創(chuàng)建 API Keyhttps://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_contentusing_agent_skills_route把 Key 保存到本地環(huán)境變量不要寫進(jìn)要提交的倉庫。Base URL 固定為 https://taotoken.net/api注意這個地址不加 UTM 參數(shù)UTM 只用于官網(wǎng)和文檔入口。接下來分別配置 Claude Code、Codex 和 CC Switch。2. TaoToken 接入三套配置Claude Code、Codex、CC Switch 不要混用2.1 Claude Codesettings.json 或 ANTHROPIC_* 環(huán)境變量Claude Code 讀取的是 Anthropic 風(fēng)格變量配置時用 ANTHROPIC_BASE_URL 和 ANTHROPIC_AUTH_TOKEN?？梢栽趡/.claude/settings.json寫{ env: { ANTHROPIC_BASE_URL: https://taotoken.net/api, ANTHROPIC_AUTH_TOKEN: YOUR_API_KEY, ANTHROPIC_MODEL: claude-sonnet-4-5 } }如果不想改文件也可以在啟動前導(dǎo)出export ANTHROPIC_BASE_URLhttps://taotoken.net/api export ANTHROPIC_AUTH_TOKENYOUR_API_KEY export ANTHROPIC_MODELclaude-sonnet-4-5檢查是否生效claude --version env | grep ANTHROPIC注意不要把 ANTHROPIC_* 這套變量套到 CodexCodex 不讀它們。2.2 Codexconfig.toml 用 TAOTOKEN_API_KEYCodex 走自己的config.toml。在~/.codex/config.toml中增加 providermodel gpt-5-codex model_provider taotoken [model_providers.taotoken] name TaoToken base_url https://taotoken.net/api env_key TAOTOKEN_API_KEY wire_api responses然后在 shell 里設(shè)置export TAOTOKEN_API_KEYYOUR_API_KEY這里不要寫 ANTHROPIC_AUTH_TOKEN也不要用 ANTHROPIC_BASE_URL。Codex 需要較新的 CLI 才支持原生插件式 Skill 調(diào)用安裝 agent-skills 后重開會話再用 spec-driven-development 這類名稱觸發(fā)。如果 沒反應(yīng)先確認(rèn) Codex 版本和會話是否重啟再看 config.toml 是否被正確讀取。2.3 CC Switch 三件套Base URL、API Key、模型名如果你用 CC Switch 管理多個供應(yīng)商核心就是三件套Base URLhttps://taotoken.net/apiAPI KeyYOUR_API_KEY模型名Claude Code 選 claude-sonnet-4-5Codex 選 gpt-5-codex在 CC Switch 里新增一個 Provider名稱寫 TaoToken把三件套填進(jìn)去然后切換當(dāng)前宿主使用的 Provider。切換后重啟 Claude Code 或 Codex 會話。如果出現(xiàn) 401先查 Key如果出現(xiàn) 404先查 Base URL 是否多寫了/v1或路徑如果命令能跑但 Skill 不觸發(fā)查宿主適配層和 Skill 安裝目錄而不是先改 Base URL。統(tǒng)一檢查表宿主配置文件/入口關(guān)鍵字段不要混用Claude Codesettings.json / 環(huán)境變量ANTHROPIC_BASE_URL、ANTHROPIC_AUTH_TOKEN不要把 ANTHROPIC_* 給 CodexCodexconfig.tomlmodel_providers.taotoken.base_url、env_key不要用 ANTHROPIC_AUTH_TOKENCC SwitchProvider 面板Base URL、API Key、模型名三件套要成套切換3. using-agent-skills 怎么判斷一張路由表把 25 個 Skill 串起來using-agent-skills 的職責(zé)是路由不是執(zhí)行。它通常先問四個問題當(dāng)前處于定義、計劃、實(shí)現(xiàn)、驗證、審查、發(fā)布中的哪一段已知信息夠不夠這次改動最可能壞在哪里完成后拿什么證據(jù)證明沒跑偏?；卮鹜暝佥敵?Skill 調(diào)用順序。下面這張表可以作為嘗鮮時的路由判斷表。實(shí)際名稱以你本地skills/目錄和 SKILL.md 為準(zhǔn)但判斷邏輯可以直接用。觸發(fā)信號路由結(jié)論建議調(diào)用 Skill停止條件需要的證據(jù)需求只有一句話邊界不清先不要實(shí)現(xiàn)interview-me能列出用戶、場景、反例、不做清單問題清單與回答需求能說清但缺規(guī)格先固定契約spec-driven-development接口、數(shù)據(jù)、驗收標(biāo)準(zhǔn)可寫進(jìn) SPECSPEC 文檔任務(wù)跨多個模塊先拆小planning-and-task-breakdown每個子任務(wù)可獨(dú)立驗證任務(wù)列表與依賴準(zhǔn)備改實(shí)現(xiàn)先寫失敗測試test-driven-developmentRed-Green-Refactor 走完失敗與通過測試輸出有可復(fù)現(xiàn) Bug先復(fù)現(xiàn)再修debugging復(fù)現(xiàn)步驟穩(wěn)定修復(fù)后有防護(hù)復(fù)現(xiàn)記錄、回歸測試接口要新增或變更先定契約api-design請求、響應(yīng)、錯誤碼、版本策略明確接口文檔與示例前端狀態(tài)復(fù)雜先理狀態(tài)與交互frontend-engineering狀態(tài)、可訪問性、邊界狀態(tài)覆蓋組件測試或截圖涉及鑒權(quán)、輸入、密鑰先做威脅建模security-hardening風(fēng)險項有處理或明確接受安全檢查清單頁面/接口變慢先測量再改performance-optimization有基線、改動、復(fù)測對比profile 與對比數(shù)據(jù)要接流水線先穩(wěn)定構(gòu)建ci-cd構(gòu)建、測試、發(fā)布步驟可重復(fù)流水線日志上線后要定位問題先補(bǔ)可觀測性observability日志、指標(biāo)、追蹤能回答故障問題儀表盤或查詢結(jié)果準(zhǔn)備合并進(jìn)入審查code-review、test-review、security-review、web-performance-review風(fēng)險項有結(jié)論審查記錄準(zhǔn)備發(fā)布做發(fā)布檢查ship發(fā)布清單、回滾方案、負(fù)責(zé)人明確發(fā)布說明這張表的作用不是把 25 個 Skill 背下來而是讓 using-agent-skills 每次都按同一套維度輸出路由。你可以把這張表當(dāng)作人工復(fù)核如果 Agent 直接跳到 test-driven-development 而沒有先走 spec-driven-development就要問它為什么。需要強(qiáng)調(diào)路由本身也會消耗 Token。但這段 Token 花得值因為它阻止模型在錯誤需求上生成大段實(shí)現(xiàn)。真正的浪費(fèi)不是路由而是跳過路由直接產(chǎn)出不可驗收的代碼。4. 25 個 Skill 清單與調(diào)用記錄把“用了哪個”變成可追溯安裝 agent-skills 后不要只看 README 的列表。建議在項目根目錄做三件事列出實(shí)際安裝的 Skill抽取每個 SKILL.md 的適用時機(jī)和停止條件為每次任務(wù)建一條調(diào)用記錄。命令示例npx skills list npx skills add using-agent-skills npx skills add spec-driven-development npx skills add planning-and-task-breakdown npx skills add test-driven-development如果已經(jīng)整倉克隆也可以直接查看ls skills/ find skills -maxdepth 2 -name SKILL.md | sort生成 Skill 清單時可以用這個 Markdown 模板| Skill | 階段 | 適用時機(jī) | 停止條件 | 依賴的 references | | --- | --- | --- | --- | --- | | using-agent-skills | 路由 | 不知道該調(diào)哪個 Skill | 輸出調(diào)用順序與證據(jù)清單 | 無 | | interview-me | 定義 | 需求模糊 | 邊界和反例明確 | 需求檢查清單 | | spec-driven-development | 定義 | 需求可寫但缺規(guī)格 | SPEC 可驗收 | 規(guī)格模板 | | planning-and-task-breakdown | 計劃 | 任務(wù)大、跨模塊 | 子任務(wù)可獨(dú)立驗證 | 任務(wù)拆解清單 | | test-driven-development | 驗證 | 準(zhǔn)備改實(shí)現(xiàn) | 失敗測試轉(zhuǎn)通過 | 測試清單 | | debugging | 驗證 | 有可復(fù)現(xiàn) Bug | 復(fù)現(xiàn)穩(wěn)定且有回歸 | 調(diào)試清單 | | api-design | 實(shí)現(xiàn) | 接口新增/變更 | 契約明確 | 接口檢查清單 | | frontend-engineering | 實(shí)現(xiàn) | 前端狀態(tài)復(fù)雜 | 邊界狀態(tài)覆蓋 | 前端清單 | | security-hardening | 審查 | 涉及鑒權(quán)/輸入/密鑰 | 風(fēng)險有結(jié)論 | 安全清單 | | performance-optimization | 驗證 | 性能下降 | 基線-改動-復(fù)測 | 性能清單 | | ci-cd | 發(fā)布 | 接流水線 | 構(gòu)建發(fā)布可重復(fù) | CI 清單 | | observability | 發(fā)布 | 上線排障 | 日志指標(biāo)追蹤可用 | 可觀測性清單 | | code-review | 審查 | 準(zhǔn)備合并 | 審查意見閉環(huán) | 評審清單 | | ship | 發(fā)布 | 準(zhǔn)備上線 | 發(fā)布與回滾明確 | 發(fā)布清單 |注意這里只列了嘗鮮最常碰到的 Skill倉庫里的 25 個以你本地實(shí)際目錄為準(zhǔn)。不要為了湊清單去猜名稱直接find出來的最可靠。調(diào)用記錄模板| 時間 | 任務(wù) | using-agent-skills 路由結(jié)論 | 實(shí)際調(diào)用 Skill | Token 消耗關(guān)注點(diǎn) | 產(chǎn)出證據(jù) | 人工確認(rèn) | | --- | --- | --- | --- | --- | --- | --- | | 2026-xx-xx | 訂單查詢加分頁 | 規(guī)格→計劃→測試→性能→審查 | spec-driven-development、planning-and-task-breakdown、test-driven-development、performance-optimization、code-review | 路由提示詞、測試輸出、profile | SPEC.md、任務(wù)列表、測試日志、profile | 接口契約、分頁邊界、SQL 本地執(zhí)行 |Token 消耗關(guān)注點(diǎn)不要只寫“用了多少”要寫“花在哪”。例如路由提示詞占多少、每個 Skill 的上下文多大、測試輸出是否被完整塞回模型、重復(fù)總結(jié)是否造成浪費(fèi)。這樣你才能優(yōu)化而不是單純壓縮上下文。5. 實(shí)操讓 using-agent-skills 跑一次完整路由以“給已有訂單查詢接口增加分頁”為例嘗鮮流程如下。第一步不寫實(shí)現(xiàn)只讓路由 Skill 判斷。提示詞可以這樣你現(xiàn)在只做路由不寫實(shí)現(xiàn)。 讀取 skills/using-agent-skills/SKILL.md。 任務(wù)給已有訂單查詢接口增加分頁默認(rèn) 20 條支持 page 和 page_size。 現(xiàn)狀接口已有缺少分頁數(shù)據(jù)庫是本地測試庫SQL 由我本地執(zhí)行。 請輸出 1. 當(dāng)前處于哪個階段 2. 應(yīng)調(diào)用的 Skill 列表與順序 3. 每個 Skill 的停止條件 4. 每個 Skill 需要產(chǎn)出的證據(jù) 5. 哪些步驟必須人工確認(rèn)第二步檢查路由結(jié)果。一個合理輸出可能是1. 階段定義與計劃優(yōu)先。 2. 調(diào)用順序 spec-driven-development planning-and-task-breakdown test-driven-development performance-optimization code-review 3. 停止條件 spec分頁參數(shù)、默認(rèn)值、邊界、錯誤響應(yīng)明確。 plan拆成接口契約、查詢改造、測試、性能驗證。 tdd先有失敗測試再實(shí)現(xiàn)到通過。 performance有基線、改動、復(fù)測對比。 review風(fēng)險項有結(jié)論。 4. 證據(jù)SPEC、任務(wù)列表、失敗/通過測試輸出、profile、審查記錄。 5. 人工確認(rèn)接口契約、分頁邊界、SQL 在本地執(zhí)行。第三步按順序調(diào)用 Skill。每次調(diào)用只把必要上下文交給模型當(dāng)前 SPEC、當(dāng)前任務(wù)、上次測試輸出。不要把整個倉庫和所有歷史日志一次性塞進(jìn)去。第四步保存證據(jù)。測試輸出、profile 結(jié)果、審查意見都寫入調(diào)用記錄。第五步人工確認(rèn)。尤其是接口契約、SQL、合并前差異和安全檢查。Skill 能要求 Agent 給證據(jù)但不能替代人的最終判斷。這里再給一個 Codex/Claude Code 通用的驗證清單# 1. 確認(rèn)宿主模型入口 claude --version codex --version # 2. 確認(rèn) Skill 目錄 ls skills/using-agent-skills/SKILL.md ls skills/spec-driven-development/SKILL.md # 3. 確認(rèn)調(diào)用記錄目錄 mkdir -p .agent-recordsSQL 和數(shù)據(jù)庫命令由讀者在本地測試庫執(zhí)行不要讓 Agent 直連生產(chǎn)庫也不要通過 MCP 或 Agent 去操作 Oracle/生產(chǎn)數(shù)據(jù)庫。6. 排障references 丟失、Codex 版本、VS Code Copilot 命令差異常見問題一單裝一個 Skill 后SKILL.md 里引用references/下的檢查清單但打開路徑不存在。原因是npx skills add name往往只復(fù)制skills/name/目錄不會帶上倉庫根目錄的共享references/。解決方式有三種整倉克隆把需要的檢查清單復(fù)制到對應(yīng) Skill 的references/或者改用能保留共享目錄的集成方式。遇到“找不到 checklist”的報錯時先查目錄結(jié)構(gòu)不要先懷疑模型。常見問題二在 Codex 里輸入spec-driven-development沒反應(yīng)。先確認(rèn) Codex CLI 版本是否支持原生插件重開會話再確認(rèn) Skill 是否安裝到了 Codex 能掃描的目錄。README 中的斜杠命令/spec、/plan、/build、/test、/review、/ship主要由特定適配層提供不是所有宿主都一模一樣。VS Code 版 GitHub Copilot 里找不到/spec就是典型情況CLI 和 VS Code 的安裝方式、調(diào)用入口不同。不要因為一個宿主沒有斜杠命令就認(rèn)為 Skill 沒裝成功。常見問題三改了 Base URL 后宿主仍然報鑒權(quán)失敗。按宿主分開查Claude Code查ANTHROPIC_BASE_URL和ANTHROPIC_AUTH_TOKEN是否生效。Codex查config.toml的base_url和env_key對應(yīng)環(huán)境變量不要看 ANTHROPIC_*。CC Switch查三件套是否成套特別是模型名是否和宿主匹配。常見問題四路由 Skill 沒有按預(yù)期調(diào)用具體 Skill。檢查兩件事提示詞是否明確要求“只做路由不寫實(shí)現(xiàn)”SKILL.md 是否被完整讀取。你可以要求 Agent 在輸出路由后再列出它讀取了哪些文件。如果它沒有讀取using-agent-skills/SKILL.md那它只是在憑訓(xùn)練記憶猜。7. 把 Token 花在路由和證據(jù)上下一步這樣接入agent-skills 的價值不在于多裝幾個 Skill而在于讓 Agent 先判斷任務(wù)該走哪條工程路徑再消耗 Token 執(zhí)行。using-agent-skills 是入口25 個 Skill 是步驟SKILL.md 里的停止條件和驗收要求是約束references/ 和 evals/ 是補(bǔ)充證據(jù)。你要留下的不是一段“看起來能跑”的代碼而是路由判斷表、Skill 清單和調(diào)用記錄。接入順序建議去 TaoToken 官網(wǎng)創(chuàng)建 API Keyhttps://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_contentusing_agent_skills_route把 Base URLhttps://taotoken.net/api填入 Claude Code 或 Codex安裝 using-agent-skills 和第一批具體 Skill用本文的路由表跑一次真實(shí)任務(wù)把每次調(diào)用寫入.agent-records/合并前人工確認(rèn)測試輸出、代碼差異和安全檢查。如果你還沒有 Key可以先從模型對話驗證接口再決定是否進(jìn)入 Coding Plan。文末入口按這個順序走模型對話https://taotoken.net/models/detail/chat?utm_sourcetaotoken_aicg_blog_endutm_contentusing_agent_skills_routeCoding Planhttps://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentusing_agent_skills_route創(chuàng)建 API Keyhttps://taotoken.net/console/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentusing_agent_skills_routeClaude Code 文檔https://taotoken.net/doc/ClaudeCodeAnthropic?utm_sourcetaotoken_aicg_blog_endutm_contentusing_agent_skills_route建議順序模型對話 → Coding Plan → 創(chuàng)建 API Key → 按 Claude Code 文檔完成宿主配置。先把 Base URL 接對再讓 using-agent-skills 決定 Token 花在哪個 Skill 上。