Claude Agent Templates：我審核了最大目錄中的全部 423 個模板（56% 交接 Bash）

搜尋 克勞德代理模板 你會發現一個包含 422 個代理程式的目錄，一個聲稱下載量達 50 萬次的命令列介面，但幾乎沒有關於應該安裝哪些代理程式的建議。所以我下載了最大的目錄，並親自閱讀了每個代理文件的頭部資訊：從 423 個文件中… davila7/claude-code-templates 倉庫，即 aitmpl.com 背後的庫，位於其 2026 年 10 月 9 日的提交。我不在乎代理商是什麼。 說 確實如此。我關心的是每個文件實際提供的功能：哪些工具、哪個模型，以及在運行之前會在你的上下文中添加多少文字。.

標題： 417 個具有有效標頭的代理程式中有 235 個可以執行 shell 指令。. Anthropic 自己的參考集包含四個完整的代理，其中 Bash 恰好對應一個代理。.

在您繼續閱讀之前，請先了解我的背景資訊。我提供諮詢服務和全套建置服務，並且經營著一支由 Claude Code 代理商組成的龐大團隊，這些代理商分佈在 10 多個品牌容器中，負責編寫本網站的內容、安排社群媒體貼文發布以及記錄自身的故障。我從未在生產環境中運行過這 423 個代理，也不會假裝我運行過。 有 幾個月來，我一直在使用模板化的技能庫，從一個品牌複製到另一個品牌。在文章結尾，我會向你展示這對我自己的車隊造成了什麼影響，並附上發布這篇文章的收據。.

您將獲得以下內容：Claude 代理模板的實際內容、審計數據、權限問題、無人列出的上下文賬單、目錄衛生、我自己的模板殘留，以及在安裝任何內容之前運行的五分鐘審查。.

Claude Agent 模板的真正意義（一個文件，四行關鍵內容）

Claude 代理模板是一個子代理定義：一個可以拖放到…的 Markdown 檔案。 .claude/agents/ 在專案內部，或進入 ~/.claude/agents/ 為了使其在任何地方都能訪問，該文件分為兩部分：頂部是一個簡短的 YAML 頭部，下方是主體部分，該主體部分將成為代理的系統提示符。.

標題列包含了所有風險和成本。其中四個欄位至關重要：

• 姓名：如何稱呼代理人。兩個代理人同名會造成問題（下文會詳細說明）。.
• 描述：這是你的主 Claude 會話在決定是否將任務指派給此代理時讀取的內容。它是為路由器編寫的，而不是為你寫的。.
• 工具：允許列表。如果省略該行，代理將繼承主會話的所有工具，包括您連接到電子郵件、CRM 或資料庫的任何 MCP 伺服器。.
• 模型: 十四行詩, 作品, 俳句, 繼承, 或完整的型號 ID。.

這是一個完整、簡潔、合理的代理文件：

--- 名稱：連結檢查器 說明：檢查草稿中的每個出站連結並報告失效連結。發布前使用。 工具：讀取、Grep、WebFetch 模型：繼承 --- 您只負責檢查鏈接，絕不編輯文件。報告每個失效 URL 及其所在的行。.

這就是全部的模式。產品目錄上賣的所有東西都是這幾句話的變體，再加上更長的正文。.

關於「模板」這個詞，需要注意一點：它的意義會被無限延伸，涵蓋所有內容。同一個程式碼庫也包含以下內容。 423 個代理、914 個技能、348 個斜杠命令、105 個 MCP 配置、63 個鉤子配置和 73 個設定文件, 這大約包含 1900 個組件。 Claude4World 的「18 個 Claude Code 範本」是完整的專案啟動範本。 DataCamp 的指南將範本分為六種類型。本文主要討論代理文件，因為權限是在這裡授予的。如果您還在猶豫是否需要子代理，請從這裡開始。 當克勞德代碼子代理人真的幫忙時. 如果您正在尋找套餐，請閱讀 我的 Claude Code 插件操作指南.

我審核了最大目錄中的全部 423 個 Claude Agent 模板。

方法，這樣你就可以檢驗我了： 淺克隆 github.com/davila7/claude-code-templates 提交 ed9fc5d （提交於 2026 年 10 月 9 日），然後是一個解析每個文件的標頭的腳本。 .md 文件歸檔於 cli-tool/components/agents/. 這共包含 28 個類別、423 個文件，與 aitmpl.com 在其代理頁面上顯示的「422 個元件」相符。我已將這些文件作為數據讀取，但並未運行任何程式。下方的標記數量為字元數除以 4，這只是一個粗略的估計值，並非分詞器計數。.

我檢查了	數數	分享
代理文件	423	—
具有有效標頭的文件	417	98.6%
授予 巴什 （shell 存取）	235	56%
授予 撰寫或編輯	290	70%
格蘭特·巴什 和 撰寫/編輯	219	53%
只讀（無 Bash，無寫入/編輯）	106	25%
不 工具 完全繼承（繼承所有）	5	1%
不 模型 線	335	80%
描述長度超過 1000 個字符	176	42%
兩個不同檔案使用的名稱	13 個名字 / 26 個文件	—
完全沒有標題	6	1.4%

代理文件的中位數為 7,882 字節，約 2,000 個系統提示字元。最大的代理檔案為 7,882 字節，約 2,000 個系統提示字元。, 安全工程師, ，大小為 33,714 位元組。最小的，, 規劃師, 是 840。.

為什麼沒人公佈 Claude 代理模板究竟能提供哪些功能？看看排名就知道了。 2026 年 10 月 10 日，“Claude 代理模板”排名第一的是目錄作者在 Medium 上發表的自述文章（2026 年 2 月，“下載量超過 50 萬”，大部分內容需要付費才能查看）。排名第二的是 Anthropic 的範例檔。其他排名前十的結果包括一個 Notion 頁面、一篇關於電子郵件模板的文章、一些 YouTube 視頻、一個列出八個代理的付費商店（實際上只有一個代理在售，售價 $9.99，“原價 $29”）、一個 PRD 模板匯總以及一個項目啟動器目錄。五天前，aitmpl.com 的排名是 #1。而今晚它已經跌出了前 20 名。有許多頁面都在描述這些文件，但沒有一個頁面說明這些文件究竟能提供哪些功能。.

權限問題：大多數 Claude Agent 範本都提供 Bash 權限

Bash 是最重要的。安裝了 Bash 的代理程式可以執行使用者帳戶可以執行的任何操作：執行腳本、, 捲曲 一個網址，讀你的 .env, git push, 刪除目錄。寫入和編輯權限允許它修改檔案。單獨來看，兩者都沒有錯。建置代理程式需要同時擁有這兩種權限。問題在於，授予權限是出於主動選擇還是預設值。.

人種學派的參考文獻明確指出應該是哪一個。 complete-agent-examples.md 官方文件中 克勞德代碼 倉庫定義了四個完整的代理。每個代理都設定 模型：繼承 以及一個明確的工具清單。其中兩個是唯讀的（閱讀、Grep、Glob只有一個人能獲得 Bash。.

社區目錄則相反。 56% 個代理程式擁有 Bash，53% 個代理程式擁有 Bash 以及寫入權限。只有四分之一是只讀的。 aitmpl 上最受歡迎的代理程式是…, 前端開發者, 首先，在其“最受歡迎”類別中，授予 讀取、寫入、編輯、Bash、Glob、Grep. 對於開發前端的開發人員來說，這種說法尚可接受。但對於審查者、顧問或研究人員來說，則不然，而這些人在產品目錄中佔了很大一部分： 專家顧問 這是其最大的類別，共有 52 名代理商。.

最清晰的插圖甚至不在產品目錄中。. DataCamp 的 Claude 程式碼模板指南 顯示範例 安全審計員 該代理人的描述稱其會產生一份調查報告 “無需修改文件。” 其工具產品線是 讀取、Glob、Grep、Bash. Bash 可以修改文件。提示符說“不要這樣做”，而允許列表卻說“你可以這樣做”。.

提示是請求，工具列是執行命令。. 如果代理人絕對不能改變任何事情，那就剝奪他改變現狀的工具。別好言相勸。.

還有五個代理商完全沒有工具線。它們會繼承所有內容，包括你配置的所有 MCP 伺服器。如果你的會話可以發送電子郵件，它們也可以。.

這也是一個供應鏈問題。代理文件是一組由陌生人編寫的指令，用於管理持有您憑證的流程。我為插件設定的信任等級（官方、社群、隨機市場）在這裡保持不變，我已經將其列出。 插件指南. 簡而言之：鎖定到某個提交，讀取提交內容，並在運行之前使用 grep 命令查找 URL。.

背景法案：Claude Agent 模板運行前的成本是多少

這裡沒有目錄列表，費用如下。代理的主體僅在被呼叫時載入。 描述 情況有所不同。 Claude Code 會將每個可用代理程式的描述資訊列出到主會話中，以便主會話決定何時進行代理分配。這意味著無論您是否使用代理，您都需要為每個已安裝代理的描述資訊付費。.

對於大多數 Claude 代理模板來說，帳單都很小。描述長度中位數為 223 個字符，約 56 個字元。但有 176 個代理（42%）的描述長度超過 1000 個字符，還有 180 個代理嵌入了完整的描述。 <example> 描述欄位中包含虛假的使用者請求和虛假的助手回覆對話。這些對話篇幅較長，平均每個對話包含 2880 個字符，約 720 個詞元。. 前端開發者‘光是描述就有 3,042 個字元。.

• 全部 417 條描述： 550,235 個字符，約 137,000 個字元。.
• 最重的20個： 在任何工作開始之前，共有 85,977 個字符，約 21,500 個標記。.

沒人會安裝全部 417 個軟體包。但「為我的堆疊安裝軟體包」正是這些命令列介面 (CLI) 的正確用法，而 20 個代理伺服器只是一個普通的下午就能完成的工作。我對另一個始終加載的文件也進行了同樣的測試，結果如下： 我的 CLAUDE.md 拆解每次運行大約需要 7400 個代幣，其中 47.8% 是無用的。如果你想要通用的解決方案，我已經寫好了。 啟動時限制代理程式讀取內容的三種方法.

成本不僅僅是令牌。每個描述都會與其他描述爭奪路由器的注意力。二十個代理，每個代理的描述都重疊且充斥著範例，這會讓你的主會話更容易選錯代理。這是我的推論，並非我在此目錄中實際測量的結果，但這正是我將描述限制在一兩句話的觸發條件，並將所有示例移至主體的原因——在需要之前，示例不會消耗任何資源。.

目錄清理：重複名稱、缺少標題和無法解析的型號引腳

其餘的審核工作都是些小問題，但當你批量安裝 Claude 代理模板時，這些問題就會悄無聲息地造成損害。.

十三個名字，二十六個文件

提示工程師, 內容管理器, 安全工程師, 測試自動化, 性能工程師, 事件響應人員 還有七個文件各有兩個版本，分別位於不同的類別，內容也不同。如果兩個版本都安裝，就會出現兩個檔案爭奪同一個名稱的情況，你無法從檔案名稱判斷安裝的是哪個版本。記住這一點。 內容管理器. 馬上就回來。.

六個沒有標題的文件

如果沒有 YAML 標頭，Claude Code 就無法註冊任何內容。該文件只是一個放在資料夾中的 Markdown 文件。六個檔案中的一個被提交了兩次，提交路徑重複，指向了它們自己的資料夾（業務行銷/cli 工具/組件/代理商/業務行銷/...），從錯誤目錄運行的複製命令的指紋。.

容易老化的車款系列

335名特工離職 模型 未設置，這沒問題，可以說是最佳選擇。四人錶示 模特兒：克勞德, 這不是文檔中記錄的值之一。六個引腳特定的舊版 Sonnet（克勞德十四行詩4, 克勞德十四行詩 4-5, 克勞德十四行詩-4-5-20250929已固定的型號 ID 相當於一筆維護費用，並附帶一個終止日期。我自己的堆疊式設備固定了六個型號，我曾經寫過關於它們的文章。 退休後會發生什麼.

平心而論：這個目錄是免費的，而且一直在積極維護（我克隆它的前一天它還在更新），422 個代理代表著大量的志工工作。以上這些都不算什麼醜聞。問題不在於目錄本身，而是不看說明就直接安裝。.

模板化對我自己的車隊造成了什麼影響（收據上沒有目錄）

以下是我可以親身經歷的部分。 JonOps，也就是運行我旗下品牌的系統，本身就是一個模板：一個技能文件庫，被複製到每個品牌的容器中，然後根據該品牌進行調整。這個容器包含 39 個技能文件，總計 472,860 字節，外加 22 個其他文件。 .bak 現場修復遺留的副本。.

今晚的收據來自發布此帖子的部落格。驅動其發布的部落客技巧仍然表明，在發布步驟中， “預設類別 171（星座世界）”. 在 jonjones.ai 網站上，類別 171 回傳 404 錯誤。其 Asana 步驟指向項目 1213328321428246, ，其結果為 我們愛星座, 這是艦隊中另一個不同的品牌。它要求作者在文章中添加指向“現有WLH文章”的內部鏈接，並在“首次使用占星術語時”使用斜體。總共，此容器中的39個技能文件中，有10個仍然提及它們所基於的星座品牌模板。.

這種殘留物大多無害，因為它聲音很大。它看起來不正常，而且品牌本身的配置檔案會覆蓋它。真正危險的殘留物是那種悄無聲息的。以下是來自同一車隊的三個例子：

1. 欄位名稱大小寫錯誤。. 模板寫道 地位. 該品牌的關鍵字表稱為該字段 地位. Airtable 不區分大小寫。 讀 使用公式並區分大小寫時 寫. 所以每次讀取都成功，但每次狀態寫入失敗。這種情況持續了好幾個月。這項技能首次成功關閉關鍵字是在 2026 年 10 月 8 日。.
2. 一個不存在的字段。. 影像腳本會將每張影像記錄到一個名為「影像」的欄位中。 姓名, 該品牌的圖片表中沒有該圖片。 Airtable 拒絕了該記錄，腳本退出代碼為 0。今晚回程的七張圖片也都回傳了空的記錄 ID。.
3. 一次從未成功過的交接。. 內容刷新步驟從一個名為「內容刷新」的欄位中讀取其指令。 簡報更新. 該品牌的表格稱之為 建議措施. 因此，即使是排隊等待的刷新也會返回一個空白的簡報，而且這兩個技能之間的交接在這個品牌上從未成功過。.

請注意，這些操作都沒有崩潰。當模板的假設不成立時，它很少會報錯。它通常什麼也不做，或只做一些輕微的錯誤，然後報告成功。.

Community Claude 代理範本也包含相同的假設，只不過是關於你的儲存庫而不是你的資料庫。. 前端開發者‘' 的範例對話以如下方式開頭： “首先，讓我查詢一下您現有基礎架構的上下文管理器。” 這是一個你可能尚未安裝的代理，而且在這個目錄中，它的名稱出現了兩次。依賴缺隊友的代理不會報錯，它會即興發揮。.

安裝任何 Claude Agent 模板之前的五分鐘回顧

無論模板來自產品目錄、付費店鋪還是同事的倉庫，我都會對本文中提到的所有 Claude 代理模板執行此檢查。只需五分鐘，即可檢測出上述審核中的所有問題。.

1. 請先閱讀工具部分。. 沒有一行意味著一切。對於審查者、研究人員或顧問來說，移除 Bash 和 Write 程式碼。從 Anthropic 的唯讀基線開始（閱讀、Grep、Glob）並且只添加工作證明需要的東西。.
2. 衡量描述。. 如果它超過幾句話，或者有 <example> 將範例移至正文中。每次會話都需要付費才能查看描述。.
3. 修復模型線。. 刪除無效值和過期的引腳。使用 繼承 除非你有不這麼做的理由。.
4. 對身體進行搜索。. 尋找網路通話、秘密資訊以及與其他特工的聯繫。.
5. 檢查名稱衝突 與專案和使用者代理資料夾中已有的內容進行比較。.
6. 擁有該副本。. 將文件以已知版本提交到您的程式碼倉庫，並將未來的變更以差異比較的方式進行審查。不要盲目地重新拉取更新。.

# 1-2：檢查工具行和描述的大小 grep -E '^(tools|model):' .claude/agents/new-agent.md sed -n '/^description:/,/^[az]*:/p' .claude/agents/new-agentsw whom/new-agentd -5 wm' .claude/agents/new-a. 'curl|wget|https?://|\.env|token|secret|git push' .claude/agents/new-agent.md # 4：檢查是否依賴您沒有的代理程式？ grep -noE '[az]+-(manager|engineer|reviewer|agent)' .claude/agents/new-agent.md | sort -u # 5: 名稱衝突 grep -h '^name:' .claude/agents/*.md ~/ullcude/am '^name:' .claude/agents/*.md ~/ullcude/amdgents/m/med |

那就只裝三個，別裝三十個。真正值得保留的代理，是你如果有時間自己寫的，並且精簡到適合你堆疊的那些。這和我一直以來奉行的「挑選、調整、強化」原則是一樣的。 生產環境中的 n8n 模板, 以及我之前得出的同樣的「竊取結構，而非炒作」的結論。 Everything Claude 程式碼庫.

如果您更希望由一位已經在生產環境中成功搭建過該系統的人來為您的業務進行設置，並確定範圍、權限，以及最終的交接工作，那麼我的“一站式”構建服務正是您所需要的。. 預約自動化策略會議 並帶上你即將安裝的代理程式清單。.

克勞德代理模板：常見問題解答

Claude代理模板可以安全安裝嗎？

Claude 代理模板的安全性與其工具系列一樣高。只讀代理可能會洩漏讀取的內容，但無法更改任何內容。具有 Bash 權限的代理程式可以執行您的帳戶可以執行的任何操作。在最大的目錄中，56% 授予了 Bash 權限。安裝前請閱讀標頭並使用 grep 指令檢查正文，並將檔案鎖定到已知的提交版本。.

Claude 代理模板該放在哪裡？

項目代理人進入 .claude/agents/ 它們位於程式碼庫中，因此會隨專案一起遷移，並在 Git 中進行審查。個人代理會進入其中。 ~/.claude/agents/ 並將此規則應用於機器上的每個項目。將所有具有寫入權限的檔案保留在專案級別，以便進行審核。.

代理模板和技能有什麼區別？

代理程式是一個獨立的工作進程，擁有自己的上下文視窗、工具允許清單和模型。技能是一組指令（以及可選檔案），當前會話會在配對到任務時載入這些指令。當需要隔離和更嚴格的權限設定時，請使用代理程式。當希望主會話遵循特定流程時，請使用技能。 CLAUDE.md 貼文 涵蓋了 CLAUDE.md、技能和鉤子各自所屬的位置。.

安裝的代理程式如果不使用，會消耗代幣嗎？

它們的描述確實會產生費用，因為它們會提交給主會議，以便主會議決定何時委派任務。而它們的主體內容則不會，直到被點名為止。這就是為什麼3000字的描述會產生實際費用，而3000字的主體內容通常不會產生費用的原因。.

付費的Claude代理模板比免費的更好嗎？

價格並不能說明工具系列的品質。該關鍵字的付費店鋪排名列出了八款代理，其中七款都處於「即將上線」狀態。不妨用同樣的五分鐘時間，對一款售價 $9.99 美元的代理商進行評測，就像評測一款免費代理商一樣。.

我應該安裝多少個代理模板？

根據工作需要，盡可能少地添加 Claude 代理模板。每個模板都會增加描述費用和路由選項。先從每週重複的兩三個任務開始，只有當你發現自己再次編寫相同的指令時才添加代理。.

最後總結：將每個克勞德特工範本都視為分支

Claude 代理模板目錄本身沒問題。 1900 個免費元件是一筆寶貴的財富，其中一些代理商甚至比你從零開始編寫的任何代理商都更適合作為起點。問題在於「安裝後即可高枕無憂」的模式。模板是別人根據你的程式碼庫、工具和威脅模型所做的假設，這些假設在編寫時就已經固定不變了。.

所以，把每個模板都當作叉子。仔細閱讀前四行標題。根據實際需求選擇工具。精簡描述，使其直達目標。最終確定方案並承擔責任。我的車隊曾因為沒人複製模板後重新閱讀，導致幾個月都使用了另一個品牌的類別 ID。使用任何模板的第一步都是閱讀它。.

如果你想了解像這樣的帖子背後的構建日誌，包括哪裡出了問題、花費了多少錢以及我做了哪些更改，它們會在下面的新聞簡報中發布。.