用途:把单个新提交的 Patrol issue 快速整理成人类可立即行动的建议,只做猜测与归纳,最终由人决定。输出是“已确认事实”与“推测”分离的紧凑摘要,不写长篇大论。
主要能力:编排流程加一份常见问题目录(references/common-issues.md,每次运行都要读),据此无需重读大量历史 issue 即可分诊。判定类别包括 Patrol bug、用户问题、信息不足、功能请求、文档缺失、重复、超出范围/wontfix。
硬性规则:只读,不评论、不加标签、不关闭、不编辑 issue;只产出建议和可选的可粘贴回复。不猜测版本或事实,缺失即视为发现(通常归为“信息不足”)。复现优于理论:在 Patrol 自带 dev/e2e_app 中可复现是“Patrol bug”的最强证据,仅在报告者项目出问题则是“用户问题”的最强证据;无设备复现(patrol_finders widget 测试、纯 CLI 场景)成本低,应在分诊时直接运行。
运行环境:本地可复现(构建/运行 dev/e2e_app、启动模拟器),当能翻转结论时应复现;CI 上无设备/模拟器/Xcode,无法验证设备、构建或平台相关行为,应说明并降低置信度,建议“本地复现”,但无设备复现仍可在 CI 运行。
流程:完整阅读 issue 及评论(gh issue view <n> --repo leancodepl/patrol --comments,若为空改用 --json body,comments,labels,author);提取事实网格(版本、patrol doctor、设备/模拟器与 OS/API、平台、命令、错误、是否有最小复现仓库);先匹配目录;无命中则用决策信号;用 gh issue list --repo leancodepl/patrol --state all --search "<关键错误短语>" 查重;成本低且决定性时本地验证;按指定格式输出。
输出格式:标题、Verdict(主判定与置信度,可含次判定)、Why 一句话、Confirmed(仅 issue 明述事实)、Assessment(推测与目录匹配)、Missing/会确认它的材料、Duplicate of、建议动作(标签、本地复现/关闭为重复/可粘贴回复)、可选草稿回复(不要发布)。规则:Confirmed 与 Assessment 不得混淆;引用比较过的 issue 编号;CI 运行时加一行说明;无前言、不冗长复述。
限制:不执行任何写操作;不编造版本或事实;目录只收录反复出现的模式,一次性边缘情况仅标注“catalog candidate”,不扩充目录。