deep-agents-core 是一个面向 Deep Agents 应用开发的构建技能：当你需要开发任何 Deep Agents 应用时调用它，内容覆盖 create_deep_agent()、agent harness 架构、SKILL.md 格式与配置选项。
主要能力
- 任务规划：TodoListMiddleware 用于把复杂任务拆解为待办。
- 上下文管理：文件系统工具，后端可插拔。
- 任务委派：SubAgent 中间件，用于生成专门子智能体。
- 长期记忆：通过 Store 跨线程持久化存储。
- 人机协同：为敏感操作提供审批工作流。
- Skills：按需加载专门能力。 资料说明这些能力由 agent harness 自动提供，使用者的工作是配置而不是实现。
中间件与用途对照
- TodoListMiddleware：跟踪复杂任务，默认启用。
- FilesystemMiddleware：管理文件上下文，需配置后端。
- SubAgentMiddleware：委派工作，可添加自定义子智能体。
- HumanInTheLoopMiddleware：加入人工审批，需要 checkpointer。
- SkillsMiddleware：加载技能，需提供技能目录。
- MemoryMiddleware：访问记忆，需要 Store 实例。
使用方式 先安装 deepagents，再调用 create_deep_agent()。资料给出 Python 示例：定义 @tool 函数 get_weather，调用 create_deep_agent(model="claude-sonnet-4-5-20250929", tools=[get_weather], system_prompt="You are a helpful assistant")，并以 config={"configurable": {"thread_id": "user-123"}} 调用 invoke。TypeScript 示例使用 createDeepAgent 与 @langchain/core/tools 的 tool，同样传入 model、tools、systemPrompt 后 invoke。
完整配置示例包含 name、model、tools、system_prompt、subagents、backend=FilesystemBackend(root_dir=".", virtual_mode=True)、interrupt_on={"write_file": True}、skills=["./skills/"]、checkpointer=MemorySaver()、store=InMemoryStore()；TypeScript 对应 createDeepAgent 及各同名选项。
内置工具
- 规划：write_todos。
- 文件系统：ls、read_file、write_file、edit_file、glob、grep。
- 委派：task，用于生成专门子智能体。
SKILL.md 格式 技能目录结构为 skills/my-skill/ 下放置必需的 SKILL.md，可选 examples.py 与 templates/。SKILL.md 需包含 YAML frontmatter（name、description）及正文分节 Overview、When to Use、Instructions。资料对比了 Skills 与 Memory（AGENTS.md）：Skills 按需加载、面向任务特定指令、适合大文档；Memory 启动即加载、面向通用偏好、上下文紧凑，为单个 AGENTS.md 文件。
配置边界 可配置：模型与参数、自定义工具、系统提示、后端存储策略、需要审批的工具、带专门工具的自定义子智能体。不可配置：移除核心中间件（TodoList、Filesystem、SubAgent 始终存在）、更改 write_todos/task/文件系统工具名、更改 SKILL.md frontmatter 格式。
常见错误
- 使用 interrupt_on 时必须同时提供 checkpointer。
- 使用 StoreBackend 时必须提供 store。
- 跨轮对话需复用同一 thread_id 的 config，否则每次调用相互隔离。
- SKILL.md 缺少 YAML frontmatter 会导致无法加载。
- 本地技能需配合 FilesystemBackend 才能加载。
- description 应具体而非笼统。
- 自定义子智能体不自动继承技能，需显式传入 skills。
适用场景与限制 适合需要多步规划、大上下文文件管理、专门子智能体、跨会话持久记忆的智能体构建。简单单一用途、上下文可放入单个提示、单智能体足够、或临时单会话的任务，资料建议使用 LangChain create_agent。更完整的安装命令、create_deep_agent() 完整签名、后端信任边界、审批恢复模式及选择对照表在 references/quickstart-and-backends.md 中。