SuperAPI AI 工具集

agent-readiness

智能体与模型

查看项目

更新于 10-16 08:46

技能介绍

用途:评估代码仓库是否适合交由自主 AI 智能体(pylot workers)工作,输出 0–10 分的 Agent Readiness Report,并作为 GitHub issue 提交到被评估仓库。安装命令:npx skills add fellowship-dev/dogfooded-skills/skills/ops/agent-readiness。

输入:$1 为要评估的 org/repo(必填);$2 为 pylot 团队名(可选,提供后才启用 Pylot Wiring 维度检查)。

主要能力:以只读方式浅克隆仓库(git clone --depth 50),对 8 个维度打分——环境可复现性(.devcontainer/Dockerfile、锁文件、固定运行时、安装命令)、测试可信度(测试文件与命令、无凭证可跑、通过/失败/不稳定数量)、智能体上下文(CLAUDE.md/AGENTS.md、README、架构文档)、CI/CD、任务就绪度(开放 issue 数量与正文长度、标签、模板)、密钥卫生(.env.example、是否提交密钥)、Pylot wiring(需 $2,探测组织 skills home)、代码健康快检(lint 配置、最大文件 LOC、TODO 密度、依赖落后情况)。每项检查需给出文件或命令证据,不可编造;无法运行则说明并保守计分。

计分与分级:总体分为加权平均(环境 20%、测试 25%、上下文 15%、CI 10%、任务 10%、密钥 10%、wiring 5%、健康 5%;无团队参数时 wiring 的 5% 转给测试)。分级:8.0+ READY,6.0–7.9 NEARLY READY,4.0–5.9 NEEDS WORK,<4.0 NOT READY。列出 3–7 项最高 ROI 修复,按(分数影响÷工作量)排序,并标注 S/M/L 工作量。

使用方式:运行后按标题查找既有开放 issue 并更新,否则新建,正文含分数表、优先修复清单、当前可安全派发的任务类型等。

限制:仅对报告 issue 有一次写入,仓库保持只读(不推送、不开 PR、不改代码);不打印令牌;安装/测试在 /tmp 克隆内进行,每次 10 分钟预算,超时记为证据并继续;克隆失败则不提交 issue。