現(xiàn)的 skill 配置骨架)
1. 為什么我要把 evomap 和 TaoToken 綁在一起先說(shuō)清楚這套東西是什么、能做什么、適合誰(shuí)。evomap 是我在 Trae 里落地的一個(gè) skill 骨架它把 evolver 的 GEPGenome Evolution Protocol基因組進(jìn)化協(xié)議能力封裝成可復(fù)用的本地資產(chǎn)信號(hào)提取、基因選擇、變異構(gòu)建、人格狀態(tài)、進(jìn)化固化全部落在.trae/skills/evomap/目錄里。TaoToken 在這里扮演的角色是統(tǒng)一 Key/API 通道——不管 skill 里跑的是哪家模型請(qǐng)求都從同一個(gè)入口出去配置只維護(hù)一份。適合誰(shuí)適合已經(jīng)在用 Trae 寫(xiě)代碼、想讓 AI 基建“可復(fù)現(xiàn)、可交接”的人。你不需要懂 GEP 的全部細(xì)節(jié)但你需要愿意把配置寫(xiě)成文件、把驗(yàn)證寫(xiě)成命令。我踩過(guò)的坑是一開(kāi)始把 Key 散落在各個(gè) skill 的腳本里換一個(gè)環(huán)境就要重新找一遍后來(lái)統(tǒng)一到 TaoToken 之后交接時(shí)只需要給對(duì)方兩個(gè)文件——settings.json和config.toml。這篇的目標(biāo)很具體給你一套能直接復(fù)制的骨架跑通一次 skill 加載再演示一次報(bào)錯(cuò)排查。全程不涉及任何網(wǎng)絡(luò)工具只講本地配置和 API 通道。2. TaoToken 前置Key、通道與目錄約定在動(dòng)手寫(xiě) skill 之前先把 TaoToken 這一層準(zhǔn)備好。你需要一個(gè) API Key入口在控制臺(tái)的 API Keys 頁(yè)面https://taotoken.net/console/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi_keysutm_campaignrewrite 。拿到 Key 之后記住兩個(gè)地址官網(wǎng)是 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 基址是 https://taotoken.net/api 這個(gè)不加 UTM直接寫(xiě)進(jìn)配置。目錄約定我建議這樣Trae 的工作區(qū)根目錄下建.trae/skills/evomap/里面分scripts/、data/gep/、references/三層。scripts/放可執(zhí)行邏輯data/gep/放基因、膠囊、事件日志references/放協(xié)議說(shuō)明。這樣做的好處是 skill 的邊界清晰交接時(shí)整個(gè)目錄打包即可。注意Key 不要寫(xiě)進(jìn)SKILL.md或任何會(huì)被提交到版本庫(kù)的文件。我習(xí)慣把它放在環(huán)境變量里配置文件只引用變量名。TaoToken 的通道配置有兩個(gè)文件要區(qū)分settings.json管 Trae 側(cè)的 skill 注冊(cè)和模型入口config.toml管 evomap 腳本運(yùn)行時(shí)的參數(shù)。兩者職責(zé)不同不要混在一起寫(xiě)。3. 可復(fù)制配置settings.json 與 config.toml 骨架先給settings.json的骨架。這個(gè)文件放在.trae/下作用是告訴 Trae 有哪些 skill、模型請(qǐng)求走哪個(gè)通道。{ skills: { evomap: { path: .trae/skills/evomap, entry: scripts/evolve.js, enabled: true } }, model: { provider: taotoken, baseUrl: https://taotoken.net/api, apiKeyEnv: TAOTOKEN_API_KEY, defaultModel: claude-sonnet }, runtime: { nodePath: node, timeoutMs: 60000 } }這里的關(guān)鍵是apiKeyEnv指向環(huán)境變量而不是硬編碼。baseUrl就是 TaoToken 的 API 基址所有 skill 里的模型調(diào)用都從這里走。再給config.toml的骨架放在.trae/skills/evomap/下管 evomap 自己的運(yùn)行參數(shù)。[gep] data_dir data/gep genes_file data/gep/genes.json capsules_file data/gep/capsules.json events_file data/gep/events.jsonl [evolve] strategy repair max_cycles 3 review_mode false [channel] base_url https://taotoken.net/api api_key_env TAOTOKEN_API_KEY model claude-sonnetstrategy可以取repair、optimize、innovate分別對(duì)應(yīng)修復(fù)、優(yōu)化、創(chuàng)新三種基因策略。max_cycles控制一次進(jìn)化跑幾輪調(diào)試時(shí)設(shè)小一點(diǎn)。環(huán)境變量這樣設(shè)export TAOTOKEN_API_KEY你的KeyWindows 下用set TAOTOKEN_API_KEY你的Key或者寫(xiě)進(jìn)系統(tǒng)環(huán)境變量。設(shè)完之后用echo $TAOTOKEN_API_KEY確認(rèn)一下能讀到。4. 驗(yàn)證請(qǐng)求跑一次 skill 加載與進(jìn)化周期配置寫(xiě)完先驗(yàn)證 skill 能不能被加載。在 Trae 工作區(qū)根目錄執(zhí)行node .trae/skills/evomap/scripts/test.js這個(gè)測(cè)試腳本會(huì)檢查文件結(jié)構(gòu)完整性、模塊加載、信號(hào)提取、基因選擇、變異構(gòu)建這幾項(xiàng)。如果輸出里每一項(xiàng)都是 pass說(shuō)明 skill 骨架是通的。接著跑一次真實(shí)的進(jìn)化周期node .trae/skills/evomap/scripts/evolve.js run正常的話你會(huì)看到類(lèi)似這樣的輸出先打印當(dāng)前加載的基因數(shù)量然后列出從日志里提取到的信號(hào)再顯示選中的基因和構(gòu)建出的變異對(duì)象最后把這次進(jìn)化事件追加到events.jsonl。我實(shí)測(cè)下來(lái)第一次跑通常信號(hào)是空的因?yàn)檫€沒(méi)有歷史日志這是正常的——你可以手動(dòng)往data/gep/events.jsonl里寫(xiě)一條測(cè)試事件再跑一次就能看到信號(hào)被提取出來(lái)。驗(yàn)證模型通道是否走通可以用模型對(duì)話頁(yè)面發(fā)一條測(cè)試請(qǐng)求https://taotoken.net/model-chat?utm_sourcetaotoken_aicg_blog_endutm_contentmodel_chatutm_campaignrewrite 。如果那邊能正常返回說(shuō)明 Key 和通道沒(méi)問(wèn)題skill 里的調(diào)用也會(huì)走同一條路。如果你打算長(zhǎng)期跑編碼和 Agent 任務(wù)建議看一下 Coding Planhttps://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding_planutm_campaignrewrite 它更適合高頻調(diào)用的場(chǎng)景。5. 本篇常見(jiàn)錯(cuò)排查第一個(gè)高頻錯(cuò)誤是Cannot find module。這通常是settings.json里的path寫(xiě)錯(cuò)了或者entry指向的文件不存在。檢查.trae/skills/evomap/scripts/evolve.js是否真的在那個(gè)位置路徑是相對(duì)工作區(qū)根目錄的不是相對(duì).trae/。第二個(gè)是TAOTOKEN_API_KEY is not set。說(shuō)明環(huán)境變量沒(méi)生效。先確認(rèn)echo $TAOTOKEN_API_KEY有輸出如果沒(méi)有檢查是不是在另一個(gè)終端窗口設(shè)的或者寫(xiě)進(jìn)了.bashrc但沒(méi)source。Trae 啟動(dòng)時(shí)繼承的是啟動(dòng)那一刻的環(huán)境變量設(shè)完要重啟 Trae。第三個(gè)是Unsupported MIME type這類(lèi)模型返回格式錯(cuò)誤。這多半是config.toml里的model字段和實(shí)際請(qǐng)求的模型不匹配。TaoToken 的通道支持多個(gè)模型但 skill 里如果寫(xiě)死了某個(gè)模型名而通道那邊沒(méi)有對(duì)應(yīng)配置就會(huì)報(bào)格式錯(cuò)。把model改成通道里確認(rèn)可用的名字再跑一次。第四個(gè)是進(jìn)化周期跑完但events.jsonl沒(méi)變化。檢查data_dir的路徑是不是相對(duì)config.toml所在目錄。我一開(kāi)始寫(xiě)成絕對(duì)路徑換機(jī)器就失效了后來(lái)改成相對(duì)路徑才穩(wěn)定。第五個(gè)是 skill 加載了但 Trae 里看不到。確認(rèn)settings.json里enabled是true并且 Trae 重啟過(guò)。skill 注冊(cè)是在啟動(dòng)時(shí)讀的改完配置不重啟不生效。接入相關(guān)的文檔在這里https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 里面有通道參數(shù)和錯(cuò)誤碼的說(shuō)明排查時(shí)對(duì)著看會(huì)快很多。6. 把配置變成可交接的資產(chǎn)這套骨架跑通之后交接就變得很簡(jiǎn)單把.trae/skills/evomap/整個(gè)目錄打包加上settings.json和config.toml兩個(gè)文件對(duì)方設(shè)好TAOTOKEN_API_KEY環(huán)境變量就能復(fù)現(xiàn)你本地的行為。GEP 的基因和膠囊資產(chǎn)都在data/gep/里跟著目錄走不會(huì)丟。如果你用的是 Claude Code 這類(lèi)工具TaoToken 也有對(duì)應(yīng)的接入方式https://taotoken.net/claude-code-anthropic?utm_sourcetaotoken_aicg_blog_endutm_contentclaude_codeutm_campaignrewrite 配置邏輯和這里講的一致都是統(tǒng)一 Key 通道。最后留一個(gè)實(shí)用技巧每次改完config.toml先跑test.js再跑evolve.js run兩步都過(guò)了再提交。這樣能把配置錯(cuò)誤擋在提交之前交接時(shí)對(duì)方拿到的就是驗(yàn)證過(guò)的版本。 AI 基建：用 evomap + TaoToken 搭一套可復(fù)現(xiàn)的 skill 配置骨架
1. 為什么我要把 evomap 和 TaoToken 綁在一起先說(shuō)清楚這套東西是什么、能做什么、適合誰(shuí)。evomap 是我在 Trae 里落地的一個(gè) skill 骨架它把 evolver 的 GEPGenome Evolution Protocol基因組進(jìn)化協(xié)議能力封裝成可復(fù)用的本地資產(chǎn)信號(hào)提取、基因選擇、變異構(gòu)建、人格狀態(tài)、進(jìn)化固化全部落在.trae/skills/evomap/目錄里。TaoToken 在這里扮演的角色是統(tǒng)一 Key/API 通道——不管 skill 里跑的是哪家模型請(qǐng)求都從同一個(gè)入口出去配置只維護(hù)一份。適合誰(shuí)適合已經(jīng)在用 Trae 寫(xiě)代碼、想讓 AI 基建“可復(fù)現(xiàn)、可交接”的人。你不需要懂 GEP 的全部細(xì)節(jié)但你需要愿意把配置寫(xiě)成文件、把驗(yàn)證寫(xiě)成命令。我踩過(guò)的坑是一開(kāi)始把 Key 散落在各個(gè) skill 的腳本里換一個(gè)環(huán)境就要重新找一遍后來(lái)統(tǒng)一到 TaoToken 之后交接時(shí)只需要給對(duì)方兩個(gè)文件——settings.json和config.toml。這篇的目標(biāo)很具體給你一套能直接復(fù)制的骨架跑通一次 skill 加載再演示一次報(bào)錯(cuò)排查。全程不涉及任何網(wǎng)絡(luò)工具只講本地配置和 API 通道。2. TaoToken 前置Key、通道與目錄約定在動(dòng)手寫(xiě) skill 之前先把 TaoToken 這一層準(zhǔn)備好。你需要一個(gè) API Key入口在控制臺(tái)的 API Keys 頁(yè)面https://taotoken.net/console/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi_keysutm_campaignrewrite 。拿到 Key 之后記住兩個(gè)地址官網(wǎng)是 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 基址是 https://taotoken.net/api 這個(gè)不加 UTM直接寫(xiě)進(jìn)配置。目錄約定我建議這樣Trae 的工作區(qū)根目錄下建.trae/skills/evomap/里面分scripts/、data/gep/、references/三層。scripts/放可執(zhí)行邏輯data/gep/放基因、膠囊、事件日志references/放協(xié)議說(shuō)明。這樣做的好處是 skill 的邊界清晰交接時(shí)整個(gè)目錄打包即可。注意Key 不要寫(xiě)進(jìn)SKILL.md或任何會(huì)被提交到版本庫(kù)的文件。我習(xí)慣把它放在環(huán)境變量里配置文件只引用變量名。TaoToken 的通道配置有兩個(gè)文件要區(qū)分settings.json管 Trae 側(cè)的 skill 注冊(cè)和模型入口config.toml管 evomap 腳本運(yùn)行時(shí)的參數(shù)。兩者職責(zé)不同不要混在一起寫(xiě)。3. 可復(fù)制配置settings.json 與 config.toml 骨架先給settings.json的骨架。這個(gè)文件放在.trae/下作用是告訴 Trae 有哪些 skill、模型請(qǐng)求走哪個(gè)通道。{ skills: { evomap: { path: .trae/skills/evomap, entry: scripts/evolve.js, enabled: true } }, model: { provider: taotoken, baseUrl: https://taotoken.net/api, apiKeyEnv: TAOTOKEN_API_KEY, defaultModel: claude-sonnet }, runtime: { nodePath: node, timeoutMs: 60000 } }這里的關(guān)鍵是apiKeyEnv指向環(huán)境變量而不是硬編碼。baseUrl就是 TaoToken 的 API 基址所有 skill 里的模型調(diào)用都從這里走。再給config.toml的骨架放在.trae/skills/evomap/下管 evomap 自己的運(yùn)行參數(shù)。[gep] data_dir data/gep genes_file data/gep/genes.json capsules_file data/gep/capsules.json events_file data/gep/events.jsonl [evolve] strategy repair max_cycles 3 review_mode false [channel] base_url https://taotoken.net/api api_key_env TAOTOKEN_API_KEY model claude-sonnetstrategy可以取repair、optimize、innovate分別對(duì)應(yīng)修復(fù)、優(yōu)化、創(chuàng)新三種基因策略。max_cycles控制一次進(jìn)化跑幾輪調(diào)試時(shí)設(shè)小一點(diǎn)。環(huán)境變量這樣設(shè)export TAOTOKEN_API_KEY你的KeyWindows 下用set TAOTOKEN_API_KEY你的Key或者寫(xiě)進(jìn)系統(tǒng)環(huán)境變量。設(shè)完之后用echo $TAOTOKEN_API_KEY確認(rèn)一下能讀到。4. 驗(yàn)證請(qǐng)求跑一次 skill 加載與進(jìn)化周期配置寫(xiě)完先驗(yàn)證 skill 能不能被加載。在 Trae 工作區(qū)根目錄執(zhí)行node .trae/skills/evomap/scripts/test.js這個(gè)測(cè)試腳本會(huì)檢查文件結(jié)構(gòu)完整性、模塊加載、信號(hào)提取、基因選擇、變異構(gòu)建這幾項(xiàng)。如果輸出里每一項(xiàng)都是 pass說(shuō)明 skill 骨架是通的。接著跑一次真實(shí)的進(jìn)化周期node .trae/skills/evomap/scripts/evolve.js run正常的話你會(huì)看到類(lèi)似這樣的輸出先打印當(dāng)前加載的基因數(shù)量然后列出從日志里提取到的信號(hào)再顯示選中的基因和構(gòu)建出的變異對(duì)象最后把這次進(jìn)化事件追加到events.jsonl。我實(shí)測(cè)下來(lái)第一次跑通常信號(hào)是空的因?yàn)檫€沒(méi)有歷史日志這是正常的——你可以手動(dòng)往data/gep/events.jsonl里寫(xiě)一條測(cè)試事件再跑一次就能看到信號(hào)被提取出來(lái)。驗(yàn)證模型通道是否走通可以用模型對(duì)話頁(yè)面發(fā)一條測(cè)試請(qǐng)求https://taotoken.net/model-chat?utm_sourcetaotoken_aicg_blog_endutm_contentmodel_chatutm_campaignrewrite 。如果那邊能正常返回說(shuō)明 Key 和通道沒(méi)問(wèn)題skill 里的調(diào)用也會(huì)走同一條路。如果你打算長(zhǎng)期跑編碼和 Agent 任務(wù)建議看一下 Coding Planhttps://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding_planutm_campaignrewrite 它更適合高頻調(diào)用的場(chǎng)景。5. 本篇常見(jiàn)錯(cuò)排查第一個(gè)高頻錯(cuò)誤是Cannot find module。這通常是settings.json里的path寫(xiě)錯(cuò)了或者entry指向的文件不存在。檢查.trae/skills/evomap/scripts/evolve.js是否真的在那個(gè)位置路徑是相對(duì)工作區(qū)根目錄的不是相對(duì).trae/。第二個(gè)是TAOTOKEN_API_KEY is not set。說(shuō)明環(huán)境變量沒(méi)生效。先確認(rèn)echo $TAOTOKEN_API_KEY有輸出如果沒(méi)有檢查是不是在另一個(gè)終端窗口設(shè)的或者寫(xiě)進(jìn)了.bashrc但沒(méi)source。Trae 啟動(dòng)時(shí)繼承的是啟動(dòng)那一刻的環(huán)境變量設(shè)完要重啟 Trae。第三個(gè)是Unsupported MIME type這類(lèi)模型返回格式錯(cuò)誤。這多半是config.toml里的model字段和實(shí)際請(qǐng)求的模型不匹配。TaoToken 的通道支持多個(gè)模型但 skill 里如果寫(xiě)死了某個(gè)模型名而通道那邊沒(méi)有對(duì)應(yīng)配置就會(huì)報(bào)格式錯(cuò)。把model改成通道里確認(rèn)可用的名字再跑一次。第四個(gè)是進(jìn)化周期跑完但events.jsonl沒(méi)變化。檢查data_dir的路徑是不是相對(duì)config.toml所在目錄。我一開(kāi)始寫(xiě)成絕對(duì)路徑換機(jī)器就失效了后來(lái)改成相對(duì)路徑才穩(wěn)定。第五個(gè)是 skill 加載了但 Trae 里看不到。確認(rèn)settings.json里enabled是true并且 Trae 重啟過(guò)。skill 注冊(cè)是在啟動(dòng)時(shí)讀的改完配置不重啟不生效。接入相關(guān)的文檔在這里https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 里面有通道參數(shù)和錯(cuò)誤碼的說(shuō)明排查時(shí)對(duì)著看會(huì)快很多。6. 把配置變成可交接的資產(chǎn)這套骨架跑通之后交接就變得很簡(jiǎn)單把.trae/skills/evomap/整個(gè)目錄打包加上settings.json和config.toml兩個(gè)文件對(duì)方設(shè)好TAOTOKEN_API_KEY環(huán)境變量就能復(fù)現(xiàn)你本地的行為。GEP 的基因和膠囊資產(chǎn)都在data/gep/里跟著目錄走不會(huì)丟。如果你用的是 Claude Code 這類(lèi)工具TaoToken 也有對(duì)應(yīng)的接入方式https://taotoken.net/claude-code-anthropic?utm_sourcetaotoken_aicg_blog_endutm_contentclaude_codeutm_campaignrewrite 配置邏輯和這里講的一致都是統(tǒng)一 Key 通道。最后留一個(gè)實(shí)用技巧每次改完config.toml先跑test.js再跑evolve.js run兩步都過(guò)了再提交。這樣能把配置錯(cuò)誤擋在提交之前交接時(shí)對(duì)方拿到的就是驗(yàn)證過(guò)的版本。