用途:评估 git 仓库对 AI 编码智能体的就绪程度,并逐项修复评估中发现的差距。依赖 uvx,需先确认 uvx --version 可用,否则停止。
主要能力:通过 uvx --from git+https://github.com/ambient-code/agentready agentready -- assess -o "$REPORT_DIR" <path> 运行评估,解析 assessment-latest.json,提取总分、认证等级与各项 findings(含 tier、权重、状态、证据、修复建议)。支持单仓库与批量模式;批量模式会查找指定目录下的 git 仓库,仅评估远程 URL 与 rhdh-repos.md 匹配的 RHDH 仓库。
使用方式:先选择模式,校验路径为 git 仓库,检测远程 URL 是否匹配 RHDH 仓库清单(文件不存在则静默降级为通用评估)。评估后展示摘要,用户可选择 auto 或 review 模式逐项处理失败项,按 tier 升序、权重降序排序。agent_instructions 项会内联生成 AGENTS.md 与 CLAUDE.md(CLAUDE.md 内容为 @AGENTS.md),扫描 package.json、Makefile、pyproject.toml、GitHub workflows 等获取命令。修复后重新评估并展示前后对比。
适用场景:需要让仓库更适配 AI 编码智能体的团队,尤其是 RHDH 相关仓库。
限制:首次 uvx 运行需从 GitHub 拉取并构建,可能耗时 30–60 秒;报告须输出到临时目录,避免污染工作树;ADR 与设计意图类发现不自动修复,需人工提供理由,不得编造;批量模式仅评估匹配清单的仓库;rhdh-repos.md 默认路径为 ~/.claude/skills/rhdh/references/rhdh-repos.md,路径不符时静默降级。