用途:当结构化命令未覆盖目标接口,或用户给出明确的 /open-apis/... 路径时,用本技能直接调用开放平台原始接口。触发条件为使用 contract-cli api call 或提供精确开放平台路径。
主要能力与用法:命令形式为 contract-cli api call <METHOD> <PATH>。PATH 必须是相对路径且以 /open-apis/ 开头,不可传绝对 URL。请求体可用 --input-file 指定文件,--input-file 与 --data 互斥;--header "Key: Value" 可重复使用。
身份规则:命中 /open-apis/contract/v1/mcp/ 时必须走 --as user,--as bot 会被直接拒绝;不传 --as 时默认按 user 身份解析。
使用建议:开始前 MUST 先读取 ../contract-cli-shared/SKILL.md。已有结构化命令时优先用结构化命令,不要退回 api call。推荐阅读顺序为 references/api-call-guide.md 判断是否该退回 api call,references/api-call-rules.md 查路径、身份、请求体规则,references/commands.md 抄命令示例。原始调试请求优先用 --input-file。
限制与禁止:不要传绝对 URL;不要把 --file 当成请求体输入;不要把真实文件上传需求伪装成普通 JSON body 调用。实现来源包括 internal/cli/api_command.go、internal/cli/command_support.go、internal/openplatform/client.go 及上述 references 文件。