Files
Claude-Code-Workflow/.claude/skills/team-lifecycle/role-specs/executor.md
catlog22 16bbfcd12a refactor: replace Task tool with Agent tool and fix schema compliance
## Task -> Agent Replacement
- Replace all Task({}) calls with Agent({}) across .claude/ directory
- Update allowed-tools declarations from Task to Agent
- Update documentation references from "Task tool" to "Agent tool"

## Schema Compliance Fixes

### Agent Schema
- Add missing required `description` parameter in 6 files
- Add missing `run_in_background: false` for subagent calls
- Add missing `subagent_type` parameter

### AskUserQuestion Schema
- Fix issue-manage/SKILL.md: reduce options from 5 to 4 (max allowed)

### SendMessage Schema
- Fix team-worker.md: use correct params (type, content, summary)
- Remove invalid `team_name` parameter

### TaskCreate/TaskUpdate Schema
- Remove invalid `blockedBy`, `owner`, `status` from TaskCreate calls
- Use separate TaskUpdate calls for dependencies and ownership
- Fix TaskUpdate syntax to use object parameter

### TeamDelete Schema
- Remove parameters from TeamDelete() calls (should be no params)

### TaskOutput Schema
- Fix Python-style syntax to JavaScript object syntax

## Files Changed
- 146 files updated across commands/, skills/, skills_lib/, agents/
2026-03-04 22:40:39 +08:00

2.1 KiB

role, prefix, inner_loop, discuss_rounds, subagents, message_types
role prefix inner_loop discuss_rounds subagents message_types
executor IMPL true
success progress error
impl_complete impl_progress error

Executor — Phase 2-4

Phase 2: Task & Plan Loading

Objective: Load plan and determine execution strategy.

  1. Load plan.json and .task/TASK-*.json from <session-folder>/plan/

Backend selection (priority order):

Priority Source Method
1 Task metadata task.metadata.executor field
2 Plan default "Execution Backend:" in plan
3 Auto-select Simple (< 200 chars, no refactor) → agent; Complex → codex

Code review selection:

Priority Source Method
1 Task metadata task.metadata.code_review field
2 Plan default "Code Review:" in plan
3 Auto-select Critical keywords (auth, security, payment) → enabled

Phase 3: Code Implementation

Objective: Execute implementation across batches.

Batching: Topological sort by IMPL task dependencies → sequential batches.

Backend Invocation Use Case
agent Agent({ subagent_type: "code-developer", run_in_background: false }) Simple, direct edits
codex ccw cli --tool codex --mode write (background) Complex, architecture
gemini ccw cli --tool gemini --mode write (background) Analysis-heavy

Phase 4: Self-Validation

Step Method Pass Criteria
Syntax check tsc --noEmit (30s) Exit code 0
Acceptance criteria Match criteria keywords vs implementation All addressed
Test detection Find .test.ts/.spec.ts for modified files Tests identified
Code review (optional) gemini analysis or codex review No blocking issues

Report: task ID, status, files modified, validation results, backend used.

Error Handling

Scenario Resolution
Syntax errors Retry with error context (max 3)
Missing dependencies Request from coordinator
Backend unavailable Fallback to agent
Circular dependencies Abort, report graph