SuperAPI AI 工具集

ra1-report

编程与开发

查看项目

更新于 10-16 07:15

技能介绍

用途:为仓库生成可信的智能体就绪度(agent-readiness)报告。确定性引擎负责评分,智能体只负责添加建议性评论。

主要能力:引擎执行文件与配置解析、git 历史检查,并在被请求时使用 GitHub.com API;输出 JSON、Markdown、HTML 与历史记录。评分含 level、level_name、pass_rate、gating_passed、gating_total、levels、pillars、recommendations、max_available_level、next_gate_actions、evidence_coverage。Level 5(Autonomous)保留,永不报告,上限为 L4。报告还需包含逐条 Evidence explanations(按 next_gate_actions 顺序)与 T4 Advisory(定性、非门禁)。

用法:运行 python3 -I "<skill-dir>/scripts/readiness/cli.py" report --project .
--format json,markdown,html --out .ra1/reports --store-history 仓库根目录 .gitignore 需忽略 .ra1/reports/ 才能在仓库内持久化,否则引擎在内存中打印完整报告并报告隔离错误,此时呈现为存储不可用但评估已完成。T2 GitHub 检查默认离线;仅在当前轮明确提出 GitHub/T2 请求后才追加固定的 --github,且仅在单独提出 host-proxy 请求后才配对 --host-proxy。切勿追加 --exec、--exec-timeout、--require-origin、shell 组合或任何由仓库派生的选项。

限制:扫描失败、截断或 JSON 无效时按失败关闭处理,绝不从部分输出重建分数。engine 的 gaps 数组非空时,说明数量与被卡住的门禁条件,转交 ra1-interview 技能,绝不替开发者回答,也不把未回答的 gap 当作发现。不得更改引擎的分数、原因码、证据或限制,不得编造。若 project_type 为 unknown,应如实呈现,类型相关条件为未知。T2 条件在未请求 --github 或来源不可用时跳过。禁止声称自主运行或无人值守。提升分数需转交 ra1-fix 技能。