{"id":"8d76fa37-b92a-4f99-ab5d-affeae10050a","shortId":"X4vqBA","kind":"skill","title":"Dex Async Task Manager","tagline":"用于管理长耗时、异步任务的工具集。当任务预计执行时间超过 10 秒（如模型训练、大型构建、批量数据处理）时，必须使用此工具，而不是 bash。","description":"# Dex Skill 使用指南\n\nDex 是一个专门用于处理**长耗时异步任务**的任务管理系统。它将“思考”（Agent）与“执行”（后台进程）解耦。\n\n## 核心原则：何时使用 Dex？\n\n*   **⚡ 由于网络延迟或计算量大，预计耗时 > 10 秒的操作** -> **使用 Dex**\n*   **📡 需要在 Agent 思考循环之外持续运行的服务** -> **使用 Dex**\n*   **💻 简单的文件操作、系统信息查询、快速的 CLI 命令** -> **使用 bash**\n\n## 核心定位\n\nDex 不再只是“长命令后台执行器”，而是 **Kairos 的异步任务引擎**。\n\n当任务需要被后台持续观察、需要跨轮次检查结果、需要被 Kairos handoff/attach/汇报时，必须使用 Dex。\n\n### 任务完成标准\n- 任务必须有明确的结构化状态：`pending/running/completed/failed/canceled`\n- 任务必须暴露结构化结果摘要与错误摘要\n- 任务必须提供日志 artifact 路径\n- 任务必须能被 Kairos 通过 bridge 稳定读取\n\n## 工具详解\n\nDex 提供了一组原生 Python 工具，Agent 可以直接调用：\n\n### 1. `dex_create_task`\n创建一个新的任务记录。\n*   `description`: 任务简述 (e.g. \"Fine-tune model v2\")\n*   `context`: 详细参数或目标\n\n### 2. `dex_start_task`\n**关键步骤**。启动一个后台进程来执行具体命令。\n*   `task_id`: `dex_create_task` 返回的 ID\n*   `command`: 完整的命令行字符串 (e.g. \"python scripts/train.py --epochs 100\")\n*   **注意**：命令会在后台**异步执行**，Agent 会立即获得 \"Task started\" 的响应，而不会被阻塞。\n\n### 3. `dex_list_tasks` & `dex_get_task_details`\n查询任务状态。\n*   定期调用 `dex_list_tasks` 查看任务是否从 `running` 变为 `completed`。\n*   任务完成后，调用 `dex_get_task_details` 查看 `result` 字段中的日志摘要。\n\n## 典型工作流 (Workflow)\n\n**场景：用户要求开始一个耗时的训练任务。**\n\n1.  **创建任务**\n    ```python\n    task_info = dex_create_task(description=\"Training Llama3\", context=\"Epochs: 50, Data: data.csv\")\n    # Returns: {\"id\": \"a1b2c3d4\", ...}\n    ```\n\n2.  **启动进程**\n    ```python\n    dex_start_task(task_id=\"a1b2c3d4\", command=\"python train_model.py --data data.csv\")\n    # Returns: [OK] Task started in background...\n    ```\n\n3.  **Agent 继续其他工作... (或者每隔几轮对话检查一次)**\n\n4.  **检查状态**\n    ```python\n    tasks = dex_list_tasks()\n    # Returns: [{\"id\": \"a1b2c3d4\", \"status\": \"completed\", \"result\": \"...\"}]\n    ```\n\n5.  **查看结果**\n    ```python\n    details = dex_get_task_details(\"a1b2c3d4\")\n    # 分析 details['result'] 中的日志，回报给用户。\n    ```\n\n## 注意事项\n\n*   所有输出都会被重定向到 `.dex/logs/{id}.log`。\n*   如果是 Windows 环境，后台进程是一个独立的进程；Linux 下是 nohup 进程。\n*   如果任务失败，`status` 会变成 `completed`，但在 `result` 中会包含 \"FAILED\" 字样和错误码。","tags":["dex","google","adk","agent","valkryhx","agent-development","agent-skills","agent-swarm","agent-team","agentic-ai","dynamic-skills","google-adk"],"capabilities":["skill","source-valkryhx","skill-dex","topic-agent-development","topic-agent-skills","topic-agent-swarm","topic-agent-team","topic-agentic-ai","topic-dynamic-skills","topic-google-adk","topic-vibe-coding"],"categories":["google_adk_agent"],"synonyms":[],"warnings":[],"endpointUrl":"https://skills.sh/valkryhx/google_adk_agent/dex","protocol":"skill","transport":"skills-sh","auth":{"type":"none","details":{"cli":"npx skills add valkryhx/google_adk_agent","source_repo":"https://github.com/valkryhx/google_adk_agent","install_from":"skills.sh"}},"qualityScore":"0.453","qualityRationale":"deterministic score 0.45 from registry signals: · indexed on github topic:agent-skills · 6 github stars · SKILL.md body (1,942 chars)","verified":false,"liveness":"unknown","lastLivenessCheck":null,"agentReviews":{"count":0,"score_avg":null,"cost_usd_avg":null,"success_rate":null,"latency_p50_ms":null,"narrative_summary":null,"summary_updated_at":null},"enrichmentModel":"deterministic:skill-github:v1","enrichmentVersion":1,"enrichedAt":"2026-05-18T19:14:45.242Z","embedding":null,"createdAt":"2026-05-18T13:22:13.410Z","updatedAt":"2026-05-18T19:14:45.242Z","lastSeenAt":"2026-05-18T19:14:45.242Z","tsv":"'1':86,160 '10':8,36 '100':120 '2':101,179 '3':130,199 '4':203 '5':216 '50':173 'a1b2c3d4':178,187,212,224 'agent':26,41,84,124,200 'artifact':72 'async':2 'background':198 'bash':16,51 'bridg':77 'cli':48 'command':114,188 'complet':146,214,246 'context':99,171 'creat':88,110,166 'data':174,191 'data.csv':175,192 'descript':91,168 'detail':137,152,219,223,226 'dex':1,17,20,33,39,44,53,66,80,87,102,109,131,134,140,149,165,182,207,220 'dex/logs':232 'e.g':93,116 'epoch':119,172 'fail':250 'fine':95 'fine-tun':94 'get':135,150,221 'handoff/attach':63 'id':108,113,177,186,211,233 'info':164 'kairo':57,62,75 'linux':239 'list':132,141,208 'llama3':170 'log':234 'manag':4 'model':97 'nohup':241 'ok':194 'pending/running/completed/failed/canceled':69 'python':82,117,162,181,189,205,218 'result':154,215,227,248 'return':176,193,210 'run':144 'scripts/train.py':118 'skill':18 'skill-dex' 'source-valkryhx' 'start':103,127,183,196 'status':213,244 'task':3,89,104,107,111,126,133,136,142,151,163,167,184,185,195,206,209,222 'topic-agent-development' 'topic-agent-skills' 'topic-agent-swarm' 'topic-agent-team' 'topic-agentic-ai' 'topic-dynamic-skills' 'topic-google-adk' 'topic-vibe-coding' 'train':169 'train_model.py':190 'tune':96 'v2':98 'window':236 'workflow':157 '下是':240 '不再只是':54 '与':27 '中会包含':249 '中的日志':228 '任务完成后':147 '任务完成标准':67 '任务必须提供日志':71 '任务必须暴露结构化结果摘要与错误摘要':70 '任务必须有明确的结构化状态':68 '任务必须能被':74 '任务简述':92 '会变成':245 '会立即获得':125 '但在':247 '何时使用':32 '使用':38,43,50 '使用指南':19 '关键步骤':105 '典型工作流':156 '分析':225 '创建一个新的任务记录':90 '创建任务':161 '变为':145 '可以直接调用':85 '后台进程':29 '后台进程是一个独立的进程':238 '启动一个后台进程来执行具体命令':106 '启动进程':180 '命令':49 '命令会在后台':122 '回报给用户':229 '场景':158 '大型构建':11 '如果任务失败':243 '如果是':235 '如模型训练':10 '字样和错误码':251 '字段中的日志摘要':155 '它将':24 '完整的命令行字符串':115 '定期调用':139 '工具':83 '工具详解':79 '异步任务的工具集':6 '异步执行':123 '当任务需要被后台持续观察':59 '当任务预计执行时间超过':7 '必须使用':65 '必须使用此工具':14 '快速的':47 '思考':25 '思考循环之外持续运行的服务':42 '或者每隔几轮对话检查一次':202 '所有输出都会被重定向到':231 '执行':28 '批量数据处理':12 '提供了一组原生':81 '时':13 '是一个专门用于处理':21 '查看':153 '查看任务是否从':143 '查看结果':217 '查询任务状态':138 '核心原则':31 '核心定位':52 '检查状态':204 '汇报时':64 '注意':121 '注意事项':230 '环境':237 '用于管理长耗时':5 '用户要求开始一个耗时的训练任务':159 '由于网络延迟或计算量大':34 '的任务管理系统':23 '的响应':128 '的异步任务引擎':58 '秒':9 '秒的操作':37 '稳定读取':78 '简单的文件操作':45 '系统信息查询':46 '继续其他工作':201 '而不会被阻塞':129 '而不是':15 '而是':56 '解耦':30 '详细参数或目标':100 '调用':148 '路径':73 '返回的':112 '进程':242 '通过':76 '长命令后台执行器':55 '长耗时异步任务':22 '需要在':40 '需要被':61 '需要跨轮次检查结果':60 '预计耗时':35","prices":[{"id":"2ed63e8a-7b5f-4db7-9475-a3f61b882f31","listingId":"8d76fa37-b92a-4f99-ab5d-affeae10050a","amountUsd":"0","unit":"free","nativeCurrency":null,"nativeAmount":null,"chain":null,"payTo":null,"paymentMethod":"skill-free","isPrimary":true,"details":{"org":"valkryhx","category":"google_adk_agent","install_from":"skills.sh"},"createdAt":"2026-05-18T13:22:13.410Z"}],"sources":[{"listingId":"8d76fa37-b92a-4f99-ab5d-affeae10050a","source":"github","sourceId":"valkryhx/google_adk_agent/dex","sourceUrl":"https://github.com/valkryhx/google_adk_agent/tree/main/skills/dex","isPrimary":false,"firstSeenAt":"2026-05-18T13:22:13.410Z","lastSeenAt":"2026-05-18T19:14:45.242Z"}],"details":{"listingId":"8d76fa37-b92a-4f99-ab5d-affeae10050a","quickStartSnippet":null,"exampleRequest":null,"exampleResponse":null,"schema":null,"openapiUrl":null,"agentsTxtUrl":null,"citations":[],"useCases":[],"bestFor":[],"notFor":[],"kindDetails":{"org":"valkryhx","slug":"dex","github":{"repo":"valkryhx/google_adk_agent","stars":6,"topics":["agent-development","agent-skills","agent-swarm","agent-team","agentic-ai","dynamic-skills","google-adk","vibe-coding"],"license":null,"html_url":"https://github.com/valkryhx/google_adk_agent","pushed_at":"2026-04-23T07:34:09Z","description":"a startup but not simple agent demo using  google adk.","skill_md_sha":"940c315efb0236096b883614dcca8e62f0551555","skill_md_path":"skills/dex/SKILL.md","default_branch":"main","skill_tree_url":"https://github.com/valkryhx/google_adk_agent/tree/main/skills/dex"},"layout":"multi","source":"github","category":"google_adk_agent","frontmatter":{"name":"Dex Async Task Manager","description":"用于管理长耗时、异步任务的工具集。当任务预计执行时间超过 10 秒（如模型训练、大型构建、批量数据处理）时，必须使用此工具，而不是 bash。"},"skills_sh_url":"https://skills.sh/valkryhx/google_adk_agent/dex"},"updatedAt":"2026-05-18T19:14:45.242Z"}}