maestro-agent-sdk
一个轻量、可组合的TypeScript智能体SDK，用于构建AI应用。
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：maestro-agent-sdk。 它的用途是：一个轻量、可组合的TypeScript智能体SDK，用于构建AI应用。 完整的 Skill 内容见：https://321skill.com/skills/maestro-agent-sdk/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
'请分析当前项目的代码结构并生成一份简要报告。'，它会利用内置的文件系统工具读取代码，理解项目布局，并输出结构清晰的总结。开发者可以将此能力集成到自己的IDE插件或内部开发平台中，为团队提供即时项目洞察。
介绍
Maestro Agent SDK 是一个提供商无关的TypeScript智能体开发工具包，旨在解决开发者将AI能力深度集成到自有产品中的难题。它不是一个需要额外安装和管理的CLI包装器或独立应用，而是一个可以直接导入的ESM库，让你在产品内部拥有完整的智能体循环控制权。
使用时，你可以从开箱即用的 maestroProvider() 入口快速开始，它集成了内置工具、会话管理、记忆压缩和MCP支持。SDK通过异步迭代器生成标准化事件流（如文本流、工具调用、结果等），你的宿主应用可以按需消费这些事件，用于渲染、记录或持久化。
它非常适合那些希望在自己的产品（如编辑器、内部工具、SaaS平台）中嵌入AI助手，但又需要完全掌控UI、工作流、存储策略和部署方式的前后端开发者、智能体开发者和项目经理。
建议从官方文档和示例开始，理解其可组合架构。注意它需要Node.js 20+环境，且当前主要支持DeepSeek和Moonshot Kimi模型，使用前需配置相应的API密钥。
核心特点
与常见的智能体CLI包装器不同，Maestro是一个纯库，将智能体循环的控制权交还给宿主应用，而非在应用之下运行另一个产品的框架。它通过直接调用提供商API实现轻量化，避免了安装和管理额外子进程的开销。
注意事项
目前主要支持DeepSeek和Moonshot Kimi提供商，对于需要广泛集成其他主流模型（如OpenAI、Anthropic）的场景可能不够灵活。
常见问题
Maestro和LangChain/Cursor等有什么区别？
Maestro定位为轻量库，将智能体循环的控制权交给宿主应用，而非提供一套完整的应用框架或捆绑式产品，更适合需要深度自定义和集成的场景。
如何用它来开发一个AI助手？
可以快速使用`maestroProvider()`入口，或从`AIAgent`类开始组合提供商、工具和钩子，构建自定义的智能体工作流。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/maestro-agent-sdk/raw/index.md 读取 maestro-agent-sdk 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/maestro-agent-sdk/raw/index.md（查看排版版本）