Acp Team 是 acpx 的团队协调层，提供邮件盒、共享任务板和多智能体工作流。
使用场景
使用该技能当用户：
- 需要协调多个 AI 智能体工作
- 需要共享任务板以租约机制
- 希望智能体之间通过邮件盒通信
- 请求启动具有不同角色和提示的团队成员
- 需要跨智能体跟踪任务分配和状态
... （以下内容与原文相同，仅示例，实际翻译应包括全部 SKILL.md 内容）
Team coordination layer for acpx - mailbox, task board, and multi-agent workflows.
When to Use This Skill
Use this skill when the user:
- Wants to coordinate multiple AI agents working together
- Needs a shared task board with claim/lease mechanics
- Wants agents to communicate via message inboxes
- Asks about spawning team members with different roles
- Needs task assignment and status tracking across agents
Architecture
┌─────────────────────────────────────────────────────────┐
│ acp-team │
│ ┌─────────────┐ ┌─────────────┐ ┌─────────────┐ │
│ │ TaskStore │ │ MessageBus │ │ TeamStore │ │
│ │ .tasks/ │ │ .team/inbox │ │ .team/config│ │
│ └─────────────┘ └─────────────┘ └─────────────┘ │
│ │ │ │ │
│ └────────────────┼────────────────┘ │
│ │ │
│ Coordinator │
│ │ │
│ ▼ │
│ acpx sessions │
└─────────────────────────────────────────────────────────┘
Installation
npm install -g acp-team
Requires acpx to be installed:
npm install -g acpx
Quick Start
# Initialize team in your project
acp-team init --name my-project# Create tasks
acp-team task create "Fix authentication bug"
acp-team task create "Write unit tests"
# Spawn a team member
acp-team spawn alice -r coder -p "Fix the auth bug in task #1"
# Check status
acp-team status
# Send messages
acp-team msg send alice "How's the bug fix going?"
acp-team msg inbox alice
Commands Reference
Team Management
| Command | Description |
|---|
acp-team init [--name ] | Initialize team in project |
acp-team status | Show team and task status |
acp-team spawn -r -p | Spawn a team member with acpx |
acp-team shutdown | Request member shutdown |
Task Board
| Command | Description |
|---|
acp-team task create | Create a new task |
acp-team task list | List all tasks |
acp-team task unclaimed | List unclaimed tasks |
acp-team task claim [-o ] | Claim a task |
acp-team task assign | Assign task to member |
acp-team task done | Mark task as done |
Task Lease System
| Command | Description |
|---|
acp-team task claim-lease -o -d | Claim with lease (default 60s) |
acp-team task heartbeat -t | Renew lease |
acp-team task release-expired | Release all expired leases |
Messaging
| Command | Description |
|---|
acp-team msg send | Send direct message |
acp-team msg broadcast | Broadcast to all members |
acp-team msg inbox [name] | Read inbox (drains messages) |
acp-team msg peek [name] | Peek inbox (without draining) |
Task State Machine
pending → claimed → running → blocked → completed
↓ ↓
cancelled failed
↓ ↓
timed_out
Message Envelope Format
{
"schema_version": "1.0",
"message_id": "uuid",
"trace_id": "...",
"sender": "alice",
"recipient": "bob",
"type": "message",
"content": "...",
"created_at": 1234567890,
"priority": 1
}
File Structure
.team/
├── config.json # Team configuration
└── inbox/
├── alice.jsonl # Alice's inbox
├── bob.jsonl # Bob's inbox
└── lead.jsonl # Lead's inbox.tasks/
├── task_1.json # Task #1
├── task_2.json # Task #2
└── ...
Workflow Example
# 1. Initialize
acp-team init --name feature-dev# 2. Create tasks
acp-team task create "Design API schema"
acp-team task create "Implement backend"
acp-team task create "Write tests"
# 3. Spawn designer
acp-team spawn designer -r architect -p "Design the API schema for task #1" -a claude
# 4. After design is done, spawn implementer
acp-team spawn coder -r backend -p "Implement the API based on the design"
# 5. Monitor progress
acp-team status
acp-team msg inbox lead
# 6. Spawn tester
acp-team spawn tester -r qa -p "Write tests for the new API"
Resources
- npm: https://www.npmjs.com/package/acp-team
by