用途:分析智能体团队(agent team)会话导出,对照 Claude Code 官方 agent teams 最佳实践,产出结构化报告,含适用性判定、评分卡、可执行建议和改进后的提示词重写。核心原则是每条建议都必须引用官方文档中的具体最佳实践,并引用会话中的具体证据,不做模糊评价。
适用场景:用户提供团队会话导出并希望获得反馈;询问如何改进 agent team 用法;想判断某任务是否适合用 agent team;或在运行后复盘下次如何调整。不适用于分析单人(非团队)Claude Code 会话,也不适用于与 agent team 无关的通用 Claude Code 使用建议。
前提:需要 markdown 格式的会话导出,可用 agent-teams:view-team-session 技能从会话 ID 生成。
工作流程:先读取完整会话导出(过大时分块读取),提取团队名与会话 ID、时长与智能体列表、原始用户提示词、团队结构(lead 与 teammates 及角色、所用模型)、任务列表(TaskCreate/TaskUpdate 调用)、沟通流(SendMessage 私信与广播)、工具调用、质量门(计划审批、TaskCompleted 与 TeammateIdle 钩子)、最终产出。随后获取官方文档:先用 WebSearch 搜索 "Claude Code agent teams best practices site:code.claude.com" 发现当前 URL,再用 WebFetch 抓取,或回退到 https://code.claude.com/docs/en/agent-teams;并抓取 https://code.claude.com/docs/en/costs 中的 "Agent team token costs" 与 "Manage agent team costs" 章节。若搜索与抓取均失败,需告知用户缺少官方文档无法分析。接着按 references/rubric.md 的 10 个类别逐项评级(Gap/Partial/Strong),引用会话证据并对应官方最佳实践。最后将报告保存到 .claude/output/<team-name>-analysis.md,结构包含适用性判定、摘要评分表、按影响排序的 3-5 条建议、改进后的提示词、以及 10 类详细评分卡;完成后告知保存位置并给出 2-3 句关键发现总结。
限制与注意:评级必须引用具体证据,避免模糊评级;适用性判定要直接诚实,不适合就明说;建议要具体可执行;改进提示词需完整可直接复制使用;若会话未使用任务依赖、质量门或计划审批,应说明这些是否会有帮助。具体安装命令与价格信息暂未提供。