valkryhx/google_adk_agent / skills/agent_team_to_be_update
Agent 团队协作(去中心化拉模型)
Flagged赋予 Agent 作为集群指挥官(Leader)的能力,通过去中心化任务队列将子任务派发给 Worker 节点并发执行。
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 17.9 KB |
| decentralized_tools.py | script | 36.2 KB |
| dependency_analyzer.py | script | 10.9 KB |
| inbox_watcher.py | script | 8.5 KB |
| loop_executor.py | script | 16.4 KB |
| mailbox.py | script | 15.3 KB |
| models.py | script | 9.1 KB |
| path_guard.py | script | 13.3 KB |
| planner.py | script | 14.6 KB |
| polling_daemon.py | script | 7.7 KB |
| self_claim_loop.py | script | 20.1 KB |
| task_queue.py | script | 24.1 KB |
| team_config.py | script | 7.5 KB |
| test/__init__.py | script | 40 B |
| test/test_blog_system_develop.py | script | 12.0 KB |
| test/test_dag_create_validation.py | script | 2.7 KB |
| test/test_decentralized_arch.py | script | 36.9 KB |
| test/test_deepresearch.py | script | 14.6 KB |
| test/test_loop_dag.py | script | 17.0 KB |
| test/test_real_training.py | script | 9.2 KB |
| test/test_tdd_gate.py | script | 4.5 KB |
| tools.py | script | 85.8 KB |
| verification_hooks.py | script | 10.7 KB |
| worktree_manager.py | script | 12.8 KB |
models.py
View on GitHub#!/usr/bin/env python3
# -*- coding: utf-8 -*-
"""
Agent Team Task Queue System - Data Models
This module defines the data models for the task queue system,
including the Task dataclass with all required fields for dependency management
and loop/iteration support.
"""
import time
from dataclasses import dataclass, field
from typing import List, Optional, Dict, Any
@dataclass
class Task:
"""任务数据模型
用于表示一个可分配、可执行的任务单元,支持依赖关系声明和循环迭代。
"""
id: str # 任务唯一ID
name: str # 任务名称
description: str # 详细描述
status: str = "pending" # pending / in_progress / completed
owner: Optional[str] = None # 当前认领者 (agent_id)
blocked_by: List[str] = field(default_factory=list) # 依赖的任务ID列表
blocks: List[str] = field(default_factory=list) # 被这个任务阻塞的任务
created_at: float = field(default_factory=time.time)
completed_at: Optional[float] = None
claimed_at: Optional[float] = None # Worker 认领时间,用于超时检测
# 产物信息
expected_artifacts: List[str] = field(default_factory=list) # 期望产出文件
verification_commands: List[str] = field(default_factory=list) # 验收命令
# 文件边界(防止冲突)
writable_files: List[str] = field(default_factory=list) # 可写文件
read_only_files: List[str] = field(default_factory=list) # 只读文件
# 容错熔断 (新增)
retries: int = 0
max_retries: int = 3
error: Optional[str] = None # (新增) 保存最后一次错误原因
# ========== 循环/迭代相关字段 (新增) ==========
task_type: str = "regular" # "regular" | "loop" | "gate"
loop_group_id: Optional[str] = None # 所属循环组 ID
iteration: int = 0 # 当前迭代次数 (0 = 未开始)
iteration_status: str = "pending" # "pending" | "in_progress" | "completed" | "skipped"
max_iterations: int = 5 # 最大迭代次数
exit_condition: Optional[str] = None # 退出条件 (e.g., "accuracy >= 0.95")
loop_exit_result: Optional[Dict[str, Any]] = None # 循环退出时的结果
def to_json(self) -> dict:
"""将任务转换为JSON字典"""
return {
"id": self.id,
"name": self.name,
"description": self.description,
"status": self.status,
"owner": self.owner,
"blockedBy": self.blocked_by,
"blocks": self.blocks,
"createdAt": self.created_at,
"completedAt": self.completed_at,
"claimedAt": self.claimed_at,
"expectedArtifacts": self.expected_artifacts,
"verificationCommands": self.verification_commands,
"writableFiles": self.writable_files,
"readOnlyFiles": self.read_only_files,
"retries": self.retries,
"maxRetries": self.max_retries,
"error": self.error,
# Loop fields
"taskType": self.task_type,
"loopGroupId": self.loop_group_id,
"iteration": self.iteration,
"iterationStatus": self.iteration_status,
"maxIterations": self.max_iterations,
"exitCondition": self.exit_condition,
"loopExitResult": self.loop_exit_result
}
@classmethod
def from_json(cls, data: dict) -> "Task":
"""从JSON字典创建任务实例 (增加蛇形和驼峰双向兼容)"""
return cls(
id=data.get("id", ""),
name=data.get("name", ""),
description=data.get("description", ""),
status=data.get("status", "pending"),
owner=data.get("owner"),
blocked_by=data.get("blockedBy", []) or data.get("blocked_by", []),
blocks=data.get("blocks", []) or data.get("blocks", []),
created_at=data.get("createdAt", time.time()) or data.get("created_at", time.time()),
completed_at=data.get("completedAt") or data.get("completed_at"),
claimed_at=data.get("claimedAt") or data.get("claimed_at"),
expected_artifacts=data.get("expectedArtifacts", []) or data.get("expected_artifacts", []),
verification_commands=data.get("verificationCommands", []) or data.get("verification_commands", []),
writable_files=data.get("writableFiles", []) or data.get("writable_files", []),
read_only_files=data.get("readOnlyFiles", []) or data.get("read_only_files", []),
retries=data.get("retries", 0),
max_retries=data.get("maxRetries", 3) if "maxRetries" in data else data.get("max_retries", 3),
error=data.get("error"),
# Loop fields
task_type=data.get("taskType", "regular") or data.get("task_type", "regular"),
loop_group_id=data.get("loopGroupId") or data.get("loop_group_id"),
iteration=data.get("iteration", 0) if "iteration" in data else data.get("iteration", 0),
iteration_status=data.get("iterationStatus", "pending") or data.get("iteration_status", "pending"),
max_iterations=data.get("maxIterations", 5) if "maxIterations" in data else data.get("max_iterations", 5),
exit_condition=data.get("exitCondition") or data.get("exit_condition"),
loop_exit_result=data.get("loopExitResult") or data.get("loop_exit_result")
)
def is_available(self, completed_ids: set) -> bool:
"""检查任务是否可用(所有依赖都已完成)
Args:
completed_ids: 已完成任务的ID集合
Returns:
True 如果任务可以被认领
"""
if not self.blocked_by:
return True
return all(dep_id in completed_ids for dep_id in self.blocked_by)
def can_be_claimed(self) -> bool:
"""检查任务是否可以被认领
Returns:
True 如果任务状态为 pending
"""
return self.status == "pending"
def mark_in_progress(self, agent_id: str):
"""标记任务为进行中"""
self.status = "in_progress"
self.owner = agent_id
def mark_completed(self):
"""标记任务为已完成"""
self.status = "completed"
self.completed_at = time.time()
@dataclass
class LoopGroup:
"""循环组数据模型
用于表示一组需要迭代执行的任务。
"""
id: str # 唯一标识
name: str # 名称
max_iterations: int = 5 # 最大迭代次数
exit_condition: str = "true" # 退出条件表达式
current_iteration: int = 0 # 当前迭代次数
status: str = "pending" # pending/running/completed/failed
task_ids: List[str] = field(default_factory=list) # 组内任务 ID
gate_task_id: Optional[str] = None # Gate 任务 ID (用于判断退出)
exit_result: Optional[Dict[str, Any]] = None # 退出时的结果
created_at: float = field(default_factory=time.time)
completed_at: Optional[float] = None
def to_json(self) -> dict:
"""转换为 JSON"""
return {
"id": self.id,
"name": self.name,
"maxIterations": self.max_iterations,
"exitCondition": self.exit_condition,
"currentIteration": self.current_iteration,
"status": self.status,
"taskIds": self.task_ids,
"gateTaskId": self.gate_task_id,
"exitResult": self.exit_result,
"createdAt": self.created_at,
"completedAt": self.completed_at
}
@classmethod
def from_json(cls, data: dict) -> "LoopGroup":
"""从 JSON 创建"""
return cls(
id=data["id"],
name=data["name"],
max_iterations=data.get("maxIterations", 5),
exit_condition=data.get("exitCondition", "true"),
current_iteration=data.get("currentIteration", 0),
status=data.get("status", "pending"),
task_ids=data.get("taskIds", []),
gate_task_id=data.get("gateTaskId"),
exit_result=data.get("exitResult"),
created_at=data.get("createdAt", time.time()),
completed_at=data.get("completedAt")
)
def is_completed(self) -> bool:
"""检查循环组是否已完成"""
return self.status in ("completed", "failed")
def is_running(self) -> bool:
"""检查循环组是否正在运行"""
return self.status == "running"
def should_continue(self) -> bool:
"""检查是否应该继续迭代"""
if self.status == "completed":
return False
if self.current_iteration >= self.max_iterations:
return False
return True
@dataclass
class LoopState:
"""循环执行状态
跟踪循环组在一次执行中的状态。
"""
iteration: int # 当前迭代 (1-based)
max_iterations: int # 最大迭代
loop_group_id: str # 循环组 ID
completed_task_ids: List[str] = field(default_factory=list) # 已完成的任务
exit_condition_met: bool = False # 是否满足退出条件
exit_message: str = "" # 退出原因
exit_result: Optional[Dict[str, Any]] = None # 退出结果
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis. | Stars: 470k | Updated | Claude CodeCodex | Verified | Install |
| diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness. | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is available | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |