技能介绍

要解决的问题

ADP 文档列出的 Action 不等于它能用：同一接口可能返回 success、endpoint_confirmed_boundary 或 action_not_found。服务端识别了 Action 但卡在参数、状态、应用类型或权限边界时，只能证明端点与该边界。本技能把「文档写了什么」与「线上真跑了什么」分开，结论必须挂在真实响应上。

核心能力与关键步骤

接口实测：references/api_reference.md 只是待验证索引，用 scripts/adp_client.py 对目标应用真实调用；参数未知时靠 UnknownParameter / MissingParameter 逐步删减补齐，不凭接口名猜结构。输出固定四项：结论、真实证据、边界、下一步。

全量探测：scripts/probe_all_apis.py 提取接口表全部 Action，每个至少真实发一次 HTTPS 请求；只读接口按错误自适应重试，写接口只探测一次，避免补参误建资源。报告中请求数通常大于 Action 数。

会话质量归因：DescribeLatestRelease 取最近发布时间作 since，只分析之后的新会话；GetMsgLogList 统计拒答、空回复、平均回复长度与高频问题。它不返回 References、Tasks 与执行状态，引用命中率、工具调用率、异常率须标为不可用，禁止伪算。每轮只改一个配置变量，DescribeAgentDetail 快照前后差异，发布后用新锚点复测。

问答/文档录入：CreateQA 先进异步审核，IsAllowEdit / IsAllowDelete 为 false 时改删必失败；VerifyQA 入口是 List；文档导入走 DescribeStorageCredential → COS 上传 → SaveDoc。

适用边界与注意点

凭证不落盘：密钥只在进程环境变量，报告默认递归脱敏；--show-sensitive 仅用于把临时密钥交给后续进程，不得写入报告或提交仓库。
写操作双重保险：CLI 显式 --confirm，import 显式 allow_write=True，先 --dry-run；删除、发布均为真实副作用。
InternalError 不一定是参数问题，可能是非法枚举或后端缺陷；RequestId 不能证明业务成功，写后必须回读。
临时资源带 wb-probe- 前缀，跑完创建→回读→修改→删除闭环；被审核阻塞则保留 ID 继续回读，禁止假报「已清理」。
新旧版本分流：新版走 adp.tencentcloudapi.com（service adp），旧版 LKE 走 lke.tencentcloudapi.com，不得串用。