massgen-config-creator

MassGen Config Creator 是 MassGen 生態系統中開發者與代理程式的核心工具。其主要目的是提供權威性的指導，協助產生結構良好且經過驗證的 YAML 設定檔，以符合既定的框架規範。透過遵守這些標準，使用者可以確保程式碼庫中的設定一致性，減少常見的執行錯誤，並優化代理程式的表現。此工具專為技術使用者、貢獻者以及需要構建可重複使用多代理程式工作流、定義後端工具整合或準備研究與案例研究設定檔的自動化代理程式而設計。

• 提供關於屬性放置的系統性指導，特別是區分後端層級設定（如 cwd 或 enable_web_search）與協調器層級設定（如 context_paths 與 planning_mode）的必要性。

• 強制執行嚴格遵守權威文件 writing_configs.rst 的規範，該文件作為所有當前慣例與結構要求的唯一真理來源。

• 鼓勵重複使用 massgen/configs/tools/ 目錄中現有穩定配置的模式，從而促進快速原型開發。

• 支援複雜多代理程式設定的建立，包括系統訊息（system_message）同步以及使用獨立目錄進行工作區隔離。

• 透過提供可靠的結構模板，協助整合各類工具，例如檔案系統、MCP、網頁搜尋以及程式碼執行環境。

• 在初始化新設定檔前，請務必先閱讀現有的設定檔（例如 massgen/configs/basic/multi/ 中的檔案），以確保與當前的命名模式（agent_description_feature.yaml）相容。

• 切勿發明新的配置屬性；請務必對照 YAML 結構參考文件與官方文件核對所有鍵值，以避免驗證失敗。

• 善用已建立的代理程式後端模式（claude, openai, gemini），並確保選擇具備成本效益的模型（例如 gpt-5-mini, gemini-2.5-flash）。

• 建立後務必使用 massgen CLI 指令搭配新設定檔進行驗證測試，以確保協調流程如預期執行。

• 當建立涉及外部資源的設定檔時，請將其正確分類至適當目錄，如 filesystem, multimodal 或 mcp，以便於組織與搜尋。