用途：在编码智能体中完成 Qodo 的初始化配置，包括确认可用路径、连接账号与验证工具访问。技能安装本身并不证明账号或工具已可用。
适用场景：插件安装之后、收到设置请求时，或某个 Qodo 技能发现运行环境未就绪时调用。前置条件是具备用于 CLI 配置的 shell，或一个已连接宿主的 QAR MCP 服务器；全程不得处理凭据。
MCP 路径：检查已连接的 QAR 工具 schema 与注解，用无害输入调用一个只读工具；能列出工具并不证明具有读取权限。先看 isError 再看 structuredContent，执行错误不等于就绪。读取权限无法证明写入授权，写入须在用户授权操作前标记为未验证，且绝不进行测试性写入。宿主与 QAR 负责 MCP 鉴权；缺失工具、MT-AUTH-FORBIDDEN 和连接错误应报告为 MCP 访问问题，绝不索取 API key。仅 MCP 配置时，报告已验证范围后即交接，跳过所有 CLI 步骤。
CLI 路径：仅当请求 CLI 访问或本地收集需要时继续，并使用同一部署。先定位或安装运行时：POSIX 下探测 qodo --version，若缺失尝试 "${QODO_HOME:-$HOME/.qodo}/bin/qodo" --version；PowerShell 下先按 runtime.md 解析已验证的调用方式。缺失、过旧或无法解析时按参考文档处理。需 Qodo CLI 1.6.0 或更新版本才能认证。
连接：运行 <qodo> read whoami --json --skill qodo-setup --skill-version 1.0.10 --distribution skills-sh；成功则复用身份检查结果，失败则先读 authentication.md 再选择登录方式。Cloud 在登出时运行 <qodo> login；客户部署须保留文档中的登录端点，绝不回退到 Cloud。等待登录后重新检查身份。
验证工具：身份成功后运行 <qodo> tools --refresh --json --skill qodo-setup --skill-version 1.0.10 --distribution skills-sh，需获得可用目录与任务所需能力。刷新失败时报告登录成功但工具不可用，附确切错误，并以 <qodo> tools --refresh 重试；不要为目录失败再次登录。
配置与交接：CLI 负责凭据、传输与运行时更新，包的生命周期负责人更新技能。遇到 QODO_NOTICE 更新或反复的 Kiro 读取批准时按 host-recovery.md 处理。确认 Qodo 连接与相关工具就绪后，回到已授权任务。就绪不保证后续工具调用一定成功。不要安装可选 Standards。
限制与错误处理：给出实际错误和一个下一步动作；身份失败、登录取消或目录不可用后不得报告就绪。不得禁用钥匙串、复制凭据、修改宿主权限文件，或为通过配置而提供不受限的命令批准。其他未提供信息暂未提供。