mirror of
https://github.com/catlog22/Claude-Code-Workflow.git
synced 2026-03-26 19:56:37 +08:00
feat: migrate all codex team skills from spawn_agents_on_csv to spawn_agent + wait_agent architecture
- Delete 21 old team skill directories using CSV-wave pipeline pattern (~100+ files) - Delete old team-lifecycle (v3) and team-planex-v2 - Create generic team-worker.toml and team-supervisor.toml (replacing tlv4-specific TOMLs) - Convert 19 team skills from Claude Code format (Agent/SendMessage/TaskCreate) to Codex format (spawn_agent/wait_agent/tasks.json/request_user_input) - Update team-lifecycle-v4 to use generic agent types (team_worker/team_supervisor) - Convert all coordinator role files: dispatch.md, monitor.md, role.md - Convert all worker role files: remove run_in_background, fix Bash syntax - Convert all specs/pipelines.md references - Final state: 20 team skills, 217 .md files, zero Claude Code API residuals Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
This commit is contained in:
catlog22
54
.codex/skills/team-ux-improve/specs/pipelines.md
Normal file
54
.codex/skills/team-ux-improve/specs/pipelines.md
Normal file
@@ -0,0 +1,54 @@
|
||||
# Pipeline Definitions
|
||||
|
||||
UX improvement pipeline modes and task registry.
|
||||
|
||||
## Pipeline Modes
|
||||
|
||||
| Mode | Description | Task Chain |
|
||||
|------|-------------|------------|
|
||||
| standard | Full UX improvement pipeline | SCAN-001 -> DIAG-001 -> DESIGN-001 -> IMPL-001 -> TEST-001 |
|
||||
|
||||
## Standard Pipeline Task Registry
|
||||
|
||||
| Task ID | Role | blockedBy | Inner Loop | Description |
|
||||
|---------|------|-----------|------------|-------------|
|
||||
| SCAN-001 | scanner | [] | false | Scan UI components for interaction issues (unresponsive buttons, missing feedback, state problems) |
|
||||
| DIAG-001 | diagnoser | [SCAN-001] | false | Root cause diagnosis with fix recommendations |
|
||||
| DESIGN-001 | designer | [DIAG-001] | false | Feedback mechanism and state management solution design |
|
||||
| IMPL-001 | implementer | [DESIGN-001] | true | Code implementation with proper state handling |
|
||||
| TEST-001 | tester | [IMPL-001] | false | Test generation and validation (pass rate >= 95%, max 5 iterations) |
|
||||
|
||||
## Checkpoints
|
||||
|
||||
| Checkpoint | Trigger | Condition | Action |
|
||||
|------------|---------|-----------|--------|
|
||||
| Pipeline complete | TEST-001 completes | All tasks done | Coordinator Phase 5: wisdom consolidation + completion action |
|
||||
|
||||
## Test Iteration Behavior
|
||||
|
||||
| Condition | Action |
|
||||
|-----------|--------|
|
||||
| pass_rate >= 95% | Pipeline complete |
|
||||
| pass_rate < 95% AND iterations < 5 | Tester generates fixes, re-runs (inner loop within TEST-001) |
|
||||
| pass_rate < 95% AND iterations >= 5 | Accept current state, report to coordinator |
|
||||
|
||||
## Output Artifacts
|
||||
|
||||
| Task | Output Path |
|
||||
|------|-------------|
|
||||
| SCAN-001 | <session>/artifacts/scan-report.md |
|
||||
| DIAG-001 | <session>/artifacts/diagnosis.md |
|
||||
| DESIGN-001 | <session>/artifacts/design-guide.md |
|
||||
| IMPL-001 | <session>/artifacts/fixes/ |
|
||||
| TEST-001 | <session>/artifacts/test-report.md |
|
||||
|
||||
## Wisdom System
|
||||
|
||||
Workers contribute learnings to `<session>/wisdom/contributions/`. On pipeline completion, coordinator asks user to merge approved contributions to permanent wisdom at `~ or <project>/.claude/skills/team-ux-improve/wisdom/`.
|
||||
|
||||
| Directory | Purpose |
|
||||
|-----------|---------|
|
||||
| wisdom/principles/ | Core UX principles |
|
||||
| wisdom/patterns/ | Solution patterns (ui-feedback, state-management) |
|
||||
| wisdom/anti-patterns/ | Issues to avoid (common-ux-pitfalls) |
|
||||
| wisdom/contributions/ | Session worker contributions (pending review) |
|
||||
181
.codex/skills/team-ux-improve/specs/team-config.json
Normal file
181
.codex/skills/team-ux-improve/specs/team-config.json
Normal file
@@ -0,0 +1,181 @@
|
||||
{
|
||||
"version": "5.0.0",
|
||||
"team_name": "ux-improve",
|
||||
"team_display_name": "UX Improve",
|
||||
"team_purpose": "Systematically discover and fix UI/UX interaction issues including unresponsive buttons, missing feedback, and state refresh problems",
|
||||
"skill_name": "team-ux-improve",
|
||||
"skill_path": "~ or <project>/.claude/skills/team-ux-improve/",
|
||||
"worker_agent": "team-worker",
|
||||
"pipeline_type": "Standard",
|
||||
"completion_action": "interactive",
|
||||
"has_inline_discuss": false,
|
||||
"has_shared_explore": true,
|
||||
"roles": [
|
||||
{
|
||||
"name": "coordinator",
|
||||
"display_name": "Coordinator",
|
||||
"type": "orchestrator",
|
||||
"responsibility_type": "orchestration",
|
||||
"role_spec": "roles/coordinator/role.md",
|
||||
"task_prefix": null,
|
||||
"inner_loop": false,
|
||||
"allowed_tools": ["Agent", "AskUserQuestion", "Read", "Write", "Bash", "Glob", "Grep", "TaskList", "TaskGet", "TaskUpdate", "TaskCreate", "TeamCreate", "TeamDelete", "SendMessage", "mcp__ccw-tools__team_msg"],
|
||||
"description": "Orchestrates the UX improvement pipeline, spawns workers, monitors progress"
|
||||
},
|
||||
{
|
||||
"name": "scanner",
|
||||
"display_name": "UI Scanner",
|
||||
"type": "worker",
|
||||
"responsibility_type": "read_only_analysis",
|
||||
"role_spec": "roles/scanner/role.md",
|
||||
"task_prefix": "SCAN",
|
||||
"inner_loop": false,
|
||||
"allowed_tools": ["Read", "Grep", "Glob", "Bash", "mcp__ace-tool__search_context", "mcp__ccw-tools__read_file", "mcp__ccw-tools__team_msg", "TaskList", "TaskGet", "TaskUpdate", "SendMessage"],
|
||||
"description": "Scans UI components to identify interaction issues (unresponsive buttons, missing feedback, state not refreshing)",
|
||||
"frontmatter": {
|
||||
"prefix": "SCAN",
|
||||
"inner_loop": false,
|
||||
"message_types": {
|
||||
"success": "scan_complete",
|
||||
"error": "error"
|
||||
}
|
||||
}
|
||||
},
|
||||
{
|
||||
"name": "diagnoser",
|
||||
"display_name": "State Diagnoser",
|
||||
"type": "worker",
|
||||
"responsibility_type": "orchestration",
|
||||
"role_spec": "roles/diagnoser/role.md",
|
||||
"task_prefix": "DIAG",
|
||||
"inner_loop": false,
|
||||
"allowed_tools": ["Read", "Grep", "Bash", "mcp__ace-tool__search_context", "mcp__ccw-tools__read_file", "mcp__ccw-tools__team_msg", "TaskList", "TaskGet", "TaskUpdate", "SendMessage"],
|
||||
"description": "Diagnoses root causes of UI issues: state management problems, event binding failures, async handling errors",
|
||||
"frontmatter": {
|
||||
"prefix": "DIAG",
|
||||
"inner_loop": false,
|
||||
"message_types": {
|
||||
"success": "diag_complete",
|
||||
"error": "error"
|
||||
}
|
||||
}
|
||||
},
|
||||
{
|
||||
"name": "designer",
|
||||
"display_name": "UX Designer",
|
||||
"type": "worker",
|
||||
"responsibility_type": "orchestration",
|
||||
"role_spec": "roles/designer/role.md",
|
||||
"task_prefix": "DESIGN",
|
||||
"inner_loop": false,
|
||||
"allowed_tools": ["Read", "Write", "Bash", "mcp__ccw-tools__read_file", "mcp__ccw-tools__write_file", "mcp__ccw-tools__team_msg", "TaskList", "TaskGet", "TaskUpdate", "SendMessage"],
|
||||
"description": "Designs feedback mechanisms (loading/error/success states) and state management patterns (React/Vue reactive updates)",
|
||||
"frontmatter": {
|
||||
"prefix": "DESIGN",
|
||||
"inner_loop": false,
|
||||
"message_types": {
|
||||
"success": "design_complete",
|
||||
"error": "error"
|
||||
}
|
||||
}
|
||||
},
|
||||
{
|
||||
"name": "implementer",
|
||||
"display_name": "Code Implementer",
|
||||
"type": "worker",
|
||||
"responsibility_type": "code_generation",
|
||||
"role_spec": "roles/implementer/role.md",
|
||||
"task_prefix": "IMPL",
|
||||
"inner_loop": true,
|
||||
"allowed_tools": ["Read", "Write", "Edit", "Bash", "mcp__ccw-tools__read_file", "mcp__ccw-tools__write_file", "mcp__ccw-tools__edit_file", "mcp__ccw-tools__team_msg", "TaskList", "TaskGet", "TaskUpdate", "SendMessage"],
|
||||
"description": "Generates executable fix code with proper state management, event handling, and UI feedback bindings",
|
||||
"frontmatter": {
|
||||
"prefix": "IMPL",
|
||||
"inner_loop": true,
|
||||
"message_types": {
|
||||
"success": "impl_complete",
|
||||
"error": "error"
|
||||
}
|
||||
}
|
||||
},
|
||||
{
|
||||
"name": "tester",
|
||||
"display_name": "Test Engineer",
|
||||
"type": "worker",
|
||||
"responsibility_type": "validation",
|
||||
"role_spec": "roles/tester/role.md",
|
||||
"task_prefix": "TEST",
|
||||
"inner_loop": false,
|
||||
"allowed_tools": ["Read", "Write", "Bash", "mcp__ccw-tools__read_file", "mcp__ccw-tools__write_file", "mcp__ccw-tools__team_msg", "TaskList", "TaskGet", "TaskUpdate", "SendMessage"],
|
||||
"description": "Generates test cases to verify fixes (loading states, error handling, state updates)",
|
||||
"frontmatter": {
|
||||
"prefix": "TEST",
|
||||
"inner_loop": false,
|
||||
"message_types": {
|
||||
"success": "test_complete",
|
||||
"error": "error",
|
||||
"fix": "fix_required"
|
||||
}
|
||||
}
|
||||
}
|
||||
],
|
||||
"utility_members": [
|
||||
{
|
||||
"name": "explorer",
|
||||
"display_name": "Codebase Explorer",
|
||||
"role_spec": "roles/explorer/role.md",
|
||||
"callable_by": "coordinator",
|
||||
"purpose": "Explore codebase for UI component patterns, state management conventions, and framework-specific patterns",
|
||||
"allowed_tools": ["Read", "Grep", "Glob", "Bash", "mcp__ace-tool__search_context", "mcp__ccw-tools__read_file", "mcp__ccw-tools__team_msg"],
|
||||
"frontmatter": {
|
||||
"prefix": "EXPLORE",
|
||||
"inner_loop": false,
|
||||
"message_types": {
|
||||
"success": "explore_complete",
|
||||
"error": "error"
|
||||
}
|
||||
}
|
||||
}
|
||||
],
|
||||
"pipeline": {
|
||||
"stages": [
|
||||
{
|
||||
"stage_id": 1,
|
||||
"stage_name": "UI Scanning",
|
||||
"roles": ["scanner"],
|
||||
"dependencies": [],
|
||||
"description": "Scan UI components for interaction issues"
|
||||
},
|
||||
{
|
||||
"stage_id": 2,
|
||||
"stage_name": "Root Cause Diagnosis",
|
||||
"roles": ["diagnoser"],
|
||||
"dependencies": ["scanner"],
|
||||
"description": "Diagnose root causes of identified issues"
|
||||
},
|
||||
{
|
||||
"stage_id": 3,
|
||||
"stage_name": "Solution Design",
|
||||
"roles": ["designer"],
|
||||
"dependencies": ["diagnoser"],
|
||||
"description": "Design feedback mechanisms and state management solutions"
|
||||
},
|
||||
{
|
||||
"stage_id": 4,
|
||||
"stage_name": "Code Implementation",
|
||||
"roles": ["implementer"],
|
||||
"dependencies": ["designer"],
|
||||
"description": "Generate fix code with proper state handling"
|
||||
},
|
||||
{
|
||||
"stage_id": 5,
|
||||
"stage_name": "Test Validation",
|
||||
"roles": ["tester"],
|
||||
"dependencies": ["implementer"],
|
||||
"description": "Generate and run tests to verify fixes"
|
||||
}
|
||||
],
|
||||
"diagram": "scanner (SCAN) → diagnoser (DIAG) → designer (DESIGN) → implementer (IMPL) → tester (TEST)",
|
||||
"fast_advance_eligible": ["scanner→diagnoser", "diagnoser→designer", "designer→implementer"]
|
||||
}
|
||||
}
|
||||
Reference in New Issue
Block a user