Agent Readiness 用于评估一个代码仓库是否为自主编码代理提供了足够结构，使代理能够在没有人类手把手指导的情况下，将任务从规格推进到实现再到本地验证。
用途：评估代码库对自主 AI 代理工作的准备程度，并给出评分报告与改进建议。
主要能力：
一、自动化分析（默认）。该技能在 scripts/ 目录下附带分析脚本。若系统有 Python 3，可使用组合运行器执行完整评估（含会话日志模式分析），命令为：
python3 scripts/run_readiness_check.py
--sessions-dir ~/.claude/projects/PROJECT-NAME
--repo .
也可仅做静态审计（无需会话日志，速度最快），命令为：
python3 scripts/run_readiness_check.py
--repo .
--skip-sessions
--output /tmp/agent-readiness-report.html
输出为 HTML 报告，路径在 /tmp/agent-readiness-report.html，包含成熟度等级、维度分数、失败模式、关键缺口和优先级行动计划。
二、会话日志分析。当存在会话日志（来自 Claude Code、Codex、Cursor 等，以 .jsonl 文件形式存放在 ~/.claude/projects/）时，分析器可检测：分类分布（仅研究、仅验证、受阻、任务完成者等）；失败最多的工具与命令；反复出现的失败模式（浏览器鉴权、测试失败、MCP schema 问题等）；编辑后验证率；以及选定会话的简明定性摘要。可使用 --max-sessions N 在迭代时缩小样本量。分析器按文件哈希缓存解析结果，因此重复运行几乎瞬间完成。
三、评分检查表（手动评分或验证自动化输出时使用）：
| 维度 | 主题 | 检查项 | 缺失影响 |
|---|---|---|---|
| 1 | 规格清晰度 | 结构化模板含验收标准、边界情况、非目标 | 无模板 → 上限 3 |
| 2 | 代理指令 | 根目录 AGENTS.md 含技术栈、路径、命令 | 无 → 上限 2 |
| 2 | 代理指令 | 高风险不变量已记录（迁移、密钥等） | 缺失 → −1 |
| 3 | 代码清晰度 | 严格 TypeScript 或等效静态类型 | 无 → 上限 2 |
| 3 | 代码清晰度 | 业务逻辑与框架胶水分离 | 混合 → −1 |
| 4 | 可搜索性 | 功能流程可按名称/路由发现 | 隐藏 → −1 |
| 4 | 可搜索性 | 生成/第三方代码清晰标记 | 混合 → −0.5 |
| 5 | 本地环境 | 依赖锁文件已提交 | 无锁文件 → 上限 2 |
| 5 | 本地环境 | 一键安装脚本 | 手动 → −1 |
| 6 | 测试 | 存在单元 + 集成 + E2E 测试 | 无 → 上限 1 |
| 6 | 测试 | 按表面划分的聚焦测试命令 | 仅笼统 → −0.5 |
| 7 | 静态验证 | 已配置并记录 linter | 无 → 上限 2 |
| 7 | 静态验证 | pre-commit 或 CI 钩子执行 lint | 缺失 → −0.5 |
| 8 | 构建反馈 | 存在包级构建命令 | 仅根级 → −0.5 |
| 8 | 构建反馈 | 已记录带 HMR 的开发模式 | 缺失 → −1 |
| 9 | 可调试性 | 测试产生诊断产物（截图、跟踪） | 无 → −1 |
| 9 | 可调试性 | 结构化错误类型 | 静默错误 → −1 |
| 10 | 安全性 | 破坏性迁移工作流明确 | 隐式 → 上限 3 |
| 10 | 安全性 | 密钥/环境文件在 .gitignore 中 | 未忽略 → 上限 2 |
| 11 | 浏览器自动化 | 鉴权绕过，避免登录页 | 手动登录 → 上限 2 |
| 11 | 浏览器自动化 | 稳定选择器（data-testid 或 a11y 角色） | CSS 类 → −1 |
每个维度从 3 分起步，按检查表上下调整，最高 5 分，最低 1 分。
评估的 11 个维度：1. 代码可理解性——强类型、清晰命名、可预测结构；2. 上下文与文档——AGENTS.md、README、ADR、内联 WHY；3. 可验证性与测试——测试金字塔、类型检查器、linter、CI 门禁；4. 开发环境可复现性——一键安装、锁定依赖、容器化服务；5. 风格与验证工具——严格 linter、格式化器、pre-commit 钩子；6. 构建系统——确定性构建、快速反馈、HMR；7. 可观测性与可调试性——结构化日志、健康检查、可操作错误；8. 安全与治理——分支保护、密钥扫描、CODEOWNERS；9. 任务发现与范围界定——issue 模板、验收标准、完成定义；10. 规格与规划质量——结构化 PRD、API 契约、可度量成功标准；11. CI/CD 与部署流水线——自动化门禁、预发环境、回滚文档。
成熟度等级：Fragile（<2.0）——仅可探索，需要大量监督；Documented（2.0–2.9）——小改动，需密切审查；Standardized（3.0–3.9）——范围明确的任务，本地验证；Optimized（4.0–4.4）——复杂多文件任务，轻度审查；Autonomous（4.5+）——从规格到经过测试的实现，战略性监督。
使用方式：
一、自动化模式：使用上文 Python 3 命令运行，生成 HTML 报告。
二、手动模式（无 Python）：当没有 Python 3 时，使用上述检查表手动为每个维度评 1–5 分。生成报告应包含：总体等级、维度表、关键缺口、行动计划、覆盖表。可参考自动化报告的输出格式。
三、报告交付：当团队有 artifact/文档工具时，将报告持久化为 HTML 文档 artifact；否则在聊天中显示摘要，并注明完整 HTML 路径 /tmp/agent-readiness-report.html。
适用场景：适用于希望引入自主编码代理的团队，在代理接管任务前评估代码库的准备情况；也适用于迭代改进仓库结构，使其逐步达到更高成熟度。
限制：手动模式无 Python 时需依照检查表自行评分；会话日志分析依赖存在 .jsonl 日志文件；本技能随 supatest-ai/supa-skills 市场分发，脚本的权威来源是 supatest-ai/aiden 仓库 .agents/skills/agent-readiness/scripts/ 目录。评分细节与阈值以资料中给出的检查表和成熟度表为准，未提供其他收费、平台或效果信息。