mirror of https://github.com/catlog22/Claude-Code-Workflow.git synced 2026-03-06 16:31:12 +08:00

Files

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

4.3 KiB

Raw Blame History

role, prefix, inner_loop, discuss_rounds, subagents, message_types

role

prefix

inner_loop

discuss_rounds

subagents

message_types

writer

DRAFT

true

DISCUSS-002

DISCUSS-003

DISCUSS-004

DISCUSS-005

discuss

doc-generation

success	revision	error
draft_ready	draft_revision	error

Writer — Phase 2-4

Phase 2: Context Loading

Objective: Load all required inputs for document generation.

Document type routing

Task Subject Contains	Doc Type	Template	Prior Discussion Input
Product Brief	product-brief	templates/product-brief.md	discussions/DISCUSS-001-discussion.md
Requirements / PRD	requirements	templates/requirements-prd.md	discussions/DISCUSS-002-discussion.md
Architecture	architecture	templates/architecture-doc.md	discussions/DISCUSS-003-discussion.md
Epics	epics	templates/epics-template.md	discussions/DISCUSS-004-discussion.md

Inline discuss mapping

Doc Type	Inline Discuss Round	Perspectives
product-brief	DISCUSS-002	product, technical, quality, coverage
requirements	DISCUSS-003	quality, product, coverage
architecture	DISCUSS-004	technical, risk
epics	DISCUSS-005	product, technical, quality, coverage

Progressive dependency loading

Doc Type	Requires
product-brief	discovery-context.json
requirements	+ product-brief.md
architecture	+ requirements/_index.md
epics	+ architecture/_index.md

Prior decisions from accumulator: Pass context_accumulator summaries as "Prior Decisions" to subagent.

Input	Source	Required
Document standards	`../../specs/document-standards.md` (relative to SKILL)	Yes
Template	From routing table	Yes
Spec config	`<session-folder>/spec/spec-config.json`	Yes
Discovery context	`<session-folder>/spec/discovery-context.json`	Yes
Discussion feedback	`<session-folder>/discussions/<discuss-file>`	If exists
Prior decisions	context_accumulator (in-memory)	If prior tasks exist

Phase 3: Subagent Document Generation

Objective: Delegate document generation to doc-generation subagent.

Do NOT execute CLI calls in main agent. Delegate to subagent:

Agent({
  subagent_type: "universal-executor",
  run_in_background: false,
  description: "Generate <doc-type> document",
  prompt: `<from subagents/doc-generation-subagent.md>

## Task
- Document type: <doc-type>
- Session folder: <session-folder>
- Template: <template-path>

## Context
- Spec config: <spec-config content>
- Discovery context: <discovery-context summary>
- Prior discussion feedback: <discussion-file content if exists>
- Prior decisions (from writer accumulator):
  <context_accumulator serialized>

## Expected Output
Return JSON:
{
  "artifact_path": "<output-path>",
  "summary": "<100-200 char summary>",
  "key_decisions": ["<decision-1>", ...],
  "sections_generated": ["<section-1>", ...],
  "warnings": ["<warning if any>"]
}`
})

Main agent receives only the JSON summary. Document is written to disk by subagent.

Phase 4: Self-Validation + Inline Discuss

4a: Self-Validation

Check	What to Verify
has_frontmatter	Starts with YAML frontmatter
sections_complete	All template sections present
cross_references	session_id included
discussion_integrated	Reflects prior round feedback (if exists)

4b: Inline Discuss

Call discuss subagent for this task's discuss round:

Artifact: <output-path> (the generated document)
Round: <DISCUSS-NNN> from mapping table
Perspectives: from mapping table

Handle discuss verdict per team-worker consensus handling protocol.

Report: doc type, validation status, discuss verdict + severity, average rating, summary, output path.

Error Handling

Scenario	Resolution
Subagent failure	Retry once with alternative subagent_type. Still fails → log error, continue next task
Discuss subagent fails	Skip discuss, log warning
Cumulative 3 task failures	SendMessage to coordinator, STOP
Prior doc not found	Notify coordinator, request prerequisite
Discussion contradicts prior docs	Note conflict, flag for coordinator

4.3 KiB Raw Blame History