用途：agent-ready 是 codebase-readiness 的修复配套技能，不负责评分，而是实际搭建让 AI 智能体易于理解的文档与结构产物。
主要能力：支持多种模式。scaffold 做完整文档搭建；architecture 生成 ARCHITECTURE.md（含代码地图、不变量、依赖规则）；agents-md 新建或重构 AGENTS.md（渐进式披露入口）；quality-gates 安装回归感知的质量门禁；migrate 升级旧脚手架；audit 检查现有产物。启动时会检查项目根目录是否存在 AGENT_READY_ASSESSMENT.md，若存在则读取各维度评分，按最弱项推荐模式（文档与上下文<50 建议 agents-md，架构清晰度<50 建议 architecture，两者都<50 建议 scaffold，质量门禁处于 L0-L2 建议 quality-gates）；不存在则按用户意图判断模式，意图不明时询问。
使用方式：选定模式后，技能会先读取推荐技能清单并检查仓库框架信号，匹配时询问是否安装推荐或可选技能，需明确确认后才从仓库根目录安装（命令不带 --global 以保留项目范围）。scaffold 模式依次做侦察、汇报文档清单、创建 docs/ 结构、生成 ARCHITECTURE.md、docs/DOMAIN.md、AGENTS.md，并安装质量门禁；其中会复制 assets/docs-check.py、docs-check-ci-template.yml 等资源并 chmod +x。
适用场景：为代码库补充面向智能体的文档、架构说明、领域文档和回归门禁。
限制：不做评分；不在未经确认时自动安装技能或自动调用其他工作流；不为凑结构凭空创建 CONTEXT.md、docs/adr/ 或术语表；质量门禁基线需人工审阅后才创建，未创建基线时 check 会失败。具体收费与价格资料暂未提供。