bug-reporting-excellence

bug-reporting-excellence 技能是一个专门为消除缺陷沟通模糊性而设计的专业质量工程框架。它为工程师、QA 分析师和产品经理提供了一个标准化的公式来记录软件问题，确保开发人员拥有快速修复问题所需的所有上下文。通过执行严格的结构（包括组件识别、精确的环境详细信息、预期与实际行为以及可操作的复现步骤），此技能最大限度地减少了报告团队和开发团队之间的来回沟通。它是建立组织质量标准的必要工具，可以直接集成到您的 CI/CD 反馈循环或问题跟踪系统（如 Jira、GitHub Issues 或 Linear）中。

• 标准化错误公式：强制执行一致的模板（组件、严重性、环境、预期/实际行为、复现步骤），以保证 100% 的可复现性和清晰度。

• 智慧分类与协调：通过 qe-quality-analyzer 代理实现自动错误分类、重复问题检测，并通过 qe-production-intelligence 代理进行根本原因分析。

• 严重性分类：包含从严重（系统宕机、数据丢失）到低级（外观问题）的全面参考卡，确保优先顺序对齐。

• 消除反模式：明确避免不良报告习惯，如模糊的描述或将多个不相关的错误捆绑在一个报告中，强制实现模块化的原子级问题追踪。

• 舰队协调：与更广泛的 agentic-qe 生态系统协调，包括 technical-writing、exploratory-testing-advanced 和 sherlock-review，以简化整个质量工程生命周期。

• 始终提供精确的环境详细信息，例如浏览器版本（Chrome、Firefox、Safari）、操作系统、特定 URL 和唯一的请求 ID，以实现更快的除错。

• 使用提供的标题公式（组件在条件下失败导致影响）以确保在您的项目管理仪表板中的可搜索性和即时识别。

• 附上具体证据，例如 JSON 错误日志、堆栈追踪、控制台输出和屏幕截图，这些是开发人员介入的关键成功因素。

• 当报告生产环境问题时，如果已知，请引用部署版本或特定 PR，以协助识别潜在的回归问题。

• 此技能专为高效率团队设计，鼓励每个报告处理一个错误的做法，防止票据膨胀并确保工程主管能准确追踪进度。