familiar-add-tool

familiar-add-tool 是一個專為開發者設計的工具，旨在簡化 familiar-ai 代理功能的擴展流程。無論您是整合麥克風或 GPS 等硬體感測器、機械手臂或 LED 控制器等驅動裝置，還是封裝外部 API 服務，此工具都能提供標準化的建構流程。透過自動化處理重複性的開發工作，確保代理模組化架構的一致性。

• 自動在 src/familiar_agent/tools/ 目錄下生成符合標準範本的工具類別檔案。
• 提供內建的工具定義（符合 Anthropic input_schema 格式）與執行路徑路由方法。
• 無縫更新 agent.py，處理模組匯入、初始化程序以及工具定義的註冊。
• 在 config.py 與 .env.example 檔案中自動配置必要的環境變數。
• 自動將新工具整合至代理的系統提示詞（System Prompt）中，確保大語言模型正確理解如何調用該功能。

此工具適用於開發者與進階用戶，用於為他們的 familiar-ai 夥伴建構自定義擴展功能。使用時請確保工具名稱符合 snake_case 命名規範。開發過程需要確認工具的核心動詞（即代理可執行的動作）、所需的環境設定變數，以及簡潔明瞭的系統提示詞描述。執行完成後，建議執行 ruff 等檢查工具以確保程式碼品質。此工具能大幅降低擴展代理物理或數位介面的難度，加速機器人與家庭自動化整合的開發週期。