Communitygithub.com

curiositech/windags-skills

建構並採用 2026 年的生產級 AI 代理基礎設施。涵蓋框架選擇、編排模式、評估、可觀測性、記憶系統與工具使用,以及組織內部的推廣與採用策略。

windags-skills 是什麼?

此技能專注於協助團隊建立與大規模採用生產環境就緒的 AI 代理基礎設施,涵蓋技術與組織兩個面向。技術上,它提供框架選擇的決策指南(如 LangGraph、CrewAI、AutoGen、MCP)、架構設計(從簡單代理到代理網格)、成本管理、記憶系統架構、可觀測性與評估管道。組織面上,它引導如何向不同利害關係人(工程、產品、安全、高層)推廣 AI 代理,計算 ROI,管理變革,並建立信任與採用。技能內含豐富的失敗模式分析(如框架優先思維、預算爆炸、採用停滯)與三個具體的工作範例(企業程式碼審查代理、框架遷移、多團隊採用 AI Studio 模型),幫助開發者避開常見陷阱,從試點順利擴展到生產環境。此技能在 Cursor、Claude Code 與其他 AI 代理開發平台上都適用。

相容平台~Claude Code✓Codex CLI~Cursor✓Antigravity
npx skills add https://github.com/curiositech/windags-skills/tree/HEAD/skills/agentic-infrastructure-2026

在你喜歡的 AI 中提問

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

說明文件

2026 年代理基礎設施

您是建構、評估與推廣 AI 代理基礎設施的專家。您同時理解技術景觀(框架、協定、可觀測性)與組織挑戰(採用、ROI、信任)。

決策點

1. 框架選擇

如果需要複雜的多步驟工作流程(含條件分支):

  • 使用 LangGraph(基於圖的狀態機)
  • 從第一天起就加入可觀測性
  • 為學習曲線預算 $5-20k

如果需要多代理協作處理共享任務:

  • 使用 CrewAI(基於角色的團隊)
  • 從 3-5 個代理的團隊開始
  • 預期 2-3 週的上手時間

如果身處 Microsoft 生態系 /.NET 環境:

  • 使用 Semantic Kernel
  • 善用現有 Azure 投資
  • 專注於外掛程式架構

如果需要跨提供者的工具互通性:

  • 實作 MCP 協定
  • 使用延遲工具載入以提高上下文效率
  • 規劃 40-50% 的上下文開銷

如果只需要簡單的助手與檔案檢索:

  • 使用 OpenAI Assistants API
  • 接受供應商鎖定的取捨
  • 適用於 MVP/原型

2. 架構複雜度

如果是單一用途代理:

簡單:使用者 → 代理 → 工具 → 回應

如果是多步驟工作流程:

LangGraph:使用者 → 狀態機 → [工具 A → 決策 → 工具 B] → 回應

如果需要團隊協作:

代理網格:使用者 → LangGraph 協調器 → CrewAI 團隊 → MCP 工具

3. 採用策略

如果面對工程領導層:

  • 以開發者生產力指標開場
  • 展示「3 位工程師 + 代理 = 8 位工程師的產出」
  • 在程式碼審查/測試生成上進行示範

如果面對產品領導層:

  • 以上市時間加速開場
  • 展示衝刺壓縮(2 週 → 2 天)
  • 強調競爭優勢

如果面對安全/合規團隊:

  • 以受控自動化開場
  • 展示核准關卡與稽核軌跡
  • 強調 MCP 治理(Linux 基金會)

如果面對高層主管:

  • 以策略性能力建構開場
  • 展示包含保守估計的 ROI 模型
  • 將其定位為組織肌肉

4. 成本管理

如果每分鐘 Token 使用量 > 100k:

  • 實作基於 Token 的速率限制(而非請求次數)
  • 加入具有成本追蹤的 AI 閘道
  • 設定每個任務的預算上限

如果有多個團隊使用代理:

  • 建立集中式 AI Studio 模型
  • 共享 SDK 與 MCP 伺服器
  • 每個團隊的配額管理

如果是生產環境部署:

  • 務必包含緊急停止開關
  • 每日/每月預算警報
  • 每個工作流程的成本歸屬

5. 記憶體架構

如果是單次對話:

  • 使用工作記憶(僅限上下文視窗)

如果是多輪對話:

  • 加入短期記憶(執行緒/對話狀態)
  • 實作對話摘要

如果需要使用者個人化:

  • 加入長期記憶(向量資料庫/資料庫)
  • 根據相關性查詢,而非時間順序

如果需要除錯/稽核:

  • 加入情節記憶(事件日誌)
  • 啟用重播以進行錯誤分析

失敗模式

1. 框架優先思維

**症狀:**團隊在定義工作流程之前就選了 LangGraph,陷入設定地獄 **偵測規則:**如果你在撰寫需求之前就在閱讀框架文件,你就在這裡 解決方案:

  • 先定義 3 個特定的代理工作流程
  • 繪製決策點與工具呼叫
  • 然後選擇最符合這些模式的框架

2. 上下文預算爆炸

**症狀:**代理在簡單任務上花費超過 $2,回應速度慢,遇到 Token 限制 **偵測規則:**如果 MCP 工具綱要在開始實際工作之前就消耗了超過 50% 的上下文,你就在這裡 解決方案:

  • 實作延遲工具載入(按需載入綱要)
  • 使用工具壓縮/摘要
  • 加入工具路由層(輕量級分類器)

3. 可觀測性債務

**症狀:**代理靜默失敗,無法除錯,沒有成本可見性 **偵測規則:**如果你使用 console.log 來除錯代理行為,你就在這裡 解決方案:

  • 在首次生產執行之前就接入 LangSmith/Braintrust
  • 在四個層級進行儀器化:請求、追蹤、品質、漂移
  • 設定與開發平行的評估管道

4. 採用停滯

**症狀:**出色的示範,但沒有生產使用,團隊恢復手動流程 **偵測規則:**如果試點已經「幾乎準備好」超過 3 個月,你就在這裡 解決方案:

  • 從無聊、充分理解的工作流程開始
  • 虔誠地測量節省的時間
  • 讓人工保持於迴圈中並可見(核准關卡)
  • 低調承諾,超額交付結果

5. 成本失控

**症狀:**收到 $500+ 的意外帳單,代理陷入無限迴圈,沒有預算控制 **偵測規則:**如果你不知道每項任務的成本在哪個 $1 範圍內,你就在這裡 解決方案:

  • 實作每個任務的成本上限(最高 $5)
  • 加入斷路器(最大重試次數、超時)
  • 基於 Token 的速率限制,而非基於請求

工作範例

範例 1:企業程式碼審查代理(LangGraph + ROI)

**情境:**工程團隊希望代理協助程式碼審查,減少審查者的負擔

決策過程:

  1. **框架選擇:**複雜工作流程(讀取 PR → 分析差異 → 檢查標準 → 產生回饋)

    • 決策:使用 LangGraph 進行條件分支
    • 考慮的替代方案:CrewAI(拒絕 - 單一代理任務,非團隊)
  2. 架構設計:

    PR 建立 → LangGraph 狀態機:
    ├─ 取得差異(GitHub MCP)
    ├─ 安全掃描(如果包含認證/機密)
    ├─ 風格檢查(如果語言是 Python/JS)
    ├─ 測試涵蓋率(如果修改了測試)
    └─ 產生審查意見
    
  3. **試點範圍:**從一個儲存庫開始,僅限非關鍵審查

    • 仍需要人類審查者進行核准
    • 代理提供「預審」建議
  4. ROI 計算:

    之前:平均每次審查 45 分鐘 × $75/小時 = $56.25 每次審查
    之後:人類 10 分鐘 + 代理成本 $2.50 = $14.00 每次審查
    節省:每次審查 $42.25 × 每月 200 次審查 = 每月 $8,450
    基礎設施成本:每月 $1,200(LangSmith + 運算)
    淨節省:每月 $7,250
    
  5. **新手忽略之處:**會建構複雜的多代理系統,跳過評估管道

  6. **專家會抓到:**從簡單開始,測量一切,逐步擴展

**結果:**審查週期時間減少 67%,89% 的代理建議被人類接受

範例 2:框架遷移(AutoGen → LangGraph)

**情境:**團隊擁有 AutoGen v0.2 多代理研究系統,需要生產可靠性

決策過程:

  1. **遷移觸發:**AutoGen 對話不可預測、難以除錯、沒有狀態持久性

  2. 框架分析:

    • 目前:AutoGen 的自由形式對話模型
    • 目標:LangGraph 的明確狀態機
    • 取捨:更多的設定複雜度換取更好的控制
  3. 遷移策略:

    階段 1:平行實作(兩個系統同時運行)
    階段 2:A/B 測試相同的研究任務
    階段 3:品質比較(準確性、成本、可靠性)
    階段 4:完全切換
    
  4. 主要差異:

    AutoGen 模式:
    代理 A:「這是我的分析」
    代理 B:「我不同意因為...」
    代理 A:「好觀點,讓我修改...」
    (持續直到超時/達成共識)
    
    LangGraph 模式:
    狀態:{問題, 分析[], 需要共識}
    節點:分析師 → 分析
    節點:評論者 → 評論
    邊緣:如果評論分數 > 0.8 → 共識,否則 → 分析師
    
  5. **新手忽略之處:**會一次全部重寫,沒有比較指標

  6. **專家會抓到:**系統平行運行,測量品質差異,逐步遷移

**結果:**失敗的研究執行減少 73%,成本降低 45%,執行路徑確定性

範例 3:多團隊採用(AI Studio 模型)

**情境:**5 個工程團隊想要代理基礎設施,沒有中央協調

決策過程:

  1. **問題:**每個團隊建構孤立的解決方案,重複努力,沒有學習轉移

  2. **解決方案:**提供共享基礎設施的集中式 AI Studio

  3. Studio 架構:

    AI Studio 提供:
    ├─ 預先建置的 MCP 伺服器(GitHub、Jira、Slack、AWS)
    ├─ 評估框架範本
    ├─ 成本監控儀表板
    ├─ 代理部署管道
    └─ 最佳實踐文件
    
    團隊消費:
    ├─ 他們語言/框架的 SDK
    ├─ 預先配置的可觀測性
    ├─ 共享工具協定
    └─ 成本配額與護欄
    
  4. 上線策略:

    • 第 1 個月:團隊 A(最有動機)在 Studio 支援下進行試點
    • 第 2 個月:記錄學習,改進 Studio 產品
    • 第 3 個月:團隊 B 和 C 使用改進的工具集加入
    • 第 4-6 個月:團隊 D 和 E 加入,Studio 變成自助服務
  5. 成功指標:

    技術指標:
    - 第一個可工作代理的時間:3 天 → 1 天
    - 跨團隊程式碼重用:0% → 70%
    - 每個團隊的基礎設施成本:$5k → $1.2k
    
    組織指標:
    - 活躍使用代理的團隊:1 → 5
    - 跨團隊知識分享:每週示範
    - 高層信心:每季 ROI 報告
    
  6. **新手忽略之處:**會讓團隊孤立地建構,重複發明輪子

  7. **專家會抓到:**集中平台創造網路效應,減少重複學習

**結果:**5 個團隊在 6 個月內部署了生產代理,80% 的基礎設施程式碼重用

品質關卡

技術基礎設施:
[ ] 以記錄的決策標準選擇框架(符合使用案例)
[ ] MCP 工具伺服器配置了延遲載入(上下文消耗 < 50%)
[ ] 可觀測性管線已運作(LangSmith/Braintrust/Langfuse)
[ ] 評估套件涵蓋單元/軌跡/端到端測試
[ ] 成本控制已啟用(每個任務上限、每日配額、緊急停止開關)
[ ] 記憶體架構已記錄(工作/短期/長期記憶邊界)

組織準備度:
[ ] 試點範圍限定於單一團隊、單一工作流程(非企業級)
[ ] ROI 測量框架已定義,包含基準指標
[ ] 利害關係人溝通針對不同受眾量身定制(工程/產品/高層/安全)
[ ] 人工在迴圈中的核准關卡可見且已記錄
[ ] 成功標準以二元的通過/失敗條件定義
[ ] 採用擴展計畫已記錄(試點 → 規模化路徑)

生產就緒度:
[ ] 安全性審查已完成(PII 過濾、稽核軌跡、存取控制)
[ ] 錯誤處理已記錄(重試邏輯、斷路器、升級路徑)
[ ] 效能基準已建立(延遲 SLA、吞吐量目標)
[ ] 事件回應程序已定義(誰被呼叫、復原計畫)

非適用邊界

此技能不適用於:

  • 建構特定的代理行為 → 請使用 agentic-patterns

    • 如果你需要對話流程、提示鏈或推理策略
  • 實作 RAG 系統或聊天機器人 → 請使用 ai-engineer

    • 如果你在建立知識檢索、語意搜尋或簡單的問答系統
  • 提示詞最佳化與調校 → 請使用 prompt-engineer

    • 如果你在除錯模型輸出、最佳化提示詞或少樣本學習
  • DAG 工作流程設計 → 請使用 windags-architect

    • 如果你在建立資料管道、ETL 工作流程或傳統編排
  • LLM 微調或模型訓練 → 請使用特定領域技能

    • 基礎設施關乎編排,而非模型客製化

當以下情況時,委派給其他技能:

  • 請求涉及特定的代理對話模式 → agentic-patterns
  • 問題與模型選擇或提示詞工程有關 → ai-engineer + prompt-engineer
  • 重點在於資料工作流程編排 → windags-architect
  • 需要變革管理流程的協助 → change-management(如果存在)

Individual skills in this repo

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

curiositech/windags-skills

Expert in 2000s-era music visualization (Milkdrop, AVS, Geiss) and modern WebGL implementations. Specializes in Butterchurn integration, Web Audio API AnalyserNode FFT data, GLSL shaders for audio-reactive visuals, and psychedelic generative art. Activate on "Milkdrop", "music visualization", "WebGL visualizer", "Butterchurn", "audio reactive", "FFT visualization", "spectrum analyzer". NOT for simple bar charts/waveforms (use basic canvas), video editing, or non-audio visuals.

curiositech/windags-skills

Expert legal research agent for finding and scraping expungement data state by state. Knows authoritative sources, URL patterns, Firecrawl configuration, and 2026 legal landscape.

curiositech/windags-skills

Expert in 3D computer vision labeling tools, workflows, and AI-assisted annotation for LiDAR, point clouds, and sensor fusion. Covers SAM4D/Point-SAM, human-in-the-loop architectures, and vertical-specific training strategies. Activate on '3D labeling', 'point cloud annotation', 'LiDAR labeling', 'SAM 3D', 'SAM4D', 'sensor fusion annotation', '3D bounding box', 'semantic segmentation point cloud'. NOT for 2D image labeling (use clip-aware-embeddings), general ML training (use ml-engineer), video annotation without 3D (use computer-vision-pipeline), or VLM prompt engineering (use prompt-engineer).

curiositech/windags-skills

Implement WCAG 2.2 AA/AAA compliance with automated testing, keyboard navigation, screen reader support, and focus management. Activate on: accessibility audit, WCAG compliance, keyboard navigation, screen reader, aria attributes, axe-core, focus trap. NOT for: design-level accessibility review (use design-accessibility-auditor), color contrast only (use css-in-js-architect).

curiositech/windags-skills

Time-blind friendly planning, executive function support, and daily structure for ADHD brains. Specializes in realistic time estimation, dopamine-aware task design, and building systems that actually work for neurodivergent minds.

curiositech/windags-skills

Designs digital experiences for ADHD brains using neuroscience research and UX principles. Expert in reducing cognitive load, time blindness solutions, dopamine-driven engagement, and compassionate design patterns. Activate on 'ADHD design', 'cognitive load', 'accessibility', 'neurodivergent UX', 'time blindness', 'dopamine-driven', 'executive function'. NOT for general accessibility (WCAG only), neurotypical UX design, or simple UI styling without ADHD context.

curiositech/windags-skills

>- Apply crisis decision-making research to agent routing, uncertainty triage, and coordination failure analysis in time-pressured systems. Use when diagnosing handoff failures, analytical paralysis, or expert judgment under incomplete information. NOT for routine coding, simple CRUD design, or static single-agent tasks with complete information.

curiositech/windags-skills

Extend and modify the admin dashboard, developer portal, and operations console. Use when adding new admin tabs, metrics, monitoring features, or internal tools. Activates for dashboard development, analytics, user management, and internal tooling.

curiositech/windags-skills

Conversation patterns and interaction protocols for multi-agent systems. Covers request/response, pub/sub, blackboard, delegation chains, debate, critique, consensus, fan-out/fan-in, supervisor-worker, and peer negotiation. Deep analysis of AutoGen conversation patterns, CrewAI delegation, LangGraph state passing, and FIPA-ACL performatives. Teaches how to design what agents say to each other and in what order. Activate on: "agent conversation", "agent protocol", "multi-agent debate", "agent delegation", "supervisor worker pattern", "agent voting", "consensus protocol", "fan-out fan-in", "agent negotiation", "blackboard pattern", "agent dialogue", "conversation topology", "agent handoff". NOT for: wire format or serialization (use agent-interchange-formats), orchestration infrastructure (use agentic-infrastructure-2026), single agent behavior (use agentic-patterns).

curiositech/windags-skills

Meta-agent for creating new custom agents, skills, and MCP integrations. Expert in agent design, MCP development, skill architecture, and rapid prototyping. Activate on 'create agent', 'new skill', 'MCP server', 'custom tool', 'agent design'. NOT for using existing agents (invoke them directly), general coding (use language-specific skills), or infrastructure setup (use deployment-engineer).

curiositech/windags-skills

AI-powered calendar management and agent-based scheduling coordination. Covers calendar APIs (Google Calendar, CalDAV/iCal), AI scheduling assistants (Reclaim, Clockwise, Motion, Cal.com), building custom calendar agents with MCP, multi-calendar merging, timezone management, focus block protection, meeting fatigue detection, and agent-to-agent meeting negotiation protocols. Activate on: "calendar agent", "AI scheduling", "calendar coordination", "meeting scheduling", "calendar API", "focus time protection", "calendar optimization", "Google Calendar MCP", "Reclaim", "Clockwise", "Motion", "Cal.com", "smart scheduling", "calendar-aware agent", "timezone scheduling", "agent negotiation meetings". NOT for: manual calendar UI component design (use form-validation-architect), project management scheduling or Gantt charts (use project-management-guru-adhd), general time-tracking or pomodoro apps (use adhd-daily-planner for time-awareness), building the agent itself from scratch (use agent-creator).

curiositech/windags-skills

Fundamental patterns for effective agentic behavior. Teaches decomposition, tool orchestration, error recovery, context management, quality self-assessment, and knowing when to stop. Model-agnostic principles that make any agent more effective regardless of domain. Activate on: "how should I structure this agent", "agentic workflow", "agent patterns", "multi-step task", "tool orchestration", "/agentic-patterns", "decompose this", "agent best practices", "chain of actions", "when should the agent stop", "agent loop design". NOT for: creating agent infrastructure (use agent-creator), building DAGs (use windags-architect), specific tool implementation.

curiositech/windags-skills

Automated discovery and matching of agent skills for dynamic task routing and capability assessment

curiositech/windags-skills

Cryptographic security for agentic systems — zero-trust agent networking, signed message envelopes (JWS/JWE), capability-based security (ocaps), Merkle tree audit trails, WASM sandboxing, and formal verification. Covers CLI dev tool security, mTLS between agents, permission boundaries (least privilege for AI agents), and supply chain security for skills/plugins. Activate on: "agent security", "zero trust agents", "secure agent communication", "capability-based security", "ocap", "signed messages between agents", "agent audit trail", "sandbox agent execution", "agent permissions", "mTLS agents", "cryptographic verification", "agent supply chain", "OWASP agentic", "prove agent did X", "tamper-proof agent logs". NOT for: application-level SAST scanning (use security-auditor), network firewall rules (use infrastructure), SOC2/HIPAA compliance (organizational), or prompt injection defense (use prompt-engineer).

curiositech/windags-skills

Data structures and serialization formats for agent-to-agent communication. Covers message envelopes, structured output schemas, capability declarations, task handoff payloads, error/retry signaling, and context windows as data structures. Deep comparison of A2A protocol, MCP, OpenAI function calling, and LangChain message types. Teaches when to use rigid schemas vs free-form with validation, typed vs untyped, streaming vs batch. Activate on: "agent message format", "agent communication schema", "agent-to-agent protocol", "A2A protocol", "MCP message format", "structured output for agents", "agent interop", "interchange format", "agent serialization", "task handoff format", "capability declaration". NOT for: what agents say to each other (use agent-conversation-protocols), orchestration topology (use multi-agent-coordination), building agent infrastructure (use agentic-infrastructure-2026).

curiositech/windags-skills

Logic-based agent programming language implementing BDI architecture for practical autonomous agent development

curiositech/windags-skills

>- Design AgentSpeak(L)-style BDI agents with context-guarded plans, selection functions, and intention stacks. Use for interruptible autonomy, agent policy, and multi-agent orchestration in dynamic environments. NOT for simple rule engines, static planners, or centralized workflows.

curiositech/windags-skills

Foundational concurrent computation model where actors communicate exclusively through asynchronous message passing

curiositech/windags-skills

Build production-ready LLM applications, advanced RAG systems, and intelligent agents. Implements vector search, multimodal AI, agent orchestration, and enterprise AI integrations. Use PROACTIVELY for LLM features, chatbots, AI agents, or AI-powered applications.

curiositech/windags-skills

license: Apache-2.0 NOT for unrelated tasks outside this domain.

相關技能