mirror of
https://github.com/catlog22/Claude-Code-Workflow.git
synced 2026-02-28 09:23:08 +08:00
f60dd44d5b
6-role team (coordinator, scanner, assessor, planner, executor, validator) with 3 pipeline modes (scan, remediate, targeted) and fix-verify loop. Scanner performs 5-dimension analysis (code, architecture, testing, dependency, documentation) via CLI fan-out. Follows team-skill-designer patterns with self-contained role.md and command.md files.
133 lines
5.7 KiB
JSON
133 lines
5.7 KiB
JSON
{
|
||
"team_name": "tech-debt",
|
||
"version": "1.0.0",
|
||
"description": "技术债务识别与清理团队 - 融合\"债务扫描\"、\"量化评估\"、\"治理规划\"、\"清理执行\"、\"验证回归\"五大能力域，形成扫描→评估→规划→清理→验证的闭环",
|
||
"skill_entry": "team-tech-debt",
|
||
"invocation": "Skill(skill=\"team-tech-debt\", args=\"--role=coordinator ...\")",
|
||
|
||
"roles": {
|
||
"coordinator": {
|
||
"name": "coordinator",
|
||
"responsibility": "Orchestration",
|
||
"task_prefix": null,
|
||
"description": "技术债务治理协调者。编排 pipeline：需求澄清 → 模式选择 → 团队创建 → 任务分发 → 监控协调 → 质量门控 → 结果汇报",
|
||
"message_types_sent": ["mode_selected", "quality_gate", "task_unblocked", "error", "shutdown"],
|
||
"message_types_received": ["scan_complete", "assessment_complete", "plan_ready", "fix_complete", "validation_complete", "regression_found", "error"],
|
||
"commands": ["dispatch", "monitor"]
|
||
},
|
||
"scanner": {
|
||
"name": "scanner",
|
||
"responsibility": "Orchestration (多维度债务扫描)",
|
||
"task_prefix": "TDSCAN",
|
||
"description": "技术债务扫描员。多维度扫描代码库：代码债务、架构债务、测试债务、依赖债务、文档债务，生成债务清单",
|
||
"message_types_sent": ["scan_complete", "debt_items_found", "error"],
|
||
"message_types_received": [],
|
||
"commands": ["scan-debt"],
|
||
"cli_tools": ["gemini"],
|
||
"subagents": ["cli-explore-agent"]
|
||
},
|
||
"assessor": {
|
||
"name": "assessor",
|
||
"responsibility": "Read-only analysis (量化评估)",
|
||
"task_prefix": "TDEVAL",
|
||
"description": "技术债务评估师。量化评估债务项的影响和修复成本，按优先级矩阵排序，生成评估报告",
|
||
"message_types_sent": ["assessment_complete", "error"],
|
||
"message_types_received": [],
|
||
"commands": ["evaluate"],
|
||
"cli_tools": ["gemini"]
|
||
},
|
||
"planner": {
|
||
"name": "planner",
|
||
"responsibility": "Orchestration (治理规划)",
|
||
"task_prefix": "TDPLAN",
|
||
"description": "技术债务治理规划师。制定分阶段治理方案：短期速赢、中期系统性治理、长期预防机制",
|
||
"message_types_sent": ["plan_ready", "plan_revision", "error"],
|
||
"message_types_received": [],
|
||
"commands": ["create-plan"],
|
||
"cli_tools": ["gemini"],
|
||
"subagents": ["cli-explore-agent"]
|
||
},
|
||
"executor": {
|
||
"name": "executor",
|
||
"responsibility": "Code generation (债务清理执行)",
|
||
"task_prefix": "TDFIX",
|
||
"description": "技术债务清理执行者。按优先级执行重构、依赖更新、代码清理、测试补充等治理动作",
|
||
"message_types_sent": ["fix_complete", "fix_progress", "error"],
|
||
"message_types_received": [],
|
||
"commands": ["remediate"],
|
||
"subagents": ["code-developer"]
|
||
},
|
||
"validator": {
|
||
"name": "validator",
|
||
"responsibility": "Validation (清理验证)",
|
||
"task_prefix": "TDVAL",
|
||
"description": "技术债务清理验证者。验证清理后无回归、质量指标提升、债务确实消除",
|
||
"message_types_sent": ["validation_complete", "regression_found", "error"],
|
||
"message_types_received": [],
|
||
"commands": ["verify"],
|
||
"subagents": ["code-developer"],
|
||
"cli_tools": ["gemini"]
|
||
}
|
||
},
|
||
|
||
"pipeline_modes": {
|
||
"scan": {
|
||
"description": "仅扫描评估，不执行修复（审计模式）",
|
||
"stages": ["TDSCAN", "TDEVAL"],
|
||
"entry_role": "scanner"
|
||
},
|
||
"remediate": {
|
||
"description": "完整闭环：扫描 → 评估 → 规划 → 修复 → 验证",
|
||
"stages": ["TDSCAN", "TDEVAL", "TDPLAN", "TDFIX", "TDVAL"],
|
||
"entry_role": "scanner"
|
||
},
|
||
"targeted": {
|
||
"description": "定向修复：用户已知债务项，直接规划执行",
|
||
"stages": ["TDPLAN", "TDFIX", "TDVAL"],
|
||
"entry_role": "planner"
|
||
}
|
||
},
|
||
|
||
"fix_verify_loop": {
|
||
"max_iterations": 3,
|
||
"trigger": "validation fails or regression found",
|
||
"participants": ["executor", "validator"],
|
||
"flow": "TDFIX-fix → TDVAL-verify → evaluate"
|
||
},
|
||
|
||
"shared_memory": {
|
||
"file": "shared-memory.json",
|
||
"fields": {
|
||
"debt_inventory": { "owner": "scanner", "type": "array" },
|
||
"assessment_matrix": { "owner": "assessor", "type": "object" },
|
||
"remediation_plan": { "owner": "planner", "type": "object" },
|
||
"fix_results": { "owner": "executor", "type": "object" },
|
||
"validation_results": { "owner": "validator", "type": "object" },
|
||
"debt_score_before": { "owner": "assessor", "type": "number" },
|
||
"debt_score_after": { "owner": "validator", "type": "number" }
|
||
}
|
||
},
|
||
|
||
"collaboration_patterns": [
|
||
"CP-1: Linear Pipeline (scan/remediate/targeted mode)",
|
||
"CP-2: Review-Fix Cycle (Executor ↔ Validator loop)",
|
||
"CP-3: Fan-out (Scanner multi-dimension scan)",
|
||
"CP-5: Escalation (Worker → Coordinator → User)",
|
||
"CP-6: Incremental Delivery (batch remediation)",
|
||
"CP-10: Post-Mortem (debt reduction report)"
|
||
],
|
||
|
||
"debt_dimensions": {
|
||
"code": { "name": "代码债务", "tools": ["static-analysis", "complexity-metrics"] },
|
||
"architecture": { "name": "架构债务", "tools": ["dependency-graph", "coupling-analysis"] },
|
||
"testing": { "name": "测试债务", "tools": ["coverage-analysis", "test-quality"] },
|
||
"dependency": { "name": "依赖债务", "tools": ["outdated-check", "vulnerability-scan"] },
|
||
"documentation": { "name": "文档债务", "tools": ["doc-coverage", "api-doc-check"] }
|
||
},
|
||
|
||
"session_directory": {
|
||
"pattern": ".workflow/.team/TD-{slug}-{date}",
|
||
"subdirectories": ["scan", "assessment", "plan", "fixes", "validation"]
|
||
}
|
||
}
|