SuperAPI AI 工具集

acreadiness-policy

智能体与模型

查看项目

更新于 10-15 21:52

技能介绍

用途:当用户询问策略、严格模式、自定义评分、禁用检查、组织标准或就绪度 CI 门禁时使用本技能。策略是一个小型 JSON 文件,含 criteria、extras、thresholds 三个可选部分,用于自定义 AgentRC 的就绪度评分。

主要能力:内置三个示例策略(examples/policies/):strict.json(100% 通过率,提高关键标准影响)、ai-only.json(禁用全部仓库健康检查,聚焦 AI 工具)、repo-health-only.json(禁用 AI 检查,聚焦传统质量),建议作为自定义策略的起点。策略 schema 支持 criteria.disable、criteria.override(如 impact、level、title)、extras.disable、thresholds.passRate。影响权重:critical 5、high 4、medium 3、low 2、info 0;得分 = 1 −(扣分 / 最大可能权重),等级 A≥0.9、B≥0.8、C≥0.7、D≥0.6、F<0.6。

使用方式:子命令 show 列出当前生效策略;new <name> 生成 policies/<name>.json 默认模板,并引导选择禁用项、提升项与通过率阈值(常见基线 0.7 宽松、0.85 标准、1.0 严格),再在 agentrc.config.json 中以 {"policies": ["./policies/<name>.json"]} 引用;apply <path-or-pkg> 运行 agentrc readiness --json --policy <source> 并重新渲染报告,支持链式:npx -y github:microsoft/agentrc readiness --json --policy ./org-baseline.json,./team-frontend.json。CI 门禁可结合 --fail-level,例如:npx -y github:microsoft/agentrc readiness --policy ./policies/strict.json --fail-level 3。

限制:JSON 策略只能禁用、覆盖和设置阈值,不能新增标准;需要新检测逻辑时应使用 AgentRC 的 TypeScript 插件系统(docs/dev/plugins.md)。操作规则:不要静默禁用某个支柱,需确认并说明取舍;优先覆盖影响而非禁用;建议保留 extras 启用(不影响得分);建议分层,即基线策略加团队覆盖并用 --policy a.json,b.json 链式组合。