nexau-agent

nexau-agent 技能是開發者在 NexAU 框架內構建智能代理的基礎資源。它提供了從概念到具備工具調用能力的代理所需的核心流程知識與結構化模板。此技能涵蓋了代理開發的完整生命週期，包括基於 YAML 的配置、提示詞工程、自定義工具定義以及入口腳本編寫。它專為需要集成 LLM、沙盒環境與現有工具生態的軟件工程師與 AI 開發者設計。

• 完整的實現工作流：指導需求分析、目錄結構設置以及代理驗證協議。

• 詳盡的文檔參考：整合了 NexAU 核心概念的指南，包括 Agent、Tool、LLM、Transport、Session 與高級 Hooks。

• 工具定義模板：為內置與自定義工具提供標準化架構，確保與 NexAU 架構兼容（涵蓋文件操作、網頁抓取、Shell 執行等）。

• 配置最佳實踐：針對環境變量替換、系統提示詞類型（Jinja2/string）與工具調用模式（structured/xml）的專門說明。

• 驗證與測試：提供內置驗證腳本、Python 語法檢查與代理運行時故障排查技巧。

• 集成能力：關於如何導入技能、追蹤系統（如 Langfuse）以及中間件以提升可觀測性與性能的說明。

• 當您需要啟動一個新的獨立代理項目或為現有配置添加自定義工具集時，請使用此技能。

• 請嚴格遵循定義的倉庫結構：確保 agent_name.yaml、systemprompt.md 與 start.py 的結構符合 NexAU 加載器要求。

• 在實現工具時，請先檢查是否有現成的內置工具（如 read_file、google_web_search 或 shell_tools）以滿足需求，避免重複開發 Python 綁定。

• 在開發週期早期利用內置的 validate_agent.py 進行檢查，以便在部署前發現配置錯誤。

• 參考 examples/ 目錄中複雜代理架構的實現參考，包括子代理委派與多代理協作團隊。