Prompt file imported from zls3434/Software-Engineering-Studios (
.windsurf/workflows/bug-report.md). Copyright stays with the author.
/bug-report — 创建结构化 Bug 报告技能。收集复现步骤、环境信息、预期与实际行为，生成符合项目模板的 Bug 报告文件并登记到 Bug 列表。
触发方式
在 Cascade 对话框中输入 /bug-report 触发此工作流。
工作流内容
bug-report —— 结构化 Bug 报告技能
技能目的
将用户描述的缺陷现象转化为结构化、可追溯的 Bug 报告，
确保复现步骤、环境信息、预期与实际行为齐备，并登记到项目 Bug 列表，
便于后续分流（/bug-triage）与修复跟踪。本技能是缺陷流程的入口环节。
参数说明
[Bug 标题或现象简述]：用户对缺陷的简要描述，例如"登录后页面白屏"。 技能将以此为基础通过交互补全其余字段。
分阶段工作流
阶段 1：收集基础信息
- 输入：用户提供的现象简述。
- 处理：使用 AskUserQuestion 询问关键要素：出现模块、影响范围、首次发现时间、是否可稳定复现。
- 输出：Bug 基础信息草稿（标题、模块、严重度初判）。
阶段 2：定位相关代码与上下文
- 输入：阶段 1 的模块与现象。
- 处理：使用 Grep 在源码与
docs/stories/中检索相关模块与近期变更；使用 Read 读取疑似代码片段。 - 输出：相关代码线索与近期 Story 变更清单。
阶段 3：补全报告字段
- 输入：阶段 1-2 的信息。
- 处理：通过 AskUserQuestion 补全：
- 复现步骤（编号列表）
- 预期行为
- 实际行为
- 环境信息（浏览器/OS/版本/账号角色）
- 截图或日志引用（如有）
- 输出：完整 Bug 报告草稿。
阶段 4：生成报告文件
- 输入：阶段 3 的完整草稿。
- 处理：使用 Write 按
docs/bugs/BUG-<编号>.md模板生成报告文件；编号取docs/bugs/下最大编号 +1。 - 输出：Bug 报告文件路径与编号。
阶段 5：登记到 Bug 列表
- 输入：阶段 4 的编号与摘要。
- 处理：使用 Read 读取
docs/bugs/BUG-LIST.md，追加一行登记；若文件不存在则创建。 - 输出：确认登记完成，并提示用户下一步。
协作协议引用
- 写入 Bug 报告与列表前必须询问用户："我可以将 Bug 报告写入 [路径] 吗？"
- 严重度初判仅作建议，最终分级由
/bug-triage或用户确认。 - 不得自主修复缺陷，仅完成报告与登记。
推荐下一步
- 报告生成后运行
/bug-triage对未解决 Bug 重新排序。 - 若 Bug 需紧急修复，运行
/hotfix [Bug 编号]。 - 若 Bug 与某 Story 验收标准相关，运行
/story-done [故事路径]复核。