用途:当用户报告 bug、想提交 issue、记录缺陷或需要写规范 bug 报告时,按固定工作流生成一份开发者可直接复现、定位和修复的结构化报告。
主要能力:读取项目上下文(检查 .chalk/docs/ 中的架构文档、历史 bug 报告、已知问题和版本信息),从 $ARGUMENTS 与对话中提取现象、期望、发生时间、复现频率、报错日志;必要时向用户追问缺失信息。按严重程度矩阵(Critical/High/Medium/Low)定级,给出 bisect 线索(最后正常版本、首次出错版本、疑似原因),检查重复与相关 issue。
使用方式:报告写入 .chalk/docs/engineering/<n>bug<snake_case_slug>.md,或按需格式化为 GitHub issue。文件名取现有 bug 文件的最大编号加 1。报告含标题、严重程度、状态、组件、报告人、环境表、摘要、复现步骤(含前置条件与复现率)、预期行为、实际行为、错误输出、截图、bisect 线索、影响评估、相关 issue 等章节。
适用场景:Web/移动/后端缺陷记录、缺陷跟踪、issue 归档,以及复现步骤不规范时的补全。
限制:依赖用户提供足够信息,缺失的必填项(标题、环境、复现步骤、预期/实际行为、严重程度)需追问后才定稿;错误输出和 bisect 线索为可选;文档未说明支持的具体平台或集成范围。