# 团队生命周期统一的团队技能：规范->实施->测试->评审。基于 **团队工作人员代理架构** 构建 - 所有工作人员角色共享一个代理定义，并从 Markdown 规范加载特定于角色的第 2-4 阶段。 ## 架构 +----------------------------------------------------------------+ | 技能（技能=“团队生命周期”）| | args="任务描述" | +--------------------+--------------------------------------------+ | 编排模式（自动 -> 协调器） | 协调员（内联） 0-5阶段编排 | +----+-----+--------+--------+--------+--------+ v v v v v v v [团队合作代理，每个代理都有一个角色规范] 分析师作家策划者执行者测试者评审者 ^^ 根据协调员的要求 +--------+ +--------+ |建筑师| |fe-dev | +--------+ +--------+ +--------+ | fe-qa | +--------+ 实用函数（可由工作人员调用）：【多角度讨论】——CLI工具批判 [代码库探索] - 探索带有缓存的代理 [文档生成]-CLI执行 ## 角色路由器此技能**仅限协调员**。工作人员不会调用此技能 - 他们直接作为“团队工作人员”代理产生。 ### 输入解析解析“$ARGUMENTS”。不需要“--role”——总是路由到协调器。 ### 角色注册表角色 |规格|任务前缀 |类型 |内循环 ---|---|---|---|--- 协调员| [roles/coordinator/role.md]() | （无）|协调器| - 分析师 | [role-specs/analyst.md]() |研究-* |管道|假的作家 | [role-specs/writer.md]() |草案-* |管道|真实策划师| [role-specs/planner.md]() |计划-* |管道|真实执行人| [role-specs/executor.md]() | IMPL-* |管道|真实测试仪| [role-specs/tester.md]() |测试-* |管道|假的审稿人| [role-specs/reviewer.md]() |审查-* + 质量-* + 改进-* |管道|假的建筑师 | [role-specs/architect.md]() |拱门-* |咨询|假的 fe 开发人员 | [role-specs/fe-developer.md]() | DEV-FE-* |前端 |假的 fe-qa | [role-specs/fe-qa.md]() |质量保证-FE-* |前端 |假的 ### 实用函数功能|实施 |可调用者 |目的 ---|---|---|--- 多视角讨论| CLI 工具（ccw cli --模式分析）|分析师、作家、评论家 |多视角批判代码库探索 |探索代理|分析师、规划师，任何角色 |使用缓存探索代码库文档生成 | CLI 工具（ccw cli --mode write）|作家 |文档生成 ### 调度始终路由至协调器。协调器读取“roles/coordinator/role.md”并执行其阶段。 ### 编排模式用户只需提供任务描述。 **调用**：`技能（技能=“团队生命周期”，args=“任务描述”）` **生命周期**：用户提供任务描述 -> 协调员阶段 1-3：需求澄清 -> TeamCreate -> 创建任务链 -> 协调器第 4 阶段：产生第一批工作人员（后台） -> 停止 -> Worker 执行 -> SendMessage 回调 -> 协调器前进下一步 -> 循环直到管道完成 -> 第 5 阶段报告 **用户命令**（唤醒暂停的协调器）：命令 |行动 ---|--- `检查` / `状态` |输出执行状态图，无进展 `继续` / `继续` |检查工人状态，推进下一步 `修改 <任务 ID> [反馈]` |创建修订任务+级联下游 `反馈<文本>` |分析反馈影响，创建有针对性的修订链 `重新检查` |重新运行 QUALITY-001 质量检查 `改进[维度]` |自动改进准备情况报告中最薄弱的维度 ** ** ## 协调器生成模板 ### v5 Worker Spawn（所有角色）当协调器生成工作人员时，使用带有角色规范路径的“team-worker”代理：代理({ agent_type: "团队合作者", 描述：“生成<角色>工人”， team_name: <团队名称>, 名称：“<角色>”， run_in_background：真，提示：`## 角色分配角色：<角色> 角色规范：.claude/skills/team-lifecycle/role-specs/<角色>.md 会话：<会话文件夹> session_id: <会话 ID> team_name: <团队名称> 要求：<任务描述> 内部循环：<真|假> 读取 role_spec 文件以加载阶段 2-4 域指令。执行内置阶段 1（任务发现）-> 角色规范阶段 2-4 -> 内置阶段 5（报告）。 }) **内循环角色**（编写者、计划者、执行者）：设置 `inner_loop: true`。团队工作代理在内部处理循环。 **单任务角色**（分析师、测试员、审阅员、架构师、fe-开发人员、fe-qa）：设置 `inner_loop: false`。 ** ** ## 管道定义 ### 仅规格（6 项任务）研究-001(+D1) -> 草案-001(+D2) -> 草案-002(+D3) -> 草案-003(+D4) -> 草案-004(+D5) -> 质量-001(+D6) ### 仅 Impl（4 个任务） PLAN-001 -> IMPL-001 -> TEST-001 + REVIEW-001 ### 全生命周期（10 个任务） [规格管道] -> PLAN-001（阻塞者：QUALITY-001） -> IMPL-001 -> TEST-001 + REVIEW-001 ### 前端管道仅 FE：PLAN-001 -> DEV-FE-001 -> QA-FE-001 （GC 循环：QA-FE 判决=NEEDS_FIX -> DEV-FE-002 -> QA-FE-002，最多 2 轮）全栈：PLAN-001 -> IMPL-001 || DEV-FE-001 -> 测试-001 || QA-FE-001 -> 审查-001 完整 + FE：[规格管道] -> PLAN-001 -> IMPL-001 || DEV-FE-001 -> 测试-001 || QA-FE-001 -> 审查-001 ### 踏频控制 **节拍模型**：事件驱动，每个节拍 = 协调器唤醒 -> 进程 -> 生成 -> 停止。节拍周期（单节拍） ========================================================================= 活动协调员 ---------------------------------------------------------------------------------- 回调/恢复 --> +- handleCallback -+ | 标记已完成 | | 检查管道| +-handleSpawnNext-+ | 查找准备好的任务| | 生成工人 ---+--> [团队工人 A] 阶段 1-5 | （并行 OK） --+--> [团队工作者 B] 阶段 1-5 +- 停止（空闲）-----+ | | 回调 <-----------------------------------------+ （下一拍）SendMessage + TaskUpdate（完成） ========================================================================= Fast-Advance（跳过简单线性后继的协调器） ========================================================================= [工人A]第5阶段完成 +- 1 个准备好的任务？简单的继承者？ | --> 直接生成团队工作人员 B | --> 将 fast_advance 记录到消息总线（协调器在下次唤醒时同步） +- 复杂的情况？ --> 向协调器发送消息 ========================================================================= ### 检查点触发|职位|行为 ---|---|--- Spec->Impl 转换 | QUALITY-001 已完成 |读取 readiness-report.md，显示检查点，暂停用户操作 GC 循环最大 | QA-FE 最多 2 轮 |停止迭代，报告当前状态管道失速|没有准备+没有运行|检查缺失的任务，报告给用户 **检查点输出模板**（QUALITY-001 完成）： [协调员] ═════════════════════ ═════════════════════ [协调员] 规范阶段已完成 [协调员] 质量门：<通过|审核|失败> (<分数>%) [协调员] [协调员]维度分数： [协调员] 完整性： % [协调员] 一致性： % [协调员] 可追溯性： % [协调员] 深度： % [协调员] 覆盖率： % [协调员] [协调员] 可用的行动： [协调员]简历 -> 继续实施 [协调员] 改进 -> 自动改进最弱维度 [coordinator] Improve -> 改进特定维度 [coordinator] revise -> 修改具体文档 [协调员] 重新检查 -> 重新运行质量检查 [协调员]反馈 <文本> -> 注入反馈，创建修订 [协调员] ═════════════════════ ═════════════════════ ### 任务元数据注册表任务 ID |角色 |相|依赖关系 |内联讨论 ---|---|---|---|--- 研究-001 |分析师 |规格| （无）|讨论-001 草案-001 |作家 |规格|研究-001 |讨论-002 草案-002 |作家 |规格|草案-001 |讨论-003 草案-003 |作家 |规格|草案-002 |讨论-004 草案-004 |作家 |规格|草案-003 |讨论-005 质量-001 |审稿人|规格|草案-004 |讨论-006 计划-001 |策划师|暗示 | （无或 QUALITY-001）| - IMPL-001 |执行人|暗示 |计划-001 | - 测试-001 |测试仪|暗示 | IMPL-001 | - 评论-001 |审稿人|暗示 | IMPL-001 | - 开发-FE-001 | fe 开发人员 |暗示 |计划-001 | - QA-FE-001 | fe-qa |暗示 |开发-FE-001 | - ** ** ## 会话目录 .workflow/.team/TLS--<日期>/ +-- team-session.json +-- 规格/ | +--spec-config.json | +-- discovery-context.json | +-- 产品简介.md | +-- 要求/ | +-- 架构/ | +-- 史诗/ | +-- 准备情况报告.md | +-- 规范摘要.md +-- 讨论/ +-- 计划/ | +-- plan.json | +-- .task/TASK-*.json +-- 探索/ | +-- 缓存索引.json | +-- 探索-<角度>.json +-- 架构/ +-- 分析/ +-- 质量保证/ +-- 智慧/ | +-- 学习.md | +-- 决策.md | +-- 约定.md | +-- issues.md +-- .msg/ +-- 共享内存.json ## 会话恢复协调器支持中断会话的“--resume”/“--continue”： 1. 扫描“.workflow/.team/TLS-*/team-session.json”以查找活动/暂停的会话 2. 多个匹配项 -> AskUserQuestion 进行选择 3.审核TaskList -> 协调会话状态<->任务状态 4.重置in_progress->pending（中断的任务） 5. 重建团队并仅生成所需的工人 6. 使用正确的blockedBy创建缺失的任务 7. 启动第一个可执行任务 -> 第 4 阶段协调循环 ## 共享资源资源 |路径|用途 ---|---|--- 文件标准| [specs/document-standards.md]() | YAML 的前题、命名、结构质量门| [specs/quality-gates.md]() |每阶段质量门团队配置| [specs/team-config.json]() |角色注册表、管道定义产品简介模板| [templates/product-brief.md]() |草案-001 需求模板| [templates/requirements-prd.md]() |草案-002 架构模板| [templates/architecture-doc.md]() |草案-003 史诗模板| [templates/epics-template.md]() |草案-004 ## 错误处理场景 |分辨率 ---|--- 未知命令 |可用命令列表错误找不到角色规范文件 |预期路径错误未找到命令文件 |回退到内联执行多视角讨论失败|工人不经讨论就继续进行，记录警告探索缓存损坏 |清除缓存，重新探索快速推进会产生错误的任务 |协调器在下一次回调时进行协调

团队生命周期

包含技能