# 团队绩效优化统一的团队技能：分析应用程序性能、识别瓶颈、设计优化策略、实施变更、基准改进和审查代码质量。构建于**团队工作人员代理架构** \--所有工作人员角色共享一个代理定义，并具有从 Markdown 规范加载的特定于角色的第 2-4 阶段。 ## 架构 +----------------------------------------------------------------+ | 技能（技能=“团队性能选择”）| | args="<任务描述>" | +--------------------+--------------------------------------------+ | 编排模式（自动 -> 协调器） | 协调员（内联） 0-5阶段编排 | +--------+--------+--------+--------+ 维维维维维 [tw] [tw] [tw] [tw] [tw] 分析器策略-优化-基准-审查- 要点标记器 (tw) = 团队合作代理 ## 角色路由器此技能**仅限协调员**。工作人员不会调用此技能——他们直接作为“团队工作人员”代理产生。 ### 输入解析解析“$ARGUMENTS”。不需要“--role”——总是路由到协调器。 ### 角色注册表角色 |规格|任务前缀 |类型 |内循环 ---|---|---|---|--- 协调员| [roles/coordinator/role.md]() | （无）|协调器| - 分析器| [role-specs/profiler.md]() |简介-* |编排|假的战略家| [role-specs/strategist.md]() |策略-* |编排|假的优化器| [role-specs/optimizer.md]() | IMPL-* / FIX-* |代码生成|真实基准测试者| [role-specs/benchmarker.md]() |长凳-* |验证|假的审稿人| [role-specs/reviewer.md]() |审查-* / 质量-* |只读分析 |假的 ### 调度始终路由至协调器。协调器读取“roles/coordinator/role.md”并执行其阶段。 ### 编排模式用户只需提供任务描述。 **调用**： Skill(skill="team-perf-opt", args="") # 自动模式 Skill(skill="team-perf-opt", args="--parallel-mode=fan-out ") # 强制扇出 Skill(skill="team-perf-opt", args='--parallel-mode=independent "target1" "target2"') # 独立 Skill(skill="team-perf-opt", args="--max-branches=3 ") # 限制分支 **并行模式**：模式|描述 |何时使用 ---|---|--- `自动`（默认）|计数 <= 2 -> 单，计数 >= 3 -> 扇出 |一般优化请求 `单身` |线性流水线，无分支 |简单或紧密耦合的优化 `扇出` |共享PROFILE+STRATEGY，然后N个并行的IMPL->BENCH+REVIEW分支 |多个独立的瓶颈 `独立` |从分析到审查的 M 条完全独立的管道 |单独的优化目标 **生命周期**：用户提供任务描述+可选的 --parallel-mode / --max-branches -> 协调器阶段 1-3：解析标志 -> TeamCreate -> 创建任务链（模式感知） -> 协调器第 4 阶段：产生第一批工作人员（后台） -> 停止 -> Worker（团队工作代理）执行 -> SendMessage 回调 -> 协调器前进 -> [自动/扇出] CP-2.5：策略完成 -> 创建 N 个分支任务 -> 并行生成所有 IMPL-B* -> [独立] 所有管道从一开始就并行运行 -> 每个分支/管道修复周期独立运行 -> 所有分支/管道完成 -> 汇总 -> 第 5 阶段报告 + 完成行动 **用户命令**（唤醒暂停的协调器）：命令 |行动 ---|--- `检查` / `状态` |输出执行状态图（分支分组），无进展 `继续` / `继续` |检查工人状态，推进下一步 `修改 <任务 ID> [反馈]` |创建修订任务+级联下游（范围为分支） `反馈<文本>` |分析反馈影响，创建有针对性的修订链 `重新检查` |重新运行质量检查 `改进[维度]` |自动改进最弱维度 ** ** ## 命令执行协议当协调器需要执行命令（调度、监控）时： 1. **读取命令文件** : `roles/coordinator/commands/.md` 2. **遵循命令文件中定义的工作流程**（阶段2-4结构） 3. **命令是内联执行指南** \-- 不是单独的代理或子流程 4. **同步执行** \--完成命令工作流程后再继续示例：第三阶段需要任务调度 -> 读取roles/coordinator/commands/dispatch.md -> 执行阶段 2（上下文加载） -> 执行阶段 3（任务链创建） -> 执行第 4 阶段（验证） -> 继续第四阶段 ** ** ## 协调器生成模板 ### v5 Worker Spawn（所有角色）当协调器生成工作人员时，使用带有角色规范路径的“team-worker”代理：代理({ subagent_type: "团队工作者", 描述：“生成<角色>工人”， team_name: <团队名称>, 名称：“<角色>”， run_in_background：真，提示：`## 角色分配角色：<角色> 角色规范：.claude/skills/team-perf-opt/role-specs/<角色>.md 会话：<会话文件夹> session_id: <会话 ID> team_name: <团队名称> 要求：<任务描述> 内部循环：<真|假> 读取 role_spec 文件以加载阶段 2-4 域指令。执行内置阶段 1（任务发现）-> 角色规范阶段 2-4 -> 内置阶段 5（报告）。 }) **内循环角色**（优化器）：设置 `inner_loop: true`。团队工作代理在内部处理循环。 **单任务角色**（分析者、策略师、基准测试者、审阅者）：设置 `inner_loop: false`。 ** ** ## 管道定义 ### 管道图 **单模式**（线性，向后兼容）：管道：单一（与审查-修复周期呈线性） ========================================================================= 第一阶段第二阶段第三阶段第四阶段配置文件-001 --> 策略-001 --> IMPL-001 --> BENCH-001 [分析器] [策略师] [优化器] [基准测试器] ^ | +<--FIX-001---->+ | 评论-001 +<--------> [审阅者] （最多 3 次迭代）| 完成 ========================================================================= **扇出模式**（共享阶段 1-2，并行分支 3-4）：管道：扇出（N 个并行优化分支） ========================================================================= 第 1 阶段第 2 阶段 CP-2.5 第 3+4 阶段（每个分支）（分支创建） PROFILE-001 --> STRATEGY-001 --+-> IMPL-B01 --> BENCH-B01 + REVIEW-B01（修复周期） [剖析师] [策略师] | [优化者] [替补] [审稿人] +-> IMPL-B02 --> BENCH-B02 + REVIEW-B02（修复周期） | [优化者] [替补] [审稿人] +-> IMPL-B0N --> BENCH-B0N + REVIEW-B0N（修复周期） | 聚合 -> 阶段 5 ========================================================================= **独立模式**（M条完全独立的管道）：管道：独立（M条完整管道） ========================================================================= 管道 A：PROFILE-A01 --> STRATEGY-A01 --> IMPL-A01 --> BENCH-A01 + REVIEW-A01 管道 B：PROFILE-B01 --> STRATEGY-B01 --> IMPL-B01 --> BENCH-B01 + REVIEW-B01 管道 C：PROFILE-C01 --> STRATEGY-C01 --> IMPL-C01 --> BENCH-C01 + REVIEW-C01 | 聚合 -> 阶段 5 ========================================================================= ### 踏频控制 **节拍模型**：事件驱动，每个节拍 = 协调器唤醒 -> 进程 -> 生成 -> 停止。节拍周期（单节拍） ========================================================================= 活动协调员 ---------------------------------------------------------------------------------- 回调/恢复 --> +- handleCallback -+ | 标记已完成 | | 检查管道| +-handleSpawnNext-+ | 查找准备好的任务| | 生成工人 ---+--> [团队工人 A] 阶段 1-5 | （并行 OK） --+--> [团队工作者 B] 阶段 1-5 +- 停止（空闲）-----+ | | 回调 <-----------------------------------------+ （下一拍）SendMessage + TaskUpdate（完成） ========================================================================= Fast-Advance（跳过简单线性后继的协调器） ========================================================================= [工人A]第5阶段完成 +- 1 个准备好的任务？简单的继承者？ | --> 直接生成团队工作人员 B | --> 将 fast_advance 记录到消息总线（协调器在下次唤醒时同步） +- 复杂的情况？ --> 向协调器发送消息 ========================================================================= Beat View：性能优化管道 ========================================================================= 活动协调员 ---------------------------------------------------------------------------------- 新任务 --> +- 第 1-3 阶段：澄清 -+ | 团队创建| | 创建配置文件-001 | +- 第 4 阶段：生成 ------+--> [分析器] 第 1-5 阶段 +- 停止（空闲）---------+ | | 回调 <----------------------------------------------------------+ （分析器完成）--> +- handleCallback ------+ profile_complete | 标记个人资料已完成 | | 生成战略家 ----+--> [战略家] 阶段 1-5 +- 停止 ----------------+ | | 回调 <----------------------------------------------------------+ （策略师完成）--> +-handleCallback ------+strategy_complete | 标记策略已完成 | | 生成优化器 ---+--> [优化器] 阶段 1-5 +- 停止 ----------------+ | | 回调 <----------------------------------------------------------+ （优化器完成）--> +- handleCallback ------+ impl_complete | 标记 IMPL 已完成 | | 生成台+审阅者-+--> [基准测试者] 阶段 1-5 | （并行）--------+--> [审稿人] 阶段 1-5 +- 停止 ----------------+ | | | | 回调 x2 <--------------------------------------+------------+ --> +- 处理回调 ------+ | 都完成了吗？ | | 是 + 通过 -> 阶段 5| | 否/失败 -> 修复任务| | 生成优化器 ---+--> [优化器] FIX-001 +- 停止或阶段 5 -----+ ========================================================================= **检查点**：检查站|触发|地点 |行为 ---|---|---|--- CP-1 | PROFILE-001 完整 |第一阶段之后 |用户审查瓶颈报告，可以细化范围 CP-2 | STRATEGY-001 完成 |第 2 阶段之后 |用户审核优化计划，可以调整优先级 CP-2.5 | STRATEGY-001 完整（自动/扇出）|第 2 阶段之后 |根据优化计划自动创建 N 个分支任务，并行生成所有 IMPL-B* CP-3 |审查/基准失败 |第 4 阶段（每个分支）|仅针对该分支自动创建 FIX 任务（每个分支最多 3 个） CP-4 |所有任务/分支完成 |第五阶段 |聚合结果，交互式完成动作 ### 任务元数据注册表 **单模式**（向后兼容）：任务 ID |角色 |相|依赖关系 |描述 ---|---|---|---|--- 简介-001 |分析器|第一阶段 | （无）|配置文件应用程序，识别瓶颈策略-001 |战略家|第二阶段 |简介-001 |根据瓶颈报告设计优化计划 IMPL-001 |优化器|第三阶段 |策略-001 |实施最高优先级的优化长凳-001 |基准测试者|第四阶段 | IMPL-001 |运行基准测试，与基线进行比较评论-001 |审稿人|第四阶段 | IMPL-001 |检查优化代码的正确性固定001 |优化器|第三阶段（周期）| REVIEW-001 或 BENCH-001 |修复审查/基准测试中发现的问题 **扇出模式**（在 CP-2.5 创建的分支任务）：任务 ID |角色 |相|依赖关系 |描述 ---|---|---|---|--- 简介-001 |分析器|第一阶段（共享）| （无）|简介申请策略-001 |战略家|第 2 阶段（共享）|简介-001 |具有离散 OPT-ID 的设计计划 IMPL-B{NN} |优化器|第三阶段（分支）|策略-001 |仅实施 OPT-{NNN} 长凳-B{NN} |基准测试者|第四阶段（分支）| IMPL-B{NN} |基准分支 B{NN} 评论-B{NN} |审稿人|第四阶段（分支）| IMPL-B{NN} |检查分支 B{NN} FIX-B{NN}-{循环} |优化器|修复（分支）| （无）|修复分支 B{NN} 中的问题 BENCH-B{NN}-R{循环} |基准测试者|重试（分支）| FIX-B{NN}-{循环} |修复后重新基准测试回顾-B{NN}-R{周期} |审稿人|重试（分支）| FIX-B{NN}-{循环} |修复后重新审核 **独立模式**：任务 ID |角色 |相|依赖关系 |描述 ---|---|---|---|--- 简介-{P}01 |分析器|第一阶段| （无）|管道 {P} 目标的配置文件策略-{P}01 |战略家|第二阶段 |简介-{P}01 |管道策略{P} IMPL-{P}01 |优化器|第三阶段 |策略-{P}01 |实施管道 {P} 优化长凳-{P}01 |基准测试者|第四阶段 | IMPL-{P}01 |基准管道{P} 评论-{P}01 |审稿人|第四阶段 | IMPL-{P}01 |审查管道{P} 修复-{P}01-{循环} |优化器|修复 | （无）|修复管道中的问题 {P} ### 任务命名规则模式|第三阶段 |第四阶段 |修复 |重试 ---|---|---|---|--- 单| IMPL-001 |工作台-001，评论-001 |固定001 | BENCH-001-R1，审查-001-R1 扇出| IMPL-B01 |工作台-B01，回顾-B01 |修复-B01-1 |工作台-B01-R1，回顾-B01-R1 独立| IMPL-A01 |工作台-A01，回顾-A01 |修复-A01-1 |工作台-A01-R1，回顾-A01-R1 ** ** ## 完成动作当管道完成时（所有任务完成，协调器第 5 阶段）：询问用户问题({ 问题：[{ 问题：“团队管道已完成。您想做什么？”, 标题：“完成”，多重选择：假，选项：[ { label: "存档和清理（推荐）", description: "存档会话，清理任务和团队资源" }, { label: "Keep Active", description: "保持会话活跃以进行后续工作或检查" }, { label: "导出结果", description: "将可交付成果导出到指定位置，然后清理" } ] }] }) 选择|行动 ---|--- 归档和清理|更新会话状态=“已完成” - > TeamDelete（） - >输出最终摘要保持活跃 |更新会话状态=“暂停”->输出恢复指令：`Skill（skill =“team-perf-opt”，args =“resume”）` 导出结果 |向用户询问目标路径 -> 复制可交付成果 -> 存档和清理 ** ** ## 会话目录 **单模式**： .workflow/<会话 ID>/ +-- session.json # 会话元数据+状态+parallel_mode +-- 文物/ | +--baseline-metrics.json # Profiler：优化前指标 | +--bottleneck-report.md # Profiler：对瓶颈发现进行排名 | +-- optimization-plan.md # 策略师：优先优化计划 | +-- benchmark-results.json # 基准测试：优化后指标 | +-- review-report.md # 审阅者：代码审查结果 +-- 探索/ | +--cache-index.json # 共享探索缓存 | +-- .md # 缓存探索结果 +-- 智慧/ | +--patterns.md # 发现的模式和约定 | +-- .msg/messages.jsonl # 团队消息总线 | +-- .msg/meta.json # 会话元数据 +-- 讨论/ | +-- DISCUSS-OPT.md # 策略讨论记录 | +-- DISCUSS-REVIEW.md # 回顾讨论记录 **扇出模式**（添加分支/目录）： .workflow/<会话 ID>/ +-- session.json # + 并行模式、分支、fix_cycles +-- 文物/ | +--baseline-metrics.json # 共享基线（所有分支都使用这个） | +--bottleneck-report.md # 共享瓶颈报告 | +-- optimization-plan.md # 具有离散 OPT-ID 的共享计划 | +--aggregate-results.json # 所有分支的聚合结果 | +-- 分支/ | +-- B01/ | | +-- optimization-detail.md # 提取 OPT-001 详细信息 | | +-- benchmark-results.json # 分支 B01 基准测试 | | +-- review-report.md # 分支 B01 评论 | +-- B02/ | | +-- 优化-detail.md | | +-- 基准测试结果.json | | +-- 审查报告.md | +-- B0N/ +-- 探索/智慧/讨论/ # 与单身相同 **独立模式**（添加 pipelines/ 目录）： .workflow/<会话 ID>/ +-- session.json # +parallel_mode,independent_targets,fix_cycles +-- 文物/ | +--aggregate-results.json # 所有管道的聚合结果 | +-- 管道/ | +-- A/ | | +-- 基线-metrics.json | | +-- 瓶颈报告.md | | +-- 优化计划.md | | +-- 基准测试结果.json | | +-- 审查报告.md | +-- B/ | +-- 基线-metrics.json | +-- ... +-- 探索/智慧/讨论/ # 与单身相同 ## 会话恢复协调器支持中断会话的“--resume”/“--continue”： 1. 扫描会话目录以查找状态为“活动”或“已暂停”的会话 2. 多个匹配项 -> AskUserQuestion 进行选择 3.审核TaskList -> 协调会话状态<->任务状态 4.重置in_progress->pending（中断的任务） 5. 重建团队并仅生成所需的工人 6. 使用正确的blockedBy创建缺失的任务 7. 启动第一个可执行任务 -> 第 4 阶段协调循环 ## 共享资源资源 |路径|用途 ---|---|--- 绩效基准| [/artifacts/baseline-metrics.json](/artifacts/baseline-metrics.json) |用于比较的优化前指标瓶颈报告| [/artifacts/bottleneck-report.md](/artifacts/bottleneck-report.md) |策略师消耗的分析器输出优化方案| [/artifacts/optimization-plan.md](/artifacts/optimization-plan.md) |优化器消耗的策略输出基准结果| [/artifacts/benchmark-results.json](/artifacts/benchmark-results.json) |审阅者消耗的基准输出 ## 错误处理场景 |分辨率 ---|--- 找不到角色规范文件 |预期路径错误（角色规范/.md）未找到命令文件 |回退到协调器 role.md 中的内联执行找不到角色文件 |预期路径错误（角色规范/.md）检测到快进孤儿 |协调器在下次检查时将任务重置为待处理 consensus_blocked 高 |协调员创建修订任务或暂停管道团队工作人员代理不可用 |错误：需要 .claude/agents/team-worker.md 完成操作超时 |默认保持活动状态分析工具不可用 |回退到静态分析方法检测到基准回归 |自动创建带有回归详细信息的 FIX 任务（范围为分支/管道）审核-修复周期超过 3 次迭代 |升级给用户并提供剩余问题的摘要（每个分支/管道范围）一个分支 IMPL 失败 |标记该分支失败，其他分支继续完成检测到分支范围重叠 |策略师约束不重叠的目标文件； IMPL 记录检测警告共享内存并发写入 |每个工作人员仅写入自己的命名空间密钥（例如“optimizer.B01”）分支修复周期 >= 3 |仅将该分支升级给用户，其他分支独立继续超出 max_branches |协调器在 CP-2.5 处按优先级截断到前 N 个优化独立管道局部失效|失败的管道被标记，其他管道继续；汇总报告部分结果

团队绩效选择

包含技能