| name | agent-team |
| description | Compatibility shell for the legacy umbrella agent-team skill. Use only when older prompts still reference `agent-team`; route the request to the dedicated scenario skill instead of treating this file as the primary execution surface.
|
agent-team
This skill is now a navigation shell. Route all requests to the dedicated first-level skills below.
Do not keep adding new behavior here.
Skill Reference
Controller / human orchestration
task-orchestrator
Write-capable task lifecycle entry.
- Audience: controller, human
- Triggers: create task, assign task, complete task, archive task, task flow
- CLI:
agent-team task create · task list · task show · task assign · task done · task archive
- Note: Prefer
task-inspector for read-only queries with no mutation intent.
task-inspector
Read-only task status and lookup.
- Audience: controller, worker, human
- Triggers: inspect task, task status, list tasks, show task
- CLI:
agent-team task list · task show
- Note: Route to
task-orchestrator if the request includes create, assign, done, or archive intent.
task-splitting
Decompose requirement or design documents into task drafts, then create agent-team task packages after explicit approval.
- Audience: controller, human
- Triggers: turn document into tasks, split tasks, validate task boundaries, prepare task files for
agent-team task create
- Workflow: intake source → extract goals → draft by function boundary → validate → write one file per task → confirm → create
- Note: Invokes
brainstorming automatically when the document goal is ambiguous or scope conflicts exist.
workflow-orchestrator
Governance-only workflow plan entry.
- Audience: controller, human
- Triggers: workflow plan, approve plan, activate plan, close plan
- CLI:
agent-team workflow plan generate · approve · activate · close
- Note: Not for worker assignment, worker recovery, or worker status inspection.
worker-dispatch
Controller-side surface for opening workers, replying to workers, and checking targeted worker status.
- Audience: controller, human
- Triggers: open worker, dispatch worker, reply to worker, inspect current worker before replying
- CLI:
agent-team worker open · worker status · agent-team reply
- Note: Use
worker-inspector for read-only fleet inspection with no dispatch or reply intent.
worker-inspector
Read-only worker status inspection.
- Audience: controller, human
- Triggers: worker status, inspect worker, list workers
- CLI:
agent-team worker status
- Note: Route to
worker-dispatch if the prompt implies open, dispatch, or reply behavior.
project-bootstrap
Project initialization and migration entry.
- Audience: human, controller
- Triggers: init project, migrate project, set up agent-team in a new repo
- CLI:
agent-team init · agent-team migrate
rules-maintenance
Sync and refresh built-in rule templates and generated rule artifacts.
- Audience: human, controller
- Triggers: sync rules, fix rule drift, update rules
- CLI:
agent-team rules sync
skill-maintenance
Skill cache maintenance: check, update, clean installed skill artifacts.
- Audience: human, controller
- Triggers: check skills, update skills, clean skills, refresh skill cache
- CLI:
agent-team skill check · skill update · skill clean
role-browser
Read-only local role listing.
- Audience: controller, worker, human
- Triggers: role list, browse roles, view local roles
- CLI:
agent-team role list
- Note: Does not handle
role create or role-repo management.
role-creator
Create or update role skill packages with deterministic output files.
- Audience: human, controller
- Triggers: create role, new role, edit role, update role, add role skill, 修改角色配置
- Output:
SKILL.md + references/role.yaml + system.md under skills/<role>/ or .agent-team/teams/<role>/
- CLI:
agent-team role create
- Workflow: normalize name → auto-generate role fields → select skills → execute CLI → validate output
role-repo-manager
Manage where roles come from (add, list, check, update, remove role repositories).
- Audience: human, controller
- Triggers: search role repo, add role repo, update role repo, remove role repo
- CLI:
agent-team role-repo find · add · list · check · update · remove
- Note: Not for browsing local roles; that belongs to
role-browser or catalog-browser.
catalog-browser
Read-only catalog browsing: search roles from configured remote catalogs.
- Audience: human, controller
- Triggers: search catalog, browse roles, show catalog role, catalog stats
- CLI:
agent-team catalog search · show · list · repo · stats
- Note: Does not expose
normalize, discover, or serve commands.
Worker-first skills
worker-recovery
Resume a worker's current assignment from file artifacts.
- Audience: worker
- Triggers: resume work, recover task, continue current assignment
- Required entry: MUST read
worker.yaml first
- Recovery order:
worker.yaml → task.yaml → context.md → referenced materials only if needed
- Note: Not for worker → main reporting; use
worker-reply-main for that.
worker-reply-main
Send completion, blocker, or decision-needed messages back to controller.
- Audience: worker
- Triggers: reply main, report completion, blocked, request decision
- CLI:
agent-team reply-main
- Required entry: MUST read
worker.yaml first
- Note: Not for controller → worker replies; use
worker-dispatch for that.
Shared / strategy skills
context-cleanup
Clean session context and re-anchor from file artifacts when the session is drifting.
- Audience: controller, worker
- Triggers: clean context, session drift, re-anchor context, resume after pause, phase transition
- Required entry: controller →
.agent-team/rules/index.md; worker → worker.yaml
- Note: Use
worker-recovery for routine worker task resume when the problem is simply recovering the current assignment.
brainstorming
Turn ideas into validated design documents through collaborative dialogue before any implementation.
- Audience: any
- Triggers: explicitly ask to brainstorm, shape requirements, compare approaches, produce a planning/design document
- Hard gate: do NOT write code or invoke any implementation skill until the design is presented and approved
- Note: Not for straightforward implementation requests with clearly specified changes.
tdd
Acceptance-first TDD workflow for solo implementation work.
- Audience: worker, controller
- Triggers: implement with TDD, define acceptance criteria, write failing tests first, verify fix before concluding
- Steps: read context → define acceptance criteria → write failing tests (when feasible) → implement → verify → conclude with
passed / failed / skipped
- Note: Invoke
qa-expert if the task needs dedicated test-case design or regression execution.
systematic-debugging
Root-cause-first debugging for any bug, test failure, or unexpected behavior.
- Audience: any
- Triggers: any bug, test failure, unexpected behavior, performance problem, build failure, integration issue
- Iron law: NO FIXES WITHOUT ROOT CAUSE INVESTIGATION FIRST
- Four phases: Root Cause Investigation → Fix Design → Implementation → Verification
- Note: Use especially when under time pressure or when previous fixes did not work.
find-skills
Discover and install agent skills from the open agent skills ecosystem.
- Audience: any
- Triggers: "how do I do X", "find a skill for X", "is there a skill that can...", extending agent capabilities
- CLI:
agent-team skill install
- Note: Use when the user is looking for functionality that might exist as an installable skill.
qa-expert
Establish comprehensive QA testing processes using Google Testing Standards and OWASP best practices.
- Audience: any
- Triggers: set up QA, write test cases, execute test plan, track bugs, generate QA report, OWASP security testing, third-party QA handoff
- Capabilities: test case writing (AAA pattern), bug tracking (P0–P4), quality metrics, autonomous LLM-driven execution, 90% coverage targets
- Note: Invoke from
tdd when the task needs dedicated test-case design or regression execution beyond unit verification.
prompt-engineering-patterns
Master advanced prompt engineering techniques for production LLM applications.
- Audience: any
- Triggers: optimize prompts, improve LLM outputs, design production prompt templates, chain-of-thought, few-shot learning, structured outputs
- Capabilities: chain-of-thought / tree-of-thought patterns, dynamic few-shot selection, variable interpolation templates, JSON structured outputs, system prompt design
Routing rules
- If the request implies a specific lifecycle action, route to the dedicated skill immediately.
- If the request is about context stabilization or resumed work, route to
context-cleanup or worker-recovery.
- Keep this file as a compatibility surface for historical prompts only.
