用途:该技能面向 Apidog CLI 的公开排障场景,不依赖内部 API 或内部代码。核心目标是确认命令、项目、分支、环境、资源 ID、报告位置和 CLI 版本,再把问题交回对应的领域技能去修复资源结构。
使用前应先阅读 ../apidog-cli/SKILL.md;若稳定入口技能与本技能冲突,以当前 apidog <command> --help 和本技能为准,再按资源类型阅读对应领域技能。
主要检查步骤:记录原始命令、projectId、branch、resourceId、environmentId、文件路径以及是否使用 --api-base-url;运行 apidog --version 确认版本;运行匹配的 apidog <command> --help;用 list/get 读回资源确认项目、分支、模块、目录或分类;对运行和报告问题区分本地报告与云端报告。
版本检查:可用 apidog --version、apidog import --help、apidog test-case category --help 查看;缺少参数时执行 apidog update 更新,非交互环境用 apidog update --yes;可用 export APIDOG_CLI_DISABLE_UPDATE_CHECK=1 关闭每日更新提示,但不影响手动更新。
资源在客户端缺失时,先核对项目、--branch、是否在 AI 分支、模块或目录、测试用例的 categoryId,以及二次导入的模块策略;可用 endpoint list、test-case list、test-scenario get 等命令读回确认。
测试用例方面,创建前用 apidog test-case category --project <projectId> 取有效 categoryId;category 暂不支持 --endpoint,查看端点用例应使用 test-case list --endpoint <endpointId>。get 能看到结构只说明已保存,不证明请求体、断言、提取器或脚本可运行。
测试场景方面,create 只创建场景元数据,复杂步骤需后续 import-steps、add-ref 或 update --file;创建或更新后用 test-scenario get --with-case-detail 确认步骤树。不要直接把测试用例结构写成场景步骤。
运行与报告:未指定 --environment 时服务器可能使用项目默认值,诊断建议显式指定环境;本地报告由 --out-dir 和 --out-file 控制;只有执行时用了 --upload-report,云端 test-report 才能查到。不要默认对生产环境运行有副作用的测试。
限制与冲突处理:公开文档、agentHints、历史示例与实际行为冲突时,以当前 help 和真实测试为准;不推荐 help 中未公开的隐藏别名;success=false 时以 success 字段和退出码为准,不要轻信摘要文字。本资料未提供具体收费、平台或更多版本信息。