SuperAPI AI 工具集

bead-completion-audit

营销与增长

查看项目

更新于 10-15 17:29

技能介绍

用途:审计一组已关闭的 bead,逐条判断其是否真正满足了规格与验收标准,输出判定报告,并列出因缺少证据而应重开的事项,纠正「状态已关闭但工作未证实交付」的问题。

主要能力:按标签、epic、负责人或时间窗口界定审计范围;读取每个 bead 的描述与验收标准,将其拆成可核查条目;在代码提交、通过的测试、构建产物、文档章节或命令输出中定位证据面;给出 PASS(每条标准都有可定位证据)、FAIL(证据缺失或与变更矛盾,即虚假关闭)、NEEDS-EVIDENCE(无验收标准或证据无法定位)三类判定;写 compliance-report.md;重开 FAIL 集合并注明缺失证据。

使用方式:在待审计的仓库中执行 br list --status closed --json > /tmp/closed-beads.json 确定范围,运行 bash scripts/validate.sh 自检。逐条用 br show <id> --format json 读取验收标准,用 br comments <id> list 与 br audit log <id> 读取关闭理由(仅视为待验证声明)。定位证据后判定。重开命令示例:br reopen <id> --reason "compliance audit: <criterion> unverified — no <proof>";对 NEEDS-EVIDENCE 用 br comments <id> add 请求补充证据。

适用场景:多人或 swarm 协作下事项被快速关闭、看板数据与实际产品脱节时,对特定范围做可复现的完成度审计,并将系统性失败率交给 post-mortem 分析根因。

限制:审计期间不得静默修改 bead,需先读、写报告,再仅重开 FAIL 集合;无验收标准本身即为发现(NEEDS-EVIDENCE),不得直接放行;审计范围需刻意收窄,全量审计热仓库会产生噪声。依赖 br(beads_rust)与已定义的验收标准,未提供的信息暂未说明。