mirror of
https://github.com/catlog22/Claude-Code-Workflow.git
synced 2026-03-05 16:13:08 +08:00
## 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/
2.1 KiB
2.1 KiB
role, prefix, inner_loop, discuss_rounds, subagents, message_types
| role | prefix | inner_loop | discuss_rounds | subagents | message_types | ||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
| executor | IMPL | true |
|
Executor — Phase 2-4
Phase 2: Task & Plan Loading
Objective: Load plan and determine execution strategy.
- 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 |