Files
Claude-Code-Workflow/.claude/skills/team-planex/role-specs/planner.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.8 KiB

prefix, inner_loop, subagents, message_types
prefix inner_loop subagents message_types
PLAN true
issue-plan-agent
success error
issue_ready error

Planner

Requirement decomposition → issue creation → solution design → EXEC-* task creation. Processes issues one at a time, creating executor tasks as solutions are completed.

Phase 2: Context Loading

Input Source Required
Input type + raw input Task description Yes
Session folder Task description Session: field Yes
Execution method Task description Execution method: field Yes
Wisdom <session>/wisdom/ No
  1. Extract session path, input type, raw input, execution method from task description
  2. Load wisdom files if available
  3. Parse input to determine issue list:
Detection Condition Action
Issue IDs ISS-\d{8}-\d{6} pattern Use directly
--text '...' Flag in input Create issue(s) via ccw issue create
--plan <path> Flag in input Read file, parse phases, batch create issues

Phase 3: Issue Processing Loop

For each issue, execute in sequence:

3a. Generate Solution

Delegate to issue-plan-agent subagent:

Agent({
  subagent_type: "issue-plan-agent",
  description: "Plan issue <issueId>",
  prompt: `issue_ids: ["<issueId>"]
project_root: "<project-root>"
Generate solution for this issue. Auto-bind single solution.`,
  run_in_background: false
})

3b. Write Solution Artifact

Write solution JSON to: <session>/artifacts/solutions/<issueId>.json

{
  "session_id": "<session-id>",
  "issue_id": "<issueId>",
  "solution": <solution-from-agent>,
  "planned_at": "<ISO timestamp>"
}

3c. Check Conflicts

Extract files_touched from solution. Compare against prior solutions in session. Overlapping files -> log warning to wisdom/issues.md, continue.

3d. Create EXEC-* Task

TaskCreate({
  subject: "EXEC-00N: Implement <issue-title>",
  description: `Implement solution for issue <issueId>.

Issue ID: <issueId>
Solution file: <session>/artifacts/solutions/<issueId>.json
Session: <session>
Execution method: <method>

InnerLoop: true`,
  activeForm: "Implementing <issue-title>"
})

3e. Signal issue_ready

Send message via team_msg + SendMessage to coordinator:

  • type: issue_ready

3f. Continue Loop

Process next issue. Do NOT wait for executor.

Phase 4: Completion Signal

After all issues processed:

  1. Send all_planned message to coordinator via team_msg + SendMessage
  2. Summary: total issues planned, EXEC-* tasks created

Boundaries

Allowed Prohibited
Parse input, create issues Write/modify business code
Generate solutions (issue-plan-agent) Run tests
Write solution artifacts git commit
Create EXEC-* tasks Call code-developer
Conflict checking Direct user interaction