用途:当用户要求为 agent-validator 的疑似缺陷提交、报告或开启 issue 时,validator-issue 负责整理并生成结构化的 GitHub bug 报告。
主要能力:支持自动提交模式;可读取配置与日志证据;按固定结构起草 issue(问题、复现步骤、预期与实际、证据);提交前展示完整预览并等待确认;通过 gh issue create 提交到 Codagent-AI/agent-validator 仓库。
使用方式:调用 /validator-issue。若参数以 --auto-file 开头,则开启自动提交模式并跳过确认步骤,其余文本作为 bug 描述;若参数为空,会询问用户描述 bug。随后读取 .validator/config.yml 解析 log_dir(默认 validator_logs),收集配置、调试日志最后 50 行(tail -n 50 <log_dir>/.debug.log)和执行状态等证据,缺失文件不视为失败。起草 issue 时需对令牌、API 密钥、邮箱和绝对本地路径等敏感值进行脱敏,替换为 [REDACTED] 或通用占位符。非自动模式下展示标题与正文并询问是否提交;确认后写入临时文件并通过 --body-file 提交,最后报告 issue URL。
适用场景:为 agent-validator 报告疑似缺陷、需要附带运行证据的结构化 issue。
限制:仅面向 Codagent-AI/agent-validator 仓库;依赖 gh 命令与本地日志文件;证据缺失时仍可继续但需注明;自动提交模式不会请求确认。