agents

此技能作為在本地開發環境中開發與管理代理式 AI 模式的綜合框架。專為軟體工程師、DevOps 從業者與 AI 架構師設計，旨在促進標準化技能文件的生成，使 Claude Code、Cursor、Cline、Windsurf 與 Copilot 等 AI 助手能夠理解特定於專案的約定、工具與架構模式。透過自動化技能結構的建立，確保 AI 助手能超越通用行為，提供針對您獨特程式碼庫的、具備高度上下文感知能力的多步驟輔助。

• Claude API 整合：提供串流訊息 API、系統提示詞設計與管理複雜使用者上下文的標準化模式，以實現可靠的推理。

• 多代理相容性：透過集中式配置管理，支援包含 GitHub Copilot、Continue、Roo、Amp、Gemini CLI 與 Goose 在內的多種熱門 AI 代理。

• 模式驅動生成：利用自動化生成器掃描專案目錄、分析依賴項 (package.json)，並輸出一致的 Markdown 格式技能定義。

• 工具呼叫支援：實現結構化的函數定義與複雜的工作流程編排，允許代理執行如檔案系統掃描或程式碼生成等特定任務。

• 詳細日誌與診斷：內建除錯功能，包括即時串流輸出至 stderr 與模擬運作偵測，確保代理決策過程的可見性。

• 需要 ANTHROPIC_API_KEY 環境變數以處理涉及 Claude 模型的進階生成任務。

• 最佳實踐包括嚴格區分提示工程檔案 (src/prompts/) 與生成器邏輯 (src/generators/)，以維持易於管理的版本控制。

• 此技能提倡「上下文優於 Token」，透過智慧篩選相關程式碼庫檔案來避免輸入溢位，確保推理任務獲得更高品質的回應。

• 在建構自定義代理模式時，務必使用非同步檔案系統操作 (fs/promises)，以避免在 Node.js 工作流程中阻塞事件迴圈。

• 限制：主要針對使用原生 ESM 模組的 Node.js 18+ 環境所設計，以確保效能並與現代 AI CLI 工具相容。