执行标准化 Frontend Bugfix 工作流(六阶段流程)
标准化前端 bugfix 流程,基于测试失败执行六阶段修复(分析→编码→测试→审查→验证→总结)。支持分阶段执行和 dry-run 模式。
/plugin marketplace add penkzhou/swiss-army-knife-plugin/plugin install swiss-army-knife@swiss-army-knife-plugin[--phase=0,1,2,3,4,5|all] [--dry-run] [--log] [--verbose]基于测试失败的前端用例,执行标准化 bugfix 流程。
宣布:"我正在使用 Bugfix Frontend v3.0 工作流进行问题修复。"
从用户输入中解析参数:
| 参数 | 必填 | 默认值 | 说明 |
|---|---|---|---|
--phase=X,Y | 否 | all | 指定执行阶段 |
--dry-run | 否 | false | 只分析不执行修改 |
--log | 否 | false | 启用过程日志(INFO 级别) |
--verbose | 否 | false | 启用详细日志(DEBUG 级别,隐含 --log) |
--log:记录 Phase/Agent 事件、置信度决策、用户交互--verbose:额外记录完整的 agent 输入输出(文件可能较大).claude/logs/swiss-army-knife/bugfix/.jsonl(程序查询)和 .log(人类阅读)使用 Task tool 调用 bugfix-master-coordinator agent:
使用 bugfix-master-coordinator agent 执行前端 bugfix 工作流:
输入
{ "stack": "frontend", "test_output": "{用户提供的测试输出,如有}", "args": { "dry_run": {--dry-run 解析结果}, "phase": "{--phase 解析结果或 'all'}" }, "logging": { "enabled": {--log 或 --verbose 解析结果,true/false}, "level": "{--verbose 时为 'debug',--log 时为 'info'}", "session_id": "{生成 8 位随机字符串,如 'a1b2c3d4'}" } }
使用以下方法生成 8 位随机 ID:
cat /dev/urandom | LC_ALL=C tr -dc 'a-z0-9' | head -c 8
在处理返回前,必须验证 Task 工具调用是否成功:
如果 Task 工具调用失败(网络错误、agent 未找到、超时),展示错误并停止:
错误:协调器调用失败
原因: {错误消息}
建议:
1. 检查网络连接
2. 确认插件已正确安装
3. 重试命令
检查响应是否为有效 JSON 且包含 status 字段:
status 字段status 必须是 success|partial|failed|user_cancelled|dry_run_complete 之一验证失败处理:
错误:协调器响应格式无效
收到的响应: {原始响应前 200 字符}
建议:
1. 重试命令
2. 如果问题持续,请报告此错误
停止,不继续处理无效响应。
协调器返回标准 JSON 格式,根据 status 字段处理:
| status | 处理方式 |
|---|---|
success | 展示成功报告,流程完成 |
partial | 展示部分成功报告,列出剩余 Review 问题 |
failed | 展示错误详情,建议修复方案 |
user_cancelled | 确认用户取消,展示已完成工作 |
dry_run_complete | 展示分析报告,不实际执行 |
从协调器返回中提取关键信息:
=== Frontend Bugfix 完成 ===
状态: {status}
修复结果:
- 根因: {root_cause_analysis.root_cause.description}
- 置信度: {root_cause_analysis.confidence.score}%
- 变更文件: {execution_results.changed_files}
Review 结果:
- 发现问题: {review_results.summary.initial_issues}
- 已修复: {review_results.summary.fixed_issues}
验证状态:
- 测试: {execution_results.verification.tests}
- Lint: {execution_results.verification.lint}
- 类型检查: {execution_results.verification.typecheck}