agently-playbook

agently-playbook 是開發者與架構師使用 Agently 框架建構模型驅動應用程式的核心基礎技能。它專為處理模糊的產品需求而設計，例如建構助理、內部工具、自動化工作流或評估器。本技能會引導 Agent 進行需求拆解、定義專案結構與非同步邊界，並確保專案符合 Agently 的設計哲學，而非採用通用的開發習慣。它連結了自然語言業務需求與技術執行，是專案規劃的第一步。

• 針對 Agently 原生應用程式進行專案框架搭建與架構設計。

• 自動將業務場景映射至核心能力，如 TriggerFlow、模型設定、提示詞管理與輸出控制。

• 優先採用非同步優先原則，確保串流支援，並將設定、提示詞、服務與領域模型進行清晰分離。

• 為複雜整合提供策略決策，包括選擇本地模型 (Ollama) 或雲端供應商，以及判斷何時使用 MCP 或自訂服務。

• 將雜亂的現有實作重構為模組化、可測試且適合生產環境的架構。

• 針對不明確的產品需求或大型重構意圖，務必先由此技能開始。

• 遵循五步驟工作流：簡化場景、選擇架構骨架、映射至原生能力、定義操作以及建立驗證規則。

• 除非有嚴格的同步限制，否則在服務代碼、串流與協作流程中應預設採用非同步模式。

• 建議將提示詞與模型設定儲存於 YAML 檔案，以確保專案部署彈性與程式碼清晰度。

• 將此視為主要路由層，待架構定義完成後，再將具體實作指派給對應的細分技能（如 knowledge-base、output-control 或 session-memory）。