create-agent

create-agent 技能為開發者提供了一個強大的架構框架，用於使用 gitagent 標準構建 AI 代理。它作為 scaffold 新專案的權威指南，確保您的設定檔（如 agent.yaml、SOUL.md 與 RULES.md）符合最佳實踐，提升專案的可維護性與擴展性。此技能對於希望在 Git-native 環境中定義精確模型限制、執行行為與複雜子代理委派模式的開發者至關重要。透過利用此工具，您可以確保專案結構針對 gitagent 生態系統進行優化，包括技能、工具與知識庫的正確擺放。

• 引導設定 agent.yaml，明確模型偏好、備援機制以及 runtime 參數，例如溫度 (temperature)、最大回合數 (max_turns) 與逾時限制 (timeout)。

• 自動生成核心身份檔案，包括定義代理人格的 SOUL.md 以及建立硬性邊界與互動限制的 RULES.md。

• 標準化的目錄架構設計，適用於 skills/ 與 tools/ 模組，確保其能被正確發現與執行。

• 支援子代理定義，透過明確的委派模式與觸發機制，啟用複雜的多代理工作流。

• 整合知識庫管理 (knowledge/index.yaml)，讓您能將參考文件與 Markdown 上下文直接載入至系統提示詞中。

• 強制執行 README.md 生成的最佳實踐，確保每個代理專案都包含可執行的安裝說明、結構圖與註冊連結。

• 在新增專門技能或知識庫之前，請務必先在 SOUL.md 中定義您的核心代理身份。

• 修改設定檔後，請頻繁使用驗證指令 (validate) 以捕捉 agent.yaml 中的架構錯誤或結構不一致。

• 確保您的 skills/ 目錄遵循 SKILL.md 格式，以便與註冊中心發現機制與跨專案的可重用性相容。

• 定義工具時，請嚴格映射至 tools/ 目錄下的對應 YAML 檔案，以防止執行階段解析錯誤。

• 本工具專為 gitagent CLI 環境設計，不處理代理編排之外的外部應用程式邏輯。