team-frontend-debug

前端调试团队

双模式前端调试：通过 Chrome DevTools MCP 进行功能清单测试或错误描述调试。

架构

Skill(skill="team-frontend-debug", args="feature list or bug description")
                    |
         SKILL.md (this file) = Router
                    |
     +--------------+--------------+
     |                             |
  no --role flag              --role <name>
     |                             |
  Coordinator                  Worker
  roles/coordinator/role.md    roles/<name>/role.md
     |
     +-- analyze input → select pipeline → dispatch → spawn → STOP
                                    |
         ┌──────────────────────────┼──────────────────────┐
         v                         v                       v
    [test-pipeline]          [debug-pipeline]          [shared]
     tester(DevTools)        reproducer(DevTools)      analyzer
                                                       fixer
                                                       verifier

流水线模式

输入	流水线	流程
功能清单 / 功能清单	test-pipeline	TEST → ANALYZE → FIX → VERIFY
错误描述 / 错误描述	debug-pipeline	REPRODUCE → ANALYZE → FIX → VERIFY

角色注册表

角色	路径	前缀	内循环
协调器	roles/coordinator/role.md	—	—
测试员	roles/tester/role.md	TEST-*	true
复现员	roles/reproducer/role.md	REPRODUCE-*	false
分析员	roles/analyzer/role.md	ANALYZE-*	false
修复员	roles/fixer/role.md	FIX-*	true
验证员	roles/verifier/role.md	VERIFY-*	false

角色路由器

解析 $ARGUMENTS：

• 包含 --role <name> → 读取 roles/<name>/role.md，执行 Phase 2-4
• 不包含 --role → @roles/coordinator/role.md，执行入口路由器

共享常量

• 会话前缀：TFD
• 会话路径：.workflow/.team/TFD-<slug>-<date>/
• CLI 工具：ccw cli --mode analysis（只读）、ccw cli --mode write（修改）
• 消息总线：mcp__ccw-tools__team_msg(session_id=<session-id>, ...)

工作区路径解析

协调器 MUST 在 TeamCreate 之前的 Phase 2 解析路径：

1. 运行 Bash({ command: "pwd" }) → 获取 project_root（绝对路径）
2. skill_root = <project_root>/.claude/skills/team-frontend-debug
3. 存储到 team-session.json：

   { "project_root": "/abs/path/to/project", "skill_root": "/abs/path/to/skill" }
   

4. 所有工作器的 role_spec 值 MUST 使用 <skill_root>/roles/<role>/role.md（绝对路径）

这样可确保以 run_in_background: true 生成的工作器始终获得绝对且可解析的路径，无论其工作目录为何。

Chrome DevTools MCP 工具

所有浏览器检查操作均使用 Chrome DevTools MCP。复现员和验证员是主要使用者。

工具	用途
mcp__chrome-devtools__navigate_page	导航至目标 URL
mcp__chrome-devtools__take_screenshot	捕获视觉状态
mcp__chrome-devtools__take_snapshot	捕获 DOM/a11y 树
mcp__chrome-devtools__list_console_messages	读取控制台日志
mcp__chrome-devtools__get_console_message	获取特定控制台消息
mcp__chrome-devtools__list_network_requests	监控网络活动
mcp__chrome-devtools__get_network_request	检查请求/响应详情
mcp__chrome-devtools__performance_start_trace	开始性能录制
mcp__chrome-devtools__performance_stop_trace	停止并分析跟踪记录
mcp__chrome-devtools__click	模拟用户点击
mcp__chrome-devtools__fill	填写表单输入项
mcp__chrome-devtools__hover	悬停在元素上
mcp__chrome-devtools__evaluate_script	在页面中执行 JavaScript
mcp__chrome-devtools__wait_for	等待元素/文本
mcp__chrome-devtools__list_pages	列出已打开的浏览器标签页
mcp__chrome-devtools__select_page	切换活动标签页

工作器生成模板

协调器使用以下模板生成工作器：

Agent({
  subagent_type: "team-worker",
  description: "Spawn <role> worker",
  team_name: <team-name>,
  name: "<role>",
  run_in_background: true,
  prompt: `## Role Assignment
role: <role>
role_spec: <skill_root>/roles/<role>/role.md
session: <session-folder>
session_id: <session-id>
team_name: <team-name>
requirement: <task-description>
inner_loop: <true|false>

## Progress Milestones
session_id: <session-id>
Report progress via team_msg at natural phase boundaries (context loaded -> core work done -> verification).
Report blockers immediately via team_msg type="blocker".
Report completion via team_msg type="task_complete" after final SendMessage.

Read role_spec file (@<skill_root>/roles/<role>/role.md) to load Phase 2-4 domain instructions.
Execute built-in Phase 1 (task discovery) -> role Phase 2-4 -> built-in Phase 5 (report).`
})

用户命令

命令	操作
check / status	查看执行状态图
resume / continue	前进至下一步
revise <TASK-ID> [feedback]	修改指定任务
feedback <text>	注入反馈以进行修改
retry <TASK-ID>	重新运行失败的任务

完成操作

流水线完成后，协调器会展示：

AskUserQuestion({
  questions: [{
    question: "Pipeline complete. What would you like to do?",
    header: "Completion",
    multiSelect: false,
    options: [
      { label: "Archive & Clean (Recommended)", description: "Archive session, clean up team" },
      { label: "Keep Active", description: "Keep session for follow-up debugging" },
      { label: "Export Results", description: "Export debug report and patches" }
    ]
  }]
})

规格参考

• specs/pipelines.md — 流水线定义和任务注册表
• specs/debug-tools.md — Chrome DevTools MCP 使用模式和证据收集

会话目录

.workflow/.team/TFD-<slug>-<date>/
├── team-session.json           # Session state + role registry
├── evidence/                   # Screenshots, snapshots, network logs
├── artifacts/                  # Test reports, RCA reports, patches, verification reports
├── wisdom/                     # Cross-task debug knowledge
└── .msg/                       # Team message bus

错误处理

场景	解决方案
所有功能测试均通过	报告成功，流水线无需执行 ANALYZE/FIX/VERIFY 即可完成
无法复现 Bug	复现器报告失败，协调器请求用户提供更多详情
浏览器不可用	报告错误，并建议手动复现步骤
分析无法得出结论	分析器通过迭代循环请求更多证据
修复引入回归问题	验证器报告失败，协调器分派重新修复任务
测试中未发现问题	跳过后续任务，报告全部通过
未知命令	报错并列出可用命令
未找到角色	报错并显示角色注册表