前言¶
臨時搭多 Agent 流程的痛點在於:角色分工、交接格式和驗證環節都不穩定。換一個會話,同一個分工又得重新說明一遍。多智能體協作框架把這個流程寫進 Skill,用提示詞模板固定角色和輸出格式,讓分工可複用。
這是什麼¶
多智能體協作框架是一個基於 SKILL.md 格式的提示詞型 Skill,由社區發佈者 user_2fd890c9 維護(來源:community),座標 @user_2fd890c9/agents-20260801。它不執行代碼,而是通過內置提示詞模板,把「架構師 → 工匠 → 驗證器」的多 Agent 分工流程固化下來,讓模型按固定角色拆解任務、執行任務、審查結果,並輸出結構化 JSON。
核心功能¶
-
兩種協作模式。一種是深度推理鏈:
think step-by-step、think xN、critically think xN,用於提升單次輸出的推理質量;另一種是角色制多智能體協作,由多個 Agent 分工完成任務。 -
三角色流水線。架構師(Architect)負責分析需求並拆解爲可執行任務;工匠(Artisan)按分配的角色執行任務;驗證器(Verifier)對執行結果做審查。三個環節的角色和職責在提示詞中預先寫明。
-
結構化輸出。要求輸出爲 JSON,字段包括
project_goal和agents[],每個 Agent 帶name、role、responsibilities列表。下游環節(如工匠執行、驗證器審查)可直接解析這個 JSON,不必再靠自由文本對齊。 -
依賴與前置條件。頁面標註的依賴爲
bash >= 3.0、curl、httpx;需要pip install httpx。高級推理模式與多智能體模式都需要 OpenAI API Key。
安裝與啓用¶
安裝入口在 SkillHub。頁面地址爲 https://www.skillhub.cn/skills/user_2fd890c9/agents-20260801 (開源鏡像站 skillhub.fyi 同坐標頁面內容一致,可作備用來源)。
代碼塊:
pip install httpx
配置 API Key。框架的高級推理(1/3/5 次方)與多智能體模式均依賴 OpenAI API Key,需要在運行環境中配置好對應密鑰,否則只會退化到模型的默認行爲。
Cursor、Codex CLI、Claude Code 的安裝路徑頁面未分別說明,按 SkillHub 的通用安裝流程在對應工具中添加即可。注意:頁面標註「無官方定義的函數/工具、無代碼執行、無腳本依賴」,說明它是一個純提示詞型 Skill,啓用後不會注入可調用工具或可執行腳本。
典型用法¶
以下提示詞模板來自該 Skill 的 SKILL.md,展示了架構師環節的分工:
你是多智能體協作框架營銷模塊的架構師(Architect)。你的職責是分析營銷需求,並將其拆解爲可執行的任務。
# 角色設定:
- 你是 AI 營銷架構師
- 你的輸出必須是結構化 JSON。
- 你必須將任務拆解爲明確的步驟。
- 你必須爲每個步驟指定對應的 Agent 角色(如:文案、設計師、策略師)。
- 你必須爲每個角色提供明確的職責描述。
# 輸出格式:
{
"project_goal": "",
"agents": [
{
"name": "",
"role": "",
"responsibilities": ["", ""]
}
]
}
拿到這個 JSON 後,工匠按 role 和 responsibilities 執行,驗證器再對結果審查。深度推理模式可以單獨使用,也可以疊加在角色制流程之上。
適用場景與注意¶
適合需要多角色分工、且希望分工和交接格式固定的場景,例如營銷內容生產中文案、設計師、策略師的拆解與執行。也適合想快速複用「架構師-工匠-驗證器」流程、而不是每次重新設計提示詞的開發者。
注意幾點:一是高級推理與多智能體模式都需要 OpenAI API Key,沒有密鑰時這些模式不會生效;二是頁面標註無官方定義的函數和工具,它不會替你調用接口或執行腳本,只負責編排提示詞;三是頁面未標註版本號,倉庫歷史裏有 1.0.11 的版本記錄(見鏡像站頁面),功能以頁面說明爲準。
結尾¶
多智能體協作框架的價值在於把「分工 → 執行 → 驗證」的流程固化成可複用提示詞,減少每次搭建多 Agent 流程的成本。官方地址:https://api.skillhub.cn/user_2fd890c9/agents-20260801