跳到正文
cccskills
免费在 GitHub 公开

task-coordination

Coordinate changes to shared task folders with .processing marker files that indicate ongoing work. Managers and Workers check these markers before editing, synchronize files through MinIO, and remove markers after completing their changes.

中文简介正在准备中。当前显示英语简介。

原文查看原文说明

Coordinate access to shared task directories using .processing marker files. Use before accessing a Worker's workspace to prevent conflicts when both Manager and Worker might modify files simultaneously.

查看安装方法

适用场景

  • Coordinate Manager and Worker edits in a shared workspace
  • Check for ongoing work before delegated Git operations
  • Set an expiration time for a processing marker
  • Avoid removing a marker owned by another operation

包含的文件(4)

  • SKILL.md4.9 KB
  • scripts/check-processing-marker.sh1.9 KB
  • scripts/create-processing-marker.sh1.3 KB
  • scripts/remove-processing-marker.sh817 B

SKILL.md(原文)

安装前可以查看交给 AI 代理的指令内容。

Task Coordination

This skill provides a general coordination mechanism for shared task directories. It prevents conflicts when both Manager and Workers need to access/modify the same task workspace.

Problem

When a Worker delegates work to Manager (e.g., git operations), the Manager modifies the Worker's workspace. During this time, the Worker might also be modifying files, causing potential conflicts.

Solution

Use .processing marker files to signal "work in progress". Any party (Worker or Manager) must check for this marker before modifying a task directory.


Task Directory Structure

tasks/{task-id}/
├── workspace/          # Code workspace (shared between Worker and Manager)
├── notes/              # Worker's notes, plan.md, memory (not synced by Manager)
├── meta.json           # Task metadata
└── .processing         # Processing marker file (created when work in progress)

The .processing Marker

Format

Location: tasks/{task-id}/.processing

{
  "processor": "manager",
  "started_at": "2026-02-25T10:30:00Z",
  "expires_at": "2026-02-25T10:45:00Z",
  "operation": "git-delegation"
}

Fields

FieldDescription
processorWho is processing: manager or worker name
started_atISO 8601 timestamp when processing started
expires_atISO 8601 timestamp when marker expires (15 min default)
operationWhat operation is in progress (optional)
run_idOptional unique identifier for your current operation; coding CLI execution requires it to match before passing through an active marker

Expiration

The marker auto-expires after 15 minutes (configurable). This prevents deadlocks if a process crashes without removing the marker.


Coordination Protocol

Before Modifying Task Directory

Always follow this sequence:

  1. Sync from MinIO first:

    mc mirror "${AGENTTEAMS_STORAGE_PREFIX}/shared/tasks/${task_id}/" "/root/agentteams-fs/shared/tasks/${task_id}/"
    
  2. Check for .processing:

    bash /opt/agentteams/agent/skills/task-coordination/scripts/check-processing-marker.sh "$task_id"
    
    • Exit code 0: Safe to proceed (no marker or expired)
    • Exit code 1: Processing in progress, do NOT modify
  3. If safe, create marker:

    bash /opt/agentteams/agent/skills/task-coordination/scripts/create-processing-marker.sh "$task_id" "manager"
    
  4. Perform modifications

  5. Remove marker:

    bash /opt/agentteams/agent/skills/task-coordination/scripts/remove-processing-marker.sh "$task_id"
    
  6. Sync to MinIO:

    mc mirror "/root/agentteams-fs/shared/tasks/${task_id}/" "${AGENTTEAMS_STORAGE_PREFIX}/shared/tasks/${task_id}/" --overwrite
    

Scripts

check-processing-marker.sh

Check if a task directory is being processed.

bash /opt/agentteams/agent/skills/task-coordination/scripts/check-processing-marker.sh <task-id>

Exit codes:

  • 0: No marker or marker expired (safe to proceed)
  • 1: Valid marker exists (do not modify)

create-processing-marker.sh

Create a processing marker for a task.

bash /opt/agentteams/agent/skills/task-coordination/scripts/create-processing-marker.sh <task-id> <processor-name> [timeout-mins] [run-id]

Parameters:

  • task-id: Task identifier (e.g., task-20260225-103000)
  • processor-name: Who is processing (manager or worker name)
  • timeout-mins: (Optional) Expiration timeout in minutes (default: 15)
  • run-id: (Optional) Fresh identifier for your operation. Generate it once and pass it unchanged to your coding CLI wrapper and marker removal call. Existing calls without it retain the legacy marker format.

remove-processing-marker.sh

Remove the processing marker after work is done.

bash /opt/agentteams/agent/skills/task-coordination/scripts/remove-processing-marker.sh <task-id> [run-id]

When you supply run-id, removal refuses to delete a marker belonging to a different run. Existing calls without it retain their original behavior.


Integration Points

This coordination mechanism is used by:

  1. git-delegation-management: Manager creates marker before git ops, removes after
  2. git-delegation (Worker skill): Worker checks marker before modifying workspace

Best Practices

  1. Always sync first: Never assume local state is current
  2. Check before create: Don't blindly create markers; check first
  3. Remove promptly: Remove marker as soon as work completes
  4. Handle crashes: The expiration mechanism handles unexpected failures
  5. Respect the marker: Never modify a task directory with an active marker

评价

还没有评价。欢迎分享你的使用感受。

评论

无需登录即可发表。欢迎分享使用感受、提问,或说明在哪些环境下无法运行。

还没有评论。来写第一条吧。

提交后会立即公开。请勿填写邮箱、电话等个人信息。URL 最多 2 个。

0 / 1000 字

此表单受 reCAPTCHA 保护,适用 Google 的隐私权政策和服务条款。

同一仓库的技能

Find worker agents in Nacos that match a task, recommend candidates, and import the administrator's chosen worker. It also supports importing a specified nacos package URI, with worker name confirmation and direct reporting of installation failures.

中文简介正在准备中。当前显示英语简介。

  • Find a suitable worker for an unassigned task
  • Compare Nacos worker candidates before importing
  • Import a worker from a specified nacos package URI
agentscope-ai/AgentTeams58252026年10月17日 更新

Prepare an existing OpenClaw setup for import as an AgentTeams managed Worker. Analyze tool dependencies, adapt role instructions and scheduled jobs, and build a ZIP package containing the configuration and custom image requirements.

中文简介正在准备中。当前显示英语简介。

  • Moving standalone OpenClaw into AgentTeams
  • Reviewing required tool dependencies
  • Adapting role instructions for a Worker
agentscope-ai/AgentTeams58252026年10月17日 更新

Manage communication channels by identifying senders, maintaining trusted contacts, and setting the administrator's primary notification destination. It also covers first contact on a new channel and contacting the administrator across channels, with rules for handling unknown senders.

中文简介正在准备中。当前显示英语简介。

  • Identify who sent a message in a room
  • Add or remove trusted contacts
  • Configure the administrator's primary notification channel
agentscope-ai/AgentTeams58252026年10月17日 更新

Prepare coding tasks for delegation to an authorized agent’s AI command-line tool. Set up and synchronize the workspace, write precise change requests, then review returned changes and run relevant checks before reporting completion.

中文简介正在准备中。当前显示英语简介。

  • Delegating code implementation or bug fixes to an AI CLI
  • Writing coding requests with clear acceptance criteria
  • Reviewing and testing changes returned by a CLI
agentscope-ai/AgentTeams58252026年10月17日 更新

Run AI coding command-line tools on behalf of worker agents using their prepared prompts and workspaces. Detect available tools, configure delegation, return results, and apply supported execution controls such as time budgets and permission settings.

中文简介正在准备中。当前显示英语简介。

  • Running coding tools for worker agents
  • Detecting and selecting available coding CLIs
  • Setting Qwen Code permissions and time budgets
agentscope-ai/AgentTeams58252026年10月17日 更新

Guide agent replies in Matrix chat rooms, including when to mention a coordinator, report completion, raise blockers, or answer questions. The rules limit repetitive acknowledgments and stop exchanges that add no new task, question, or decision.

中文简介正在准备中。当前显示英语简介。

  • Reporting task completion to a coordinator
  • Raising blockers or questions that need action
  • Reducing repetitive acknowledgments
agentscope-ai/AgentTeams58252026年10月17日 更新

查看 agentscope-ai 的全部技能

报告此技能的问题