用途:用于受理并调查一个已上报的缺陷(常见输入为截图),产出是已登记的缺陷工单,而不是代码改动。核心原则是证据优于假设、结论前先穷尽搜索、一个缺陷一张工单。
主要能力与流程:一,截图/症状受理,读取图像、逐字 OCR 错误文本、记录环境与观察值与期望值。二,自动探测并确认追踪系统(GitHub、GitLab、Linear),依据 git remote、gh auth status、.gitlab-ci.yml、LINEAR_API_KEY 等信号。三,穷尽式仓库调查,从截图锚定 grep、追踪渲染组件到数据层的调用路径、可行时本地复现、用 git log -p --follow 与 git blame 定位回归提交。四,穷尽式在线调研,检索确切的错误字符串、检查上游缺陷与更新日志、对照官方文档、比较 2–3 种修复方案的取舍并附来源 URL。五,合成报告,含严重级别(S1–S4)、复现步骤、带 Verify 方法的验收标准、根因(须有 file:line 引用)与推荐修复。六,在追踪系统登记。七,返回链接与摘要。
必要用法:文件创建以 GitHub 为例,先建立标签 gh label create "type:bug" --color B60205 2>/dev/null || true,再执行 gh issue create --title "[W-XXXXXX] BUG: <short symptom>" --body-file /tmp/bug-W-XXXXXX.md --label "type:bug,severity:S2,priority:P1";GitLab 使用 glab issue create --title ... --description "$(cat /tmp/bug-W-XXXXXX.md)" --label "type::bug,severity::S2,priority::P1";Linear 走 arc-linear-issue-creator 的 issueCreate。截图附件:GitHub 可将图片提交至 docs/bugs 并在正文引用,或经 gh api 上传;GitLab 走 POST /projects/:id/uploads;Linear 用 fileUpload mutation。
适用场景:需要从截图或描述出发、在现有追踪系统中形成根因清晰、可验收的缺陷工单时。
限制:该技能只调查与登记,不改产品代码;无 file:line 引用不得给出根因,无 URL 不得作外部断言;每个工单只含一个缺陷,登记前须查重;编号与标签须沿用仓库既有约定;不得提交或泄露 LINEAR_API_KEY、GITLAB_TOKEN 等令牌。其余费用、价格等信息暂未提供。