AI Agent:從零搭建可復(fù)用工作流)
1. 這個項(xiàng)目到底解決了什么問題第一次看到“把 50 多種營銷 Skill 裝進(jìn) AI Agent”這個標(biāo)題我的反應(yīng)是終于有人把營銷人日常最煩的那堆重復(fù)勞動做成了可以即插即用的模塊。做過增長、投過廣告、寫過落地頁、跑過私域的人應(yīng)該都有體會——營銷這件事的痛點(diǎn)從來不是“沒想法”而是想法到執(zhí)行之間隔著一整個太平洋。一個活動從策劃到上線要寫文案、做選題、拆競品、算 ROI、排投放節(jié)奏、盯數(shù)據(jù)、出復(fù)盤報(bào)告每一步都在消耗人的精力而真正需要人腦判斷的部分其實(shí)只占兩成。這個開源項(xiàng)目的核心思路就是把這八成重復(fù)性的營銷工作抽象成一個個獨(dú)立的Skill然后掛載到AI Agent上。你可以把它理解成一個“營銷工具箱”每個 Skill 就是一把專用螺絲刀有的負(fù)責(zé)寫小紅書標(biāo)題有的負(fù)責(zé)拆解競品廣告有的負(fù)責(zé)生成 A/B 測試方案有的負(fù)責(zé)把一堆雜亂的數(shù)據(jù)整理成復(fù)盤報(bào)告。Agent 是那個拿著工具箱的助手你告訴它“幫我給這款新品做一輪冷啟動”它會自動判斷該調(diào)用哪幾個 Skill、按什么順序執(zhí)行、中間結(jié)果怎么銜接。適合誰來參考三類人最該看一是獨(dú)立開發(fā)者或小團(tuán)隊(duì)沒有專職營銷崗需要一個人頂一個部門二是營銷從業(yè)者想把自己的經(jīng)驗(yàn)沉淀成可復(fù)用的自動化流程三是AI Agent 的學(xué)習(xí)者想找一個真實(shí)、完整、有業(yè)務(wù)價(jià)值的項(xiàng)目來練手而不是停留在“寫個天氣查詢 Agent”的玩具階段。這個項(xiàng)目最大的價(jià)值不在于它內(nèi)置了多少個 Skill而在于它示范了一套**“業(yè)務(wù)經(jīng)驗(yàn)如何結(jié)構(gòu)化封裝”**的方法論這套方法論可以遷移到法務(wù)、財(cái)務(wù)、運(yùn)營、客服等任何有固定工作流的領(lǐng)域。2. 核心概念拆解Agent、Skill、LLM 到底誰是誰2.1 用一家餐廳來理解三者的關(guān)系很多人一上來就被 Agent、LLM、Skill 這幾個詞繞暈。我用一家餐廳打比方你立刻就懂了。LLM大語言模型是后廚那位天賦異稟但只會做菜的廚師。他見多識廣你給他任何食材他都能做出一道菜但他不知道今天餐廳要賣什么、客人是誰、成本控制在多少。他只有“做菜”這一個能力沒有“經(jīng)營”的概念。AI Agent是餐廳經(jīng)理。他負(fù)責(zé)接待客人、理解需求、安排流程、檢查出品??腿苏f“我想吃清淡點(diǎn)的”經(jīng)理不會自己下廚而是把需求翻譯成指令傳給廚師同時(shí)決定要不要先上一道開胃菜、主菜之后配什么甜品。Agent 的本質(zhì)是調(diào)度者它把模糊的人類意圖拆解成可執(zhí)行的步驟。Skill是餐廳的標(biāo)準(zhǔn)菜譜。宮保雞丁怎么做、火候多少、放幾克糖全部寫死在菜譜里。廚師照著菜譜做出品就穩(wěn)定。Skill 就是把某類任務(wù)的“最佳實(shí)踐”固化下來讓 LLM 不用每次從零發(fā)揮既省 token 又保證質(zhì)量。所以這個項(xiàng)目的架構(gòu)就很清晰了Agent 是調(diào)度中樞LLM 是底層推理引擎Skill 是封裝好的業(yè)務(wù)能力。三者缺一不可但職責(zé)邊界分明。我見過太多人把 Skill 直接寫成一段 prompt 塞給 LLM結(jié)果就是每次輸出都不穩(wěn)定因?yàn)?LLM 的“自由發(fā)揮”空間太大了。Skill 的意義就在于收窄自由度鎖定輸出質(zhì)量。2.2 Skill 和普通 Prompt 的本質(zhì)區(qū)別有人會問Skill 不就是一段寫得比較長的 prompt 嗎我直接復(fù)制粘貼不行嗎不行差別很大。普通 prompt 是“一次性指令”Skill 是“帶上下文的可復(fù)用模塊”。具體區(qū)別體現(xiàn)在四個維度維度普通 PromptSkill復(fù)用性每次都要重新粘貼一次定義隨時(shí)調(diào)用上下文無狀態(tài)每次從零開始可攜帶歷史、參數(shù)、前置條件輸出格式靠模型自覺強(qiáng)制結(jié)構(gòu)化可校驗(yàn)組合能力無法被其他流程調(diào)用可被 Agent 編排進(jìn)工作流舉個具體例子。你讓 LLM“寫一個產(chǎn)品賣點(diǎn)”它可能給你一段散文也可能給你一個列表全看心情。但如果你把它封裝成一個 Skill明確規(guī)定“輸入產(chǎn)品參數(shù)輸出三個賣點(diǎn)每個賣點(diǎn)不超過 20 字必須包含一個數(shù)字或?qū)Ρ取蹦敲礋o論調(diào)用多少次輸出都是可預(yù)期的。這就是 Skill 的工程價(jià)值——把不確定性關(guān)進(jìn)籠子里。2.3 為什么營銷領(lǐng)域特別適合 Skill 化營銷工作有個鮮明特點(diǎn)流程高度標(biāo)準(zhǔn)化但內(nèi)容高度個性化。寫文案的步驟永遠(yuǎn)是“明確目標(biāo)人群→提煉核心賣點(diǎn)→選擇表達(dá)角度→組織語言→檢查合規(guī)”這個流程十年沒變過。但每一步產(chǎn)出的內(nèi)容必須因產(chǎn)品、渠道、人群而異。這種“流程固定、內(nèi)容可變”的結(jié)構(gòu)簡直是 Skill 的天然溫床。流程固定意味著可以封裝成標(biāo)準(zhǔn)模塊內(nèi)容可變意味著需要 LLM 的生成能力。兩者一結(jié)合就是 Skill 的最佳應(yīng)用場景。相比之下像戰(zhàn)略咨詢這種流程本身就不固定的工作硬做 Skill 化反而會束手束腳。3. 50 多個 Skill 是怎么分類的3.1 按營銷漏斗分層一個成熟的營銷體系本質(zhì)是一條從“陌生人”到“付費(fèi)用戶”再到“傳播者”的漏斗。這個項(xiàng)目的 Skill 分類基本遵循了這條漏斗邏輯。我把它整理成下面這張表方便你對照自己的業(yè)務(wù)查漏補(bǔ)缺漏斗階段典型 Skill 類型解決的核心問題認(rèn)知層選題生成、熱點(diǎn)追蹤、內(nèi)容日歷讓目標(biāo)人群看見你興趣層賣點(diǎn)提煉、競品拆解、場景化文案讓人產(chǎn)生“這跟我有關(guān)”的感覺決策層對比話術(shù)、異議處理、信任背書打消購買顧慮轉(zhuǎn)化層落地頁優(yōu)化、促銷話術(shù)、緊迫感設(shè)計(jì)推動下單動作留存層私域話術(shù)、復(fù)購提醒、會員權(quán)益說明讓用戶留下來傳播層裂變文案、UGC 引導(dǎo)、口碑素材讓用戶幫你拉人這個分層最大的好處是可診斷。如果你的轉(zhuǎn)化率低不用瞎猜直接看是決策層還是轉(zhuǎn)化層的 Skill 出了問題。我自己的習(xí)慣是每周跑一次漏斗診斷讓 Agent 依次調(diào)用各層 Skill輸出一份“哪一層拖后腿”的報(bào)告比拍腦袋靠譜得多。3.2 按內(nèi)容形態(tài)分類除了按漏斗分還有一套按內(nèi)容形態(tài)的分類邏輯同樣重要。因?yàn)椴煌缹?nèi)容形態(tài)的要求天差地別小紅書要短平快、公眾號要深度、短視頻要鉤子、落地頁要轉(zhuǎn)化力。短文案類標(biāo)題、鉤子、金句、評論區(qū)話術(shù)特點(diǎn)是字?jǐn)?shù)少、密度高、要抓眼球長內(nèi)容類深度文章、白皮書、案例拆解特點(diǎn)是邏輯鏈完整、需要鋪墊結(jié)構(gòu)化類賣點(diǎn)表、對比表、FAQ、參數(shù)說明特點(diǎn)是信息密度高、便于掃讀腳本類短視頻腳本、直播話術(shù)、播客提綱特點(diǎn)是口語化、有節(jié)奏感數(shù)據(jù)類復(fù)盤報(bào)告、投放分析、ROI 測算特點(diǎn)是需要計(jì)算和歸因我實(shí)測下來短文案類和結(jié)構(gòu)化類最適合優(yōu)先 Skill 化因?yàn)樗鼈兊脑u判標(biāo)準(zhǔn)清晰容易驗(yàn)證效果。長內(nèi)容類次之腳本類最難因?yàn)楣?jié)奏感這種東西很難用規(guī)則描述目前還是得靠人把關(guān)。3.3 一個 Skill 的標(biāo)準(zhǔn)結(jié)構(gòu)長什么樣不管哪個分類一個合格的 Skill 內(nèi)部結(jié)構(gòu)都包含五個部分。我拿“競品廣告拆解”這個 Skill 舉例說明元信息名稱、適用場景、輸入要求、輸出格式。比如“輸入競品廣告原文輸出拆解報(bào)告包含鉤子類型、痛點(diǎn)、賣點(diǎn)、行動號召四個維度”。角色設(shè)定告訴 LLM 以什么身份工作。比如“你是一位有十年經(jīng)驗(yàn)的廣告分析師擅長拆解爆款素材的底層邏輯”。執(zhí)行步驟把任務(wù)拆成有序的幾步。比如“第一步識別鉤子類型第二步提取核心痛點(diǎn)第三步分析賣點(diǎn)呈現(xiàn)方式第四步評估行動號召強(qiáng)度”。輸出模板規(guī)定最終產(chǎn)出的格式。用 Markdown 表格還是 JSON字段有哪些都要寫死。質(zhì)量校驗(yàn)給出自檢清單。比如“檢查是否遺漏了價(jià)格信息、是否誤判了目標(biāo)人群”。這五部分缺一不可。我踩過的最大坑就是只寫了執(zhí)行步驟沒寫質(zhì)量校驗(yàn)結(jié)果 Agent 輸出看著挺像樣細(xì)看全是漏洞。后來補(bǔ)上校驗(yàn)環(huán)節(jié)返工率直接降了一半。4. 從零把這個項(xiàng)目跑起來4.1 環(huán)境準(zhǔn)備與依賴安裝這個項(xiàng)目基于 Claude Code 的 Skill 機(jī)制構(gòu)建所以第一步是把運(yùn)行環(huán)境搭好。我假設(shè)你用的是 macOS 或 UbuntuWindows 用戶建議走 WSL省得踩一堆路徑坑。先確認(rèn)基礎(chǔ)環(huán)境。打開終端逐條執(zhí)行# 檢查 Node.js 版本建議 18 以上 node -v # 檢查包管理器npm 或 pnpm 都行我個人偏好 pnpm pnpm -v # 檢查 git git -v如果 Node 版本低于 18先去官網(wǎng)裝新版。這一步別偷懶我見過太多人卡在版本不兼容上排查半天以為是代碼問題其實(shí)是環(huán)境太舊。接著克隆項(xiàng)目并安裝依賴git clone 項(xiàng)目倉庫地址 cd 項(xiàng)目目錄 pnpm install安裝完成后需要配置 Claude Code 的 Skill 目錄。默認(rèn)情況下Skill 文件放在~/.claude/skills/下每個 Skill 一個獨(dú)立文件夾里面包含一個SKILL.md描述文件。你可以手動創(chuàng)建也可以用項(xiàng)目提供的腳本批量導(dǎo)入# 假設(shè)項(xiàng)目提供了導(dǎo)入腳本 pnpm run import-skills導(dǎo)入完成后檢查一下目錄結(jié)構(gòu)ls ~/.claude/skills/應(yīng)該能看到幾十個以營銷場景命名的文件夾。如果數(shù)量對不上說明導(dǎo)入過程有文件被跳過需要看日志排查。提示Skill 目錄的路徑在不同版本里可能略有差異如果默認(rèn)路徑找不到去官方文檔確認(rèn)當(dāng)前版本的約定位置別硬猜。4.2 驗(yàn)證第一個 Skill 是否生效環(huán)境搭好后別急著跑復(fù)雜流程先用一個最簡單的 Skill 驗(yàn)證鏈路通不通。我推薦從“標(biāo)題生成”這類短文案 Skill 入手因?yàn)樗妮斎胼敵龆己苤庇^。啟動 Claude Code輸入類似這樣的指令使用標(biāo)題生成 Skill為以下產(chǎn)品生成 5 個小紅書標(biāo)題 產(chǎn)品便攜式榨汁杯 目標(biāo)人群25-35 歲上班族女性 核心賣點(diǎn)充電一次用一周、可拆洗、靜音如果 Skill 生效你會看到結(jié)構(gòu)化的輸出而不是一段隨意的散文。判斷標(biāo)準(zhǔn)有三條是否嚴(yán)格生成了 5 個、是否都控制在合理字?jǐn)?shù)內(nèi)、是否體現(xiàn)了三個核心賣點(diǎn)。三條都滿足說明 Skill 鏈路正常。如果輸出不符合預(yù)期大概率是三個原因Skill 沒被正確加載、輸入格式不符合 Skill 要求、或者 Skill 本身的 prompt 有歧義。排查順序就按這個來從外到內(nèi)一層層剝。4.3 把多個 Skill 串成一條工作流單個 Skill 跑通只是開始真正的威力在于組合。這個項(xiàng)目的 Agent 支持把多個 Skill 編排成一條流水線。我拿“新品冷啟動”這個真實(shí)場景演示一下。假設(shè)你要給一款新茶飲做冷啟動完整流程是這樣的調(diào)用人群畫像 Skill輸入產(chǎn)品信息輸出目標(biāo)人群特征把人群特征喂給賣點(diǎn)提煉 Skill輸出三個核心賣點(diǎn)把賣點(diǎn)分別喂給小紅書文案 Skill和朋友圈文案 Skill生成兩套渠道內(nèi)容調(diào)用內(nèi)容日歷 Skill把內(nèi)容排進(jìn)未來兩周的發(fā)布計(jì)劃調(diào)用數(shù)據(jù)預(yù)估 Skill給出各渠道的預(yù)期曝光和轉(zhuǎn)化區(qū)間在 Agent 里這條流水線可以用一段配置描述出來Agent 會自動按順序調(diào)用、傳遞中間結(jié)果。我實(shí)測下來跑完這一整套大概兩三分鐘人工做同樣的事至少要半天。當(dāng)然Agent 產(chǎn)出的是初稿不是終稿人的價(jià)值在于判斷和微調(diào)而不是從零開始。5. 實(shí)操中最容易踩的坑5.1 Skill 之間的“接口”對不齊這是最高頻的問題。Skill A 輸出的格式Skill B 讀不懂整條流水線就斷了。比如賣點(diǎn)提煉 Skill 輸出的是帶編號的列表而文案 Skill 期望的是逗號分隔的關(guān)鍵詞中間就得加一個轉(zhuǎn)換步驟。我的解決辦法是給每個 Skill 的輸出格式定死標(biāo)準(zhǔn)全部用 JSON 或固定字段的 Markdown 表格。寧可多寫幾行格式約束也不要讓 Agent 去“猜”上一個 Skill 想表達(dá)什么。下面是我常用的輸出格式約定{ skill_name: 賣點(diǎn)提煉, product: 產(chǎn)品名, selling_points: [ {point: 賣點(diǎn)內(nèi)容, evidence: 支撐依據(jù), priority: 1} ], target_audience: 人群描述 }字段名統(tǒng)一用英文小寫下劃線避免中文和空格帶來的解析問題。這個習(xí)慣幫我省了無數(shù)排查時(shí)間。5.2 上下文太長導(dǎo)致 Skill 失憶營銷任務(wù)經(jīng)常需要攜帶大量背景信息比如品牌調(diào)性、歷史素材、競品資料。如果一股腦全塞進(jìn)上下文LLM 很容易“顧此失彼”跑到后面就忘了前面的約束。我的經(jīng)驗(yàn)是分層加載把信息分成“必須常駐”和“按需加載”兩類。品牌調(diào)性、核心賣點(diǎn)這種全局約束常駐競品資料、歷史案例這種只在特定 Skill 里用到的按需注入。這樣既保證關(guān)鍵信息不丟又不會把上下文撐爆。具體操作上可以在 Agent 配置里給每個 Skill 單獨(dú)指定“上下文依賴”只加載它真正需要的部分。這個設(shè)計(jì)一開始麻煩點(diǎn)但長期看是值得的。5.3 輸出質(zhì)量忽高忽低同一個 Skill有時(shí)候輸出驚艷有時(shí)候一塌糊涂。這種波動通常來自三個源頭輸入質(zhì)量不穩(wěn)定、Skill 內(nèi)部步驟有歧義、LLM 本身的隨機(jī)性。排查順序建議這樣先固定輸入跑十次看輸出波動范圍。如果波動大說明 Skill 本身不夠收斂需要加更多約束。如果波動小說明是輸入的問題得回頭規(guī)范輸入格式。至于 LLM 的隨機(jī)性可以通過降低 temperature 參數(shù)來壓制但別調(diào)到 0那樣輸出會變得死板。我一般把營銷類 Skill 的 temperature 設(shè)在 0.3 到 0.5 之間既保留一點(diǎn)創(chuàng)意又不至于跑偏。這個區(qū)間是我反復(fù)試出來的你可以根據(jù)自己的業(yè)務(wù)特點(diǎn)微調(diào)。5.4 常見問題速查表現(xiàn)象可能原因排查方向Skill 完全不生效未正確加載檢查 Skill 目錄和文件命名輸出格式混亂輸出模板未約束補(bǔ)全輸出格式定義流水線中途斷掉接口格式不匹配統(tǒng)一上下游數(shù)據(jù)格式內(nèi)容質(zhì)量差輸入信息不足補(bǔ)充背景和約束條件響應(yīng)特別慢上下文過長精簡常駐信息按需加載結(jié)果重復(fù)度高temperature 過低適當(dāng)調(diào)高隨機(jī)性參數(shù)這張表我貼在工位上出問題先對照一遍八成能定位到原因。6. 把 Skill 用出花來的幾個進(jìn)階思路6.1 用 Skill 沉淀團(tuán)隊(duì)經(jīng)驗(yàn)Skill 最大的隱藏價(jià)值是把老員工的隱性經(jīng)驗(yàn)顯性化。一個做了五年?duì)I銷的人腦子里有無數(shù)“感覺”但這些感覺沒法直接傳給新人。把它寫成 Skill就等于把感覺翻譯成了步驟。我自己的做法是每次做完一個成功案例就回頭復(fù)盤這次成功的關(guān)鍵動作是什么能不能抽象成一個 Skill比如我發(fā)現(xiàn)“帶具體數(shù)字的標(biāo)題打開率明顯更高”就把這條規(guī)則寫進(jìn)標(biāo)題 Skill 的約束里。日積月累Skill 庫就成了團(tuán)隊(duì)的經(jīng)驗(yàn)銀行。6.2 讓 Skill 互相“打分”單個 Skill 的輸出質(zhì)量可以交給另一個 Skill 來評估。比如文案 Skill 生成內(nèi)容后調(diào)用一個“文案評分 Skill”從吸引力、清晰度、合規(guī)性三個維度打分低于閾值的自動重寫。這套機(jī)制我稱之為“Skill 自檢”能顯著提升最終產(chǎn)出質(zhì)量。實(shí)現(xiàn)上就是在流水線末尾加一個評估環(huán)節(jié)把評分結(jié)果反饋給生成環(huán)節(jié)。如果 Agent 支持循環(huán)就讓它自動重試如果不支持就輸出評分報(bào)告人工決定要不要重跑。6.3 跨領(lǐng)域遷移這套方法論這套“Agent Skill”的架構(gòu)絕不只適用于營銷。任何有固定工作流的領(lǐng)域都能套用。我舉幾個例子法務(wù)合同審查 Skill、風(fēng)險(xiǎn)條款識別 Skill、合規(guī)檢查 Skill財(cái)務(wù)報(bào)表分析 Skill、預(yù)算測算 Skill、異常檢測 Skill客服工單分類 Skill、話術(shù)推薦 Skill、情緒安撫 Skill教育知識點(diǎn)拆解 Skill、習(xí)題生成 Skill、學(xué)情分析 Skill遷移的關(guān)鍵在于找準(zhǔn)那個“流程固定、內(nèi)容可變”的環(huán)節(jié)。找到它就能封裝成 Skill。這個判斷標(biāo)準(zhǔn)我屢試不爽。6.4 關(guān)于 Skill 數(shù)量的理性認(rèn)知標(biāo)題說“50 多種”聽起來很唬人但我要潑盆冷水Skill 不是越多越好。我見過有人為了湊數(shù)量把一些根本用不上的場景也做成 Skill結(jié)果維護(hù)成本飆升真正好用的那幾個反而被淹沒。我的建議是先從自己業(yè)務(wù)里最高頻、最痛的三個場景做起把這三個 Skill 打磨到極致跑通完整流水線。等這套流程穩(wěn)定了再逐步擴(kuò)展。質(zhì)量永遠(yuǎn)比數(shù)量重要一個能穩(wěn)定產(chǎn)出高質(zhì)量內(nèi)容的 Skill勝過十個半成品。7. 我個人的一些實(shí)操體會用這套東西有一段時(shí)間了最大的感受是它改變的不是效率而是工作方式。以前做營銷是“想到什么做什么”靠靈感和狀態(tài)。現(xiàn)在有了 Skill 庫工作變成了“選對 Skill、喂對輸入、檢查輸出”穩(wěn)定性和可預(yù)期性完全不一樣。但我也要提醒一句別指望 Agent 替你做判斷。它能幫你把執(zhí)行做到 80 分但那個決定“往哪個方向做”的判斷永遠(yuǎn)得人來下。Skill 是放大器不是替代品。你把一個錯誤的策略喂給它它只會更快地幫你產(chǎn)出錯誤的結(jié)果。最后分享一個小技巧給每個 Skill 寫一份“使用說明”記錄它的適用場景、輸入要求、已知局限。這份說明不用給 Agent 看是給人看的。團(tuán)隊(duì)協(xié)作時(shí)新人拿到 Skill 庫看說明就能上手省去大量溝通成本。這個習(xí)慣是我從代碼注釋里學(xué)來的用在 Skill 管理上同樣好使。