agently-playbook

agently-playbook 是开发者与架构师使用 Agently 框架构建模型驱动应用程序的核心基础技能。它专为处理模糊的产品需求而设计，例如构建助理、内部工具、自动化工作流或评估器。本技能会引导 Agent 进行需求拆解、定义项目结构与异步边界，并确保项目符合 Agently 的设计哲学，而非采用通用的开发习惯。它连接了自然语言业务需求与技术执行，是项目规划的第一步。

• 针对 Agently 原生应用程序进行项目框架搭建与架构设计。

• 自动将业务场景映射至核心能力，如 TriggerFlow、模型设置、提示词管理与输出控制。

• 优先采用异步优先原则，确保流式支持，并将设置、提示词、服务与领域模型进行清晰分离。

• 为复杂整合提供策略决策，包括选择本地模型 (Ollama) 或云端供应商，以及判断何时使用 MCP 或自定义服务。

• 将杂乱的现有实现重构为模块化、可测试且适合生产环境的架构。

• 针对不明确的产品需求或大型重构意图，务必先由此技能开始。

• 遵循五步骤工作流：简化场景、选择架构骨架、映射至原生能力、定义操作以及建立验证规则。

• 除非有严格的同步限制，否则在服务代码、流式传输与编排流程中应预设采用异步模式。

• 建议将提示词与模型设置存储于 YAML 文件，以确保项目部署弹性与代码清晰度。

• 将此视为主要路由层，待架构定义完成后，再将具体实现指派给对应的细分技能（如 knowledge-base、output-control 或 session-memory）。