بنقرة واحدة
deepagents-subagents
在 Deep Agents 中使用 SubAgentMiddleware 启动子代理进行任务委托、上下文隔离和专门工作。
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
القائمة
在 Deep Agents 中使用 SubAgentMiddleware 启动子代理进行任务委托、上下文隔离和专门工作。
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
Mac 系统深度清理和优化工具。使用 Mole (mo 命令) 执行系统清理、磁盘分析、应用卸载、系统优化等任务。 触发场景(当用户提到以下任一内容时使用此 skill): - 清理 Mac、清理磁盘、释放空间、清理缓存、清理系统 - 卸载应用、删除应用、移除应用及其残留 - 磁盘分析、查看磁盘占用、大文件查找、空间分析 - 系统优化、系统维护、刷新系统、重建缓存 - 系统状态、系统监控、CPU/内存/磁盘监控 - 清理 node_modules、清理构建产物、清理项目依赖 - 清理安装包、删除 dmg/pkg 文件 - Mac 清理工具、类似 CleanMyMac 的功能 - "我的 Mac 太慢了"、"磁盘空间不足"、"电脑卡顿" - 即使没有明确说 "Mole",只要涉及上述场景就应使用
快速搭建和配置 pnpm monorepo 项目结构,包含 TypeScript、tsup 构建、私有 npm registry 配置。当用户需要"创建 monorepo"、"初始化 monorepo 项目"、"配置 pnpm workspace"、"设置 monorepo 构建"、"monorepo setup"时使用。特别适合需要统一管理多个包、配置构建工具、处理 TypeScript 路径问题的场景。即使用户只是说"帮我搭建项目结构"或"配置构建",如果涉及多包管理也应该使用此 skill。
智能拆分暂存区的代码变更为多个符合 Conventional Commits 规范的逻辑提交。当用户需要将大量变更按逻辑关系分组提交时使用,比如"拆分这些提交"、"把暂存区的变更分成多个 commit"、"按功能分别提交"、"split commits"等场景。特别适合处理包含多个模块、多种类型文件(配置、代码、测试、文档)的复杂变更集。
OKR 优化与质量评估专家。当用户需要:(1) 评估现有 OKR 的质量,(2) 优化模糊或不可量化的关键结果,(3) 检查 OKR 是否符合核心原则(聚焦、可量化、有挑战),(4) 将任务型 KR 转化为结果型 KR,(5) 提供具体的改进建议时使用。触发词包括"帮我优化 OKR"、"检查这个 OKR"、"这个 KR 写得好吗"、"如何量化这个目标"。
基于 git commits 自动生成 CHANGELOG.md 变更日志。支持语义化版本、分类整理、多格式输出。触发场景包括"生成变更日志"、"更新 CHANGELOG"、"版本记录"。
GitHub PR 代码审查技能。检查代码质量、安全性、性能和最佳实践,生成结构化审查报告。触发场景包括"审查 PR"、"代码检查"、"review pull request"。
| name | deepagents-subagents |
| description | 在 Deep Agents 中使用 SubAgentMiddleware 启动子代理进行任务委托、上下文隔离和专门工作。 |
| language | js |
SubAgentMiddleware 通过 task 工具实现任务委托。优势:上下文隔离、专业化、token 效率、并行执行。
默认子代理:"通用型" - 自动可用,具有与主代理相同的工具/配置。
import { createDeepAgent } from "deepagents";
import { tool } from "langchain";
import { z } from "zod";
const searchPapers = tool(
async ({ query }) => `找到 10 篇关于 ${query} 的论文`,
{
name: "search_papers",
description: "搜索学术论文",
schema: z.object({ query: z.string() }),
}
);
const agent = await createDeepAgent({
subagents: [
{
name: "research",
description: "研究学术论文并提供摘要",
systemPrompt: "你是一个研究助手。提供简洁的摘要。",
tools: [searchPapers],
model: "claude-sonnet-4-5-20250929", // 可选
}
]
});
const result = await agent.invoke({
messages: [{ role: "user", content: "研究关于 transformers 的最新论文" }]
});
import { createDeepAgent, CompiledSubAgent } from "deepagents";
const weatherGraph = createWeatherGraph(); // 你的自定义 LangGraph
const weatherSubagent = new CompiledSubAgent({
name: "weather",
description: "获取天气预报",
runnable: weatherGraph
});
const agent = await createDeepAgent({
subagents: [weatherSubagent]
});
import { createDeepAgent } from "deepagents";
import { tool } from "langchain";
import { z } from "zod";
const webSearch = tool(
async ({ query }) => `搜索结果:${query}`,
{
name: "web_search",
description: "搜索网络",
schema: z.object({ query: z.string() }),
}
);
const agent = await createDeepAgent({
subagents: [
{
name: "researcher",
description: "进行网络研究并汇编发现",
systemPrompt: "彻底搜索,保存到 /research/,返回摘要",
tools: [webSearch],
}
]
});
const result = await agent.invoke({
messages: [{
role: "user",
content: "研究电动汽车的市场趋势"
}]
});
import { createDeepAgent } from "deepagents";
import { MemorySaver } from "@langchain/langgraph";
const agent = await createDeepAgent({
subagents: [
{
name: "code-deployer",
description: "将代码部署到生产环境",
systemPrompt: "安全地部署代码并进行所有检查",
tools: [runTests, deployToProd],
interruptOn: { deploy_to_prod: true }, // 需要审批
}
],
checkpointer: new MemorySaver() // 必需
});
const agent = await createDeepAgent({
skills: ["/main-skills/"],
subagents: [
{
name: "python-expert",
description: "Python 代码审查和重构",
systemPrompt: "审查 Python 代码以获得最佳实践",
tools: [readCode, suggestImprovements],
skills: ["/python-skills/"], // 子代理特定
}
]
});
// 自定义子代理默认不继承主技能
// 通用子代理确实继承主技能
✅ 子代理名称、描述、工具 ✅ 每个子代理的不同模型 ✅ 子代理特定的提示、中间件、技能 ✅ 子代理工具的 HITL
❌ 更改 task 工具名称
❌ 使子代理有状态
❌ 在子代理之间共享状态
❌ 删除默认的通用子代理
// ❌ 子代理不记得之前的调用
await agent.invoke({messages: [{role: "user", content: "研究 X"}]});
await agent.invoke({messages: [{role: "user", content: "你发现了什么?"}]});
// 每次都是新的子代理
// ✅ 主代理维护对话内存
// ❌ 子代理不会有主技能
await createDeepAgent({
skills: ["/main-skills/"],
subagents: [{ name: "helper", ... }]
});
// ✅ 明确提供技能
await createDeepAgent({
skills: ["/main-skills/"],
subagents: [{
name: "helper",
skills: ["/helper-skills/"],
...
}]
});
// ❌ 缺少 checkpointer
await createDeepAgent({
subagents: [{
name: "deployer",
interruptOn: { deploy: true }
}]
});
// ✅ 主代理上的 Checkpointer
await createDeepAgent({
subagents: [{
name: "deployer",
interruptOn: { deploy: true }
}],
checkpointer: new MemorySaver()
});