# 团队超分析深入的协作分析团队技能。将整体分析分为 5 个角色协作：探索 -> 分析 -> 讨论 -> 综合。支持具有可配置深度的快速/标准/深度管道模式（N 个并行代理）。讨论循环可实现用户引导的渐进式理解。所有成员均通过“--role=xxx”路由。 ## 架构 +----------------------------------------------------------------+ | 技能（技能=“团队超分析”）| | args="<主题描述>" | +--------------------+--------------------------------------------+ | 编排模式（自动 -> 协调器） | 协调员（内联） 0-5阶段编排 | +--------+--------+--------+--------+ 维维维维 [tw] [tw] [tw] [tw] 探索-分析-讨论-综合- er st ssant sizer (tw) = 团队合作代理 ## 命令架构角色/ +-- 协调员/ | +-- role.md # 编排：主题澄清、管道选择、讨论循环、报告 | +-- 命令/ | +--dispatch.md # 任务链创建和依赖管理 | +-- monitor.md # 进度监控+讨论循环 +-- 探索者/ | +-- role.md # 代码库探索 | +-- 命令/ | +-- explore.md # cli-explore-agent 并行探索 +-- 分析师/ | +-- role.md # 深度分析 | +-- 命令/ | +--analyze.md # CLI多角度分析 +-- 讨论者/ | +-- role.md # 讨论处理+方向调整 | +-- 命令/ | +-- Deep.md # 深度探索 +-- 合成器/ +-- role.md # 综合和结论 +-- 命令/ +-- Synthesize.md # 跨视角集成 **设计原则**：role.md 保留内嵌第 1 阶段（任务发现）和第 5 阶段（报告）。第 2-4 阶段根据复杂性委托给 `commands/*.md`。 ## 角色路由器 ### 输入解析解析 `$ARGUMENTS` 以提取 `--role` 和可选的 `--agent-name`。如果缺少“--role”，则进入编排模式（自动路由到协调器）。 `--agent-name` 参数支持并行实例（例如 explorer-1、analyst-2），并传递到 role.md 以进行任务发现过滤。 ### 角色注册表角色 |规格|任务前缀 |内循环 ---|---|---|--- 协调员| [roles/coordinator/role.md]() | （无）| - 探险家| [role-specs/explorer.md]() |探索-* |假的分析师 | [role-specs/analyst.md]() |分析-* |假的讨论者 | [role-specs/discussant.md]() |讨论-* |假的合成器| [role-specs/synthesizer.md]() |合成器-* |假的 > **紧凑保护**：角色文件是执行文档，而不是参考材料。当发生上下文压缩并且角色指令被简化为摘要时，您**必须立即`读取`相应的role.md以重新加载，然后才能继续执行**。切勿仅根据压缩摘要执行任何阶段。＃＃＃派遣 1. 从参数中提取 `--role` 2. 如果没有 `--role` -> 路由到协调器（编排模式） 3. 在注册表中查找角色 -> 读取角色文件 -> 执行其阶段 ### 编排模式当在没有“--role”的情况下调用时，协调器会自动启动。用户只需提供分析主题。 **调用** : `Skill(skill="team-ultra-analyze", args="分析主题描述")` **生命周期**：用户提供分析主题 -> 协调员阶段 1-3：主题澄清 -> TeamCreate -> 管道选择 -> 创建任务链 -> 协调器第 4 阶段：并行生成深度探索器（后台） -> 停止 -> 探索者执行 -> SendMessage 回调 -> 协调器生成分析师 -> 分析师执行 -> SendMessage 回调 -> 协调者生成讨论者 -> 讨论循环（深度模式：用户反馈 -> 深化 -> 重新分析 -> 重复） -> 协调器生成合成器 -> 最终结论 -> 第 5 阶段报告 **用户命令**（唤醒挂起的协调器）：命令 |行动 ---|--- `检查` / `状态` |输出执行状态图，不推进pipeline `继续` / `继续` |检查工作人员状态，前进到下一个管道步骤 ** ** ## 共享基础设施以下模板适用于所有辅助角色。每个role.md只需要定义**阶段2-4**特定于角色的逻辑。 ### Worker阶段1：任务发现（所有worker共享）每个工作进程在启动时执行相同的任务发现流程： 1. 调用`TaskList()`获取所有任务 2. 过滤器：主题与该角色的前缀匹配 + 所有者与该代理的名称匹配 + 状态为待处理 +BlockedBy 为空 3.无任务->空闲等待 4. 有任务 -> `TaskGet` 了解详细信息 -> `TaskUpdate` 标记 in_progress **恢复工件检查**（防止恢复后重复输出）： * 检查该任务的输出工件是否已经存在 * 工件完成 -> 跳到第 5 阶段报告完成 * 工件不完整或缺失 -> 正常执行阶段 2-4 ### Worker 阶段 5：报告（由所有 Worker 共享）任务完成后的标准报告流程： 1. **消息总线** : 调用`mcp__ccw-tools__team_msg`来记录消息 * 参数：操作=“log”，session_id=，from=，type=，data={ref：“”} * `to` 和 `summary` 自动默认——不明确指定 * **CLI 后备** : `ccw team log --session-id --from --type --json` 2. **SendMessage** ：将结果发送给协调员（内容和摘要均以 `[]` 为前缀） 3. **TaskUpdate** ：标记任务已完成 4. **循环**：返回阶段1检查下一个任务 ### 智慧积累（所有角色）跨任务知识积累。协调器在会话初始化期间创建“wisdom/”目录。 **目录**： <会话文件夹>/wisdom/ +--learnings.md # 模式和见解 +-- Decisions.md # 分析方向决策 +-- conventions.md # 发现的代码库约定 +-- issues.md # 已知风险和问题 **工作负载**（阶段2）：从任务描述中提取`Session：`，读取wisdom目录文件。 **工人贡献**（阶段4/5）：将此任务的发现写入相应的智慧文件中。 ### 角色隔离规则允许 |禁止 ---|--- 处理与自己的前缀匹配的任务 |具有其他角色前缀的流程任务向协调员发送消息 |直接与其他工人沟通通过 team_msg(type='state_update') 共享状态 |为其他角色创建任务委托给命令/*.md |修改自己责任之外的资源 Coordinator还禁止：直接执行代码探索或分析、直接调用cli-explore-agent或CLI分析工具、绕过worker完成工作。 ### 跨角色状态通过“team_msg(type='state_update')”管理跨角色状态，存储在“.msg/meta.json.role_state”中。每个角色读取所有状态，但仅写入其自己的指定字段：角色 |州场 ---|--- 探险家| 「探索」分析师 | `分析` 讨论者 | `讨论` 合成器| `综合` 协调员| `决策轨迹` \+ `当前理解` 启动时，通过 team_msg(operation="get_state", session_id=)` 读取角色状态。完成工作后，通过 team_msg(operation="log", session_id=, from=, type="state_update", data={...})` 共享结果。 ### 消息总线（所有角色）所有角色在通过 SendMessage 发送消息之前都会记录消息。使用以下命令调用 `mcp__ccw-tools__team_msg`：operation="log", session_id=, from=, type=, data={ref: ""}。 `to` 和 `summary` 是自动默认的。角色 |类型 ---|--- 协调员| `pipeline_selected`、`discussion_round`、`direction_adjusted`、`task_unblocked`、`error`、`shutdown` 探险家| `探索就绪`、`错误` 分析师 | `分析就绪`、`错误` 讨论者 | `讨论已处理`、`错误` 合成器| `synthesis_ready`, `错误` **CLI 后备** ：当 MCP 不可用时 -> `ccw team log --session-id --from --type --json` ** ** ## 三模式流水线架构快速：EXPLORE-001 -> ANALYZE-001 -> SYNTH-001 标准：[EXPLORE-001..深度]（并行）-> [ANALYZE-001..深度]（并行）-> DISCUSS-001 -> SYNTH-001 深度：[探索-001..深度] -> [分析-001..深度] -> 讨论-001 -> 分析修复 -> 讨论-002 -> ... -> SYNTH-001 ### 模式自动检测首先从参数中解析“--mode”。如果未指定，则从主题描述中自动检测：状况 |模式|深度 ---|---|--- `--mode=quick` 显式或主题包含“quick/overview/fast” |快| 1 `--mode=deep` 显式或主题包含“深入/彻底/详细/全面” |深| N（从角度来看）默认（不匹配）|标准| N（从角度来看） **深度**由所选分析视角的数量决定（例如架构、实现、性能、安全、概念、比较、决策）。快速模式始终使用深度=1。标准/深度模式使用深度=所选视角的数量。 ### 讨论循环（深度模式）协调员（AskUser）-> 讨论-N（加深）-> [可选分析修复]-> 协调员（AskUser）-> ... -> SYNTH 最多 5 轮讨论。如果超过，则强制合成并提供继续选项。 ## 决策记录协议 **CRITICAL** ：继承自原始的analyze-with-file命令。在分析过程中，必须立即将以下内容记录到discussion.md中：触发|记录什么 |目标部分 ---|---|--- **方向选择** |选择了什么、为什么、哪些替代方案被拒绝 | `#### 决策日志` **重要发现** |发现内容、影响范围、置信度 | `#### 主要发现` **假设改变** |旧假设 -> 新理解、变化原因、影响 | `#### 更正的假设` **用户反馈** |用户的原始输入、采用/调整理由| `#### 用户输入` ## 踏频控制 **节拍模型**：事件驱动。每个节拍 = 协调器唤醒 -> 处理回调 -> 产生下一阶段 -> 停止。节拍周期（单节拍） ========================================================================= 活动协调员 -------------------------------------------------------------------------------- 回调/恢复 --> +- handleCallback -+ | 标记已完成 | | 检查管道| +-handleSpawnNext-+ | 查找准备好的任务| | 生成工人 ---+--> [工人 A] 阶段 1-5 | （并行 OK） --+--> [工人 B] 阶段 1-5 +- 停止（空闲）-----+ | | 回调 <----------------------------------------------------+ （下一拍）SendMessage + TaskUpdate（完成） ========================================================================= **讨论循环节拍（具有可配置深度的深度模式）**：第一阶段（探索）：同时生成深度探索者 EXPLORE-1、EXPLORE-2、...、探索深度（全部并行） -> 全部完成 -> 协调器唤醒第 2 阶段（分析）：同时生成深度分析人员 ANALYZE-1、ANALYZE-2、...、ANALYZE-深度（全部并行） -> 全部完成 -> 协调器唤醒第 3 阶段（讨论）：生成 1 号讨论者讨论-001 -> 完成 -> 协调员询问用户方向阶段 3a（循环）：如果用户请求更深入的分析（仅限深度模式）： -> 生成分析修复任务 -> DISCUSS-002 -> 询问用户 -> 重复 -> 最多 5 轮第 4 阶段（合成器）：Spawn 1 合成器合成尺寸-001 -> 完成 -> 协调员向用户报告 **管道节拍视图**：快速（3 节拍，连续） ------------------------------------------------------ 击败 1 2 3 | | | 探索 -> 分析 -> 合成标准（4 节拍，平行窗口） ------------------------------------------------------ 击败 1 2 3 4 +----- ... ----+ +----- ... ----+ | | E1 || E2 || CN A1 || A2|| AN -> 讨论 -> 合成 +---- 平行 ---+ +---- 平行 ---+ 深度（4+ 节拍，带讨论循环） ------------------------------------------------------ 击败 1 2 3 3a...4 +-...-+ +-...-+ | +-- 循环 --+ | E1||EN A1||AN -> DISC -> A-fix->DISC -> SYNTH （最多 5 轮） **检查点**：触发|地点 |行为 ---|---|--- 讨论轮（深度模式）| DISCUSS-N 完成后 |暂停，询问用户方向/继续讨论循环限制 | >5 轮 |力合成，报价延续管道失速|没有准备+没有运行|检查缺失的任务，报告给用户 **失速检测**（协调器`handleCheck`）：检查 |状况 |分辨率 ---|---|--- 工人反应迟钝 |没有回调的 in_progress 任务 |报告等待任务，建议用户“继续” 管道僵局|没有就绪+没有运行+有待处理|检查blockedBy链，报告堵塞情况讨论循环超出限制 |讨论 > 5 轮 |终止循环，输出最新讨论状态 ## 任务元数据注册表任务 ID |角色 |相|依赖关系 |描述 ---|---|---|---|--- EXPLORE-1..深度 |探险家|探索| （无）|并行代码库探索，每个视角一个 ANALYZE-1..深度|分析师 |分析| EXPLORE-1..深度（全部完成）|并行深度分析，每个视角一个讨论-001 |讨论者 |讨论 | ANALYZE-1..深度（全部完成）|流程分析结果，找出差距分析-修复-N |分析师 |讨论循环 |讨论-N |对特定区域进行重新分析（仅限深度模式）讨论-002..N |讨论者 |讨论循环 |分析-修复-N |后续讨论轮次（深度模式，最多 5 轮）合成-001 |合成器|综合|最后讨论-N |跨视角整合及结论 **动态任务创建**：协调器根据所选视角的数量创建 EXPLORE-1 到 EXPLORE-deep 以及 ANALYZE-1 到 ANALYZE-deep 。讨论循环任务（ANALYZE-fix-N、DISCUSS-002+）是根据用户反馈在深度模式下动态创建的。 ## 协调器生成模板 ### v5 Worker Spawn（所有角色）当协调器生成工作人员时，使用带有角色规范路径的“team-worker”代理。协调器根据选定的视角确定深度（并行代理的数量）。 **阶段 1 - 生成探索者**：并行创建深度探索者团队工作代理（探索 1 到探索深度）。每个接收其分配的视角/域和代理名称以进行任务匹配。 **第 2 阶段 - 生成分析师**：在所有探索者完成后，并行创建深度分析师团队工作代理（ANALYZE-1 到 ANALYZE-deep）。 **第 3 阶段 - 生成讨论者**：所有分析师完成后，创建 1 名讨论者。协调器停止。 **阶段 3a - 讨论循环**（仅限深度模式）：根据用户反馈，协调员可以创建额外的分析修复和讨论任务。 **阶段 4 - 生成合成器**：最后一轮讨论后，创建 1 个合成器。 **快速模式例外**：当深度=1时，生成单个探索者、单个分析师、单个讨论者、单个合成器，不带编号后缀。 **单一生成模板**（用于所有角色的工作模板）：代理({ subagent_type: "团队工作者", 描述：“生成<角色>工人”， team_name: "超分析", 名称：“<代理名称>”， run_in_background：真，提示：`## 角色分配角色：<角色> 角色规范：.claude/skills/team-ultra-analyze/role-specs/<角色>.md 会话：<会话文件夹> session_id: <会话 ID> team_name: 超分析要求：<主题描述> 代理名称：<代理名称> 内循环：假读取 role_spec 文件以加载阶段 2-4 域指令。执行内置第 1 阶段（任务发现，所有者=<代理名称>）-> 角色规范第 2-4 阶段 -> 内置第 5 阶段（报告）。 }) ## 团队配置设置|价值 ---|--- 团队名称|超分析会话目录 | .workflow/.team/UAN-{slug}-{date}/ |分析尺寸|架构、实施、性能、安全、概念、比较、决策 | |最大讨论轮次 | 5 | ## 统一会话目录 .workflow/.team/UAN-{slug}-{YYYY-MM-DD}/ +-- .msg/messages.jsonl # 消息总线日志 +-- .msg/meta.json # 会话元数据 +--discussion.md # 理解演化和讨论时间线 +--explorations/ # 资源管理器输出 | +--探索-001.json | +--探索-002.json +-- analysis/ # 分析师输出 | +-- 分析-001.json | +-- 分析-002.json +-- 讨论/ # 讨论者输出 | +-- 讨论-round-001.json +-- 结论.json # 合成器输出 +-- 智慧/ # 跨任务知识 | +-- 学习.md | +-- 决策.md | +-- 约定.md | +-- issues.md ## 完成动作当管道完成时（所有任务完成，协调器第 5 阶段）：询问用户问题({ 问题：[{ 问题：“Ultra-Analyze 管道已完成。您想做什么？”, 标题：“完成”，多重选择：假，选项：[ { label: "存档和清理（推荐）", description: "存档会话，清理任务和团队资源" }, { label: "Keep Active", description: "保持会话活跃以进行后续工作或检查" }, { label: "导出结果", description: "将可交付成果导出到指定位置，然后清理" } ] }] }) 选择|行动 ---|--- 归档和清理|更新会话状态=“已完成” - > TeamDelete（） - >输出最终摘要保持活跃 |更新会话状态=“暂停”->输出恢复指令：`Skill（skill =“team-ultra-analyze”，args =“resume”）` 导出结果 |向用户询问目标路径 -> 复制可交付成果 -> 存档和清理 ## 会话恢复协调器支持中断会话的“--resume”/“--continue”： 1. 扫描“.workflow/.team/UAN-*/”以查找活动/暂停的会话 2. 多个匹配项 -> AskUserQuestion 进行选择 3. 审核任务列表 -> 协调会话状态与任务状态 4.重置in_progress->pending（中断的任务） 5. 重建团队并仅生成所需的工人 6. 使用正确的blockedBy创建缺失的任务 7. 启动第一个可执行任务 -> 第 4 阶段协调循环 ## 错误处理场景 |分辨率 ---|--- 未知--角色值|可用角色列表错误缺少 --role arg |编排模式->协调者找不到角色文件 |预期路径错误 (roles/{name}/role.md) 任务前缀冲突 |记录警告，继续讨论循环卡住 >5 轮 |力合成，报价延续 CLI 工具不可用 |后备链：gemini -> codex -> 手动分析资源管理器代理失败 |继续使用可用的上下文，注意限制

超分析团队

包含技能