valkryhx/google_adk_agent / skills/dex
Dex Async Task Manager
Verified用于管理长耗时、异步任务的工具集。当任务预计执行时间超过 10 秒(如模型训练、大型构建、批量数据处理)时,必须使用此工具,而不是 bash。
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 3.2 KB |
| assets/example_asset.txt | markdown | 865 B |
| dex.py | script | 4.3 KB |
| dex_exec.py | script | 3.1 KB |
| models.py | script | 2.6 KB |
| references/api_reference.md | markdown | 954 B |
| scripts/example.py | script | 565 B |
| store.py | script | 4.5 KB |
| summary.py | script | 715 B |
| tools.py | script | 5.3 KB |
dex.py
View on GitHub
import sys
import os
import json
import argparse
# DexManager logic is now in tools.py to support better dynamic loading
# Add current directory to sys.path to ensure we can import tools.py
current_dir = os.path.dirname(os.path.abspath(__file__))
if current_dir not in sys.path:
sys.path.append(current_dir)
try:
from tools import DexManager
except ImportError:
print("Error: Could not import DexManager from tools.py")
sys.exit(1)
def main():
parser = argparse.ArgumentParser(description="Dex: Task tracking for async work")
subparsers = parser.add_subparsers(dest="command", help="Available commands")
# Command: create
create_parser = subparsers.add_parser("create", help="Create a new task")
create_parser.add_argument("-d", "--description", required=True, help="One-line summary")
create_parser.add_argument("--context", default="", help="Background, goal, done-when")
# Command: list
list_parser = subparsers.add_parser("list", help="List tasks")
list_parser.add_argument("--all", action="store_true", help="Include completed tasks")
# Command: show
show_parser = subparsers.add_parser("show", help="View task details")
show_parser.add_argument("id", help="Task ID")
show_parser.add_argument("--full", action="store_true", help="Show raw JSON")
# Command: start (CLI 专用)
start_parser = subparsers.add_parser("start", help="Start a task in background")
start_parser.add_argument("id", help="Task ID")
start_parser.add_argument("cmd_args", nargs=argparse.REMAINDER, help="The command to execute")
# Command: complete
comp_parser = subparsers.add_parser("complete", help="Complete a task")
comp_parser.add_argument("id", help="Task ID")
comp_parser.add_argument("--result", required=True, help="What was done")
# Command: edit
edit_parser = subparsers.add_parser("edit", help="Update task context")
edit_parser.add_argument("id", help="Task ID")
edit_parser.add_argument("--context", required=True, help="Updated context")
# Command: delete
del_parser = subparsers.add_parser("delete", help="Delete a task")
del_parser.add_argument("id", help="Task ID")
args = parser.parse_args()
# 实例化 Manager (CLI 默认无 user_id,使用全局空间)
dex = DexManager(allow_global=True)
try:
if args.command == "create":
task = dex.create_task(args.description, args.context)
print(f"Task created: {task['id']}")
elif args.command == "list":
tasks = dex.list_tasks(args.all)
if not tasks:
print("(No tasks via Dex)")
else:
print(f"{'ID':<10} {'STATUS':<12} {'DESCRIPTION'}")
print("-" * 60)
for t in tasks:
print(f"{t['id']:<10} {t.get('status', 'pending'):<12} {t['description']}")
elif args.command == "show":
task = dex.load_task(args.id)
if args.full:
print(json.dumps(task, indent=2, ensure_ascii=False))
else:
print(f"ID: {task['id']}")
print(f"Status: {task.get('status', 'unknown')}")
print(f"Created: {task['created_at']}")
print(f"Description: {task['description']}")
print(f"Context: {task['context']}")
if task.get('result'):
print(f"Result: {task['result']}")
elif args.command == "start":
if not args.cmd_args:
print("Error: No command provided to start.")
return
cmd_parts = args.cmd_args
dex.start_background_process(args.id, cmd_parts)
print(f"Task {args.id} started in background.")
elif args.command == "complete":
dex.complete_task(args.id, args.result)
print(f"Task {args.id} marked as completed.")
elif args.command == "edit":
dex.update_context(args.id, args.context)
print(f"Task {args.id} updated.")
elif args.command == "delete":
dex.delete_task(args.id)
print(f"Task {args.id} deleted.")
else:
parser.print_help()
except Exception as e:
print(f"Error: {e}")
sys.exit(1)
if __name__ == "__main__":
main()
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 197k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |