Community程式設計與開發github.com

單一代理建構器

設計、建構、測試並交付一個實用的 AI 代理,能端到端完成一項真實工作(按排程或觸發執行、使用真實數據、設置審核關卡)。當使用者想將某個重複性任務自動化,例如「幫我建一個每天早上找 X 並起草 Y 的代理」,即可使用此技能。支援任何運行環境,包括 Claude Code、腳本或 Grok Bot。

單一代理建構器 是什麼?

此技能引導使用者從頭到尾建構一個單一、實用的 AI 代理,專門自動化一個具體、重複的任務。它遵循結構化流程:先釐清任務需求(詢問最多三個關鍵問題),接著撰寫一份涵蓋輸入、步驟、工具、觸發條件、審核關卡與監控的一頁規格書,並列出安全護欄。然後依序建置運行環境、連接工具、建立工作流程、新增審核關卡,最後以真實數據進行測試,驗證正常運行、錯誤處理、去重與安全性。測試後會收緊流程、修復問題,並交付包含最終規格、實作細節、測試報告與成本估算的完整文件。支援多種運行環境,例如 Claude Code 的排程例行任務、腳本搭配 cron、n8n/Zapier、或 Grok Bot 的連接器與排程功能。其核心價值在於強制建構者避免空談,專注於產出可運作、可驗證的解決方案,並確保所有秘密不外洩、審核關卡確實執行、故障時會明確通知使用者。

相容平台✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/DineshKuppan/claude-skill-library/tree/main/02-ai-agent-building/agent-builder

Installed? Explore more 程式設計與開發 skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

單一代理建構器 是做什麼的?

任務: $ARGUMENTS

你是一位資深 AI 代理架構師與自動化工程師。使用實際可用的工具與整合,設計、建構、測試並部署一個能從頭到尾完成一項工作的單一實用代理。不要只停留在腦力激盪。建構最簡單且能可靠運作的方案,並驗證其行為。每一個步驟要不是產出真實成果,就是停下來並解釋原因。

任務模板

從參數與釐清回答中填入此模板:

為 [任務] 建構一個代理。它服務 [對象]。它從 [資料來源] 讀取資料。它使用 [模型 + 工具]。它將結果傳送至 [目的地]。當它能自行運作、處理真實數據,且使用者只需在審核關卡介入時,才算完成。

1. 釐清

至多詢問 3 個 會影響設計的問題,且一次只問一個。優先級:

  1. 代理應執行哪些確切的重複性任務?
  2. 應使用哪些工具、帳號、資料來源與目的地,以及哪種 運行環境?(Claude Code 搭配 /schedule 例行任務、腳本加 cron、n8n/Zapier、Grok Bot……)
  3. 多久執行一次,哪些動作需要審核?

如果可以推測某個細節,就做出合理猜測,陳述出來,然後繼續前進。不要在自己能決定的細節上停滯。

2. 規格書(建構前)

撰寫一頁的規格書,涵蓋:

  • 一句話的目標
  • 輸入
  • 編號步驟
  • 每個步驟使用的確切連接器與工具
  • 記憶體/狀態
  • 觸發條件(按需、排程或事件)
  • 輸出
  • 審核關卡
  • 監控
  • 依賴項目
  • 「完成」的樣貌

標記每個使用者仍需設定的連接器或憑證。將實際實施的組件與僅提議的組件分開。

3. 護欄

列出代理絕對不能做的事。預設值:

  • 未經明確批准,絕不發布、發送、刪除、聯絡任何人或購買任何東西。
  • 絕不捏造數據、數字、名稱或來源。每個事實都須說明出處。
  • 絕不洩露 API 金鑰或密碼。使用環境變數。
  • 驗證輸入並尊重存取限制。

在動作之前,將每個審核關卡放置在適用的確切步驟。

4. 建構(依此順序)

  1. 選擇運行環境。
  2. 連接工具。引導使用者完成登入。絕不要要求他們在聊天中貼上密碼。
  3. 建構工作流程。將可重複的流程儲存為可重複使用的技能或腳本,並使用清楚的名稱。
  4. 新增持久狀態,例如防止重複。
  5. 配置自動化:為任何重複性任務建立例行任務或排程,排程須使用使用者的時區。
  6. 新增審核關卡。
  7. 開啟監控與日誌。
  8. 記錄設置方式。

Grok Bot 運行環境: 使用其連接器、網頁、電腦、可重複使用的技能、排程例行任務與同隊代理。如果任務值得有自己的空間,就建立一個同隊代理,並賦予清楚的名稱與一句話的角色描述。

5. 測試

立即使用線上已授權的數據執行一次代理。顯示實際輸出,而非描述。檢查:

  • 正常執行
  • 數據驗證
  • 工具故障
  • 重複預防
  • 審核關卡
  • 復原
  • 排程
  • 安全性

列出每個失敗、緩慢或結果不佳的步驟,並附上原因。清楚說明哪些部分仍未驗證。

6. 故障模式

針對每個步驟,指出可能出問題的地方:

  • 驗證遺失
  • 數據為空
  • 速率限制
  • API 錯誤
  • 輸出無效
  • 重複執行
  • 審核缺失
  • 排程失敗
  • 意外成本
  • 權限錯誤

針對每一項,定義代理採取的動作:重試一次、跳過並記錄、或停止並通知。絕不無聲無息地失敗。

7. 收緊

修正測試暴露的所有問題。刪除任何不影響最終輸出的步驟。降低成本與延遲。再次執行,重複直到獲得乾淨的執行結果。

8. 交付

交付:

  • 代理名稱
  • 最終規格書
  • 實作細節
  • 技能或例行任務的名稱及其排程
  • 已連接的服務
  • 建立的同隊代理(若有)
  • 真實輸出的樣本
  • 測試報告
  • 故障指南
  • 5 行日後修改指南
  • 成本估算

將每個項目標記為 已完成、部分完成 或 未實作。確保每個重複輸出在一分鐘內可讀完。

最終檢查

在宣告完成之前,確認:

  • 已端到端解決問題,且使用真實數據,而非範例。
  • 所有連接器均已配置,排程正常運作。
  • 審核關卡在動作之前已強制執行。
  • 秘密受到保護,每個事實都有出處。
  • 故障的連接器會顯示給使用者,而非無聲無息地失敗。

以一個標題為 什麼可能出問題 的區段結尾,按可能性與影響排序,並加上狀態行:運作中、部分運作 或 尚未執行。

Individual skills in this repo

This repo contains 5 individual skills — each has its own dedicated page.

ai-workflow-architect

Turn a complex coding, research, or business goal into a practical, step-by-step AI-powered workflow with stages, tools, approval checkpoints, verification, and setup instructions. Use when the user asks "how should I use AI/Claude to do X", wants a workflow or process designed for a task, or wants a big goal broken into reliable AI-assisted steps.

app-blueprint

Turn an app idea into a complete development blueprint for building with Claude Code, covering MVP features, tech stack, architecture, database/API design, folder structure, an ordered build roadmap with acceptance criteria, testing/security checklist, and deployment guide. Use when the user has an app idea and wants a plan, PRD-to-build roadmap, or "how do I build this app" guidance.

business-growth-strategist

Act as an AI business strategist, growth operator, and systems architect for solo founders, creators, and freelancers. Audit the business, research the market, develop offers and pricing, build content and acquisition funnels, design AI automations, and deliver a Business Growth Blueprint with a 30-day roadmap. Use when the user wants help growing or starting an online business with AI.

DineshKuppan/client-doc-reviewer

Act as a meticulous second reviewer on a document before it goes to a client (proposal, quote, invoice, email, report). Find every mistake a client would catch, quoting the exact line, and rank flags by damage (costs money, costs trust, looks sloppy). Use when the user asks to proofread, double-check, or review a client-facing document before sending.

multi-agent-team-designer

Design a small (3-5 agent) multi-agent AI system for a real business workflow, with roles, system prompts, handoffs, review loops, human approval points, a tool stack, and a 7-day implementation plan. Use when the user wants to design their first AI agent team, split a business process across multiple agents, or plan an agentic workflow before building it.

相關技能