Agent Readiness 评估一项代码库是否给自主编码智能体提供了足够结构，使其能从任务规格推进到实现再到本地验证，而无需人工全程指导。
用途
该技能面向需要判断仓库对自主 AI 智能体工作准备度的场景，输出评分报告，包含成熟度等级与优先行动计划，并覆盖 11 个评估维度。
主要能力
自动化分析（默认）：技能自带 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 分；高风险不变量（迁移、密钥等）已记录；缺失 −1。 维度 3 代码清晰度：严格 TypeScript 或等价静态类型；无则上限 2 分；业务逻辑与框架胶水分离；混合 −1。 维度 4 可搜索性：功能流程可按名称/路由发现；隐藏 −1；生成/第三方代码明确标注；混合 −0.5。 维度 5 本地环境：依赖锁文件已提交；无锁文件上限 2；一键安装脚本；手动 −1。 维度 6 测试：存在单元、集成、E2E 测试；无则上限 1；按面提供聚焦测试命令；仅笼统命令 −0.5。 维度 7 静态验证：配置并记录 linter；无则上限 2；pre-commit 或 CI 钩子强制 lint；缺失 −0.5。 维度 8 构建反馈：存在按包范围的构建命令；仅根目录 −0.5；记录带 HMR 的开发模式；缺失 −1。 维度 9 可调试性：测试产生诊断产物（截图、trace）；无 −1；结构化错误类型；静默错误 −1。 维度 10 安全性：破坏性迁移工作流明确；隐式则上限 3；密钥/环境文件在 .gitignore 中；未忽略上限 2。 维度 11 浏览器自动化：认证绕过避免登录页；手动登录上限 2；稳定选择器（data-testid 或 a11y 角色）；CSS 类 −1。
每个维度起始 3 分，按清单增减，最高 5 分最低 1 分。
评估维度： 1 代码可理解性——强类型、清晰命名、可预测结构 2 上下文与文档——AGENTS.md、README、ADR、内联 WHY 3 可验证性与测试——测试金字塔、类型检查器、linter、CI 门禁 4 开发环境可复现性——一键安装、锁定依赖、容器化服务 5 风格与验证工具——严格 linter、formatter、pre-commit 钩子 6 构建系统——确定性构建、快速反馈、HMR 7 可观测性与可调试性——结构化日志、健康检查、可操作错误 8 安全与治理——分支保护、密钥扫描、CODEOWNERS 9 任务发现与范围界定——issue 模板、验收标准、完成定义 10 规格与规划质量——结构化 PRD、API 契约、可度量成功标准 11 CI/CD 与部署流水线——自动化门禁、staging、回滚文档
成熟度等级：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 3 时，按清单手动为每个维度打 1–5 分，产出包含总体等级、维度表、关键缺口、行动计划和覆盖表的报告，输出格式可参考自动报告。报告交付方面，当有团队制品/文档工具时，将报告持久化为 HTML 文档制品；否则在对话中展示摘要，并说明完整 HTML 路径 /tmp/agent-readiness-report.html。
适用场景与限制
适用于评估仓库对自主智能体工作的准备度，尤其适合需要结构化诊断、成熟度分级与优先改进行动的团队。会话日志分析依赖 .jsonl 格式日志的存在，且路径需符合 ~/.claude/projects/ 等约定；缺少会话日志时仅能进行静态审计。自动化分析需要 Python 3，否则退回手动评分。脚本的权威来源为 supatest-ai/aiden 仓库的 .agents/skills/agent-readiness/scripts/ 目录，技能由 supatest-ai/supa-skills 市场分发。