メニュー
查询和预检有赞云开放 API 能力包授权。用于设计或调用有赞云开放 API 前，确认当前应用类目下的 API 能力包、能力包详情、目标 API 是否已授权；所有应用级 capability 操作前必须先解析应用上下文并使用 zancli 校验登录。
デフォルトでは、最初にソースを確認する Prompt が選択されています。直接コマンドに切り替えるか、ローカルコピーをダウンロードすることもできます。
インストールを決める前に、SKILL.md と SkillsMP に表示されている付属ファイルをお読みください。
Codex または Claude でインストール この Prompt をコピーして Codex、Claude、または他のアシスタントに貼り付けると、Skill ページを確認してインストールできます。
直接コマンドでは確認用 Prompt が省略されます。実行前にソースを確認してください。
npx skills add https://github.com/youzan/youzanyun-toolkit --skill yzy-api-capabilityコマンドは1行のまま表示されます。コピー前に横へスクロールして全体を確認してください。
ローカルで確認しますか？SkillsMP が現在取得できるファイルをダウンロードできます。
结合有赞云 llms.txt 文档导航、云文档中心搜索接口和 wiki 关键词搜索接口查询有赞云开放知识。用于回答开放平台、开发者接入、开放 API、开放消息、扩展点、定制需求、集成方案、工单答疑和能力咨询；其他有赞云开发 Skill 需要官方依据时也应使用本 Skill。
有赞云前端场景定制落地技能。用于识别并路由开放 2.0 前端定制需求到页面定制、独立页面、整页替换、下单/支付 Hook 等场景，按需查询有赞云官方文档或 yzy-knowledge-search，读取目标工程配置和相邻实现，完成最小必要代码修改。
在执行有赞应用级发布、能力、日志、链路追踪或 RDS 操作前，解析并校验目标应用上下文。适用于 pipeline、capability、log、trace、rds 命令；不适用于账号或不关联应用的通用命令。
SOC 職業分類に基づく
SKILL.md を表示中
| name | yzy-api-capability |
| description | 查询和预检有赞云开放 API 能力包授权。用于设计或调用有赞云开放 API 前，确认当前应用类目下的 API 能力包、能力包详情、目标 API 是否已授权；所有应用级 capability 操作前必须先解析应用上下文并使用 zancli 校验登录。 |
在设计或调用有赞云开放 API 前，先确认当前应用有哪些 API 能力包，以及目标 API 是否已授权。能力包只用于 API 授权判断；开放消息和扩展点不通过能力包授权。
所有 capability 操作都先使用 yzy-app-context 解析目标应用；该 skill 会连带完成 zancli 的安装和登录校验。不要直接根据当前目录、应用名或上一轮对话执行 API 能力包命令。
zancli 安装校验入口同时提供 PowerShell、Python 和 Bash 三种形式。Windows 原生优先尝试 powershell -ExecutionPolicy Bypass -File <plugin-root>/tools/zancli/ensure_zancli.ps1；通用环境优先尝试 python3 <plugin-root>/tools/zancli/ensure_zancli.py；如果当前环境没有可用 PowerShell/Python 但有 Bash，再尝试 bash <plugin-root>/tools/zancli/ensure_zancli.sh。
先解析应用上下文并向用户展示应用 ID、名称、环境、应用类型、发布目标、绑定 addon 与开放能力状态：
python3 <app-context-skill-dir>/scripts/resolve_app_context.py
用户已指定目标时，完整传递通用选择参数：
python3 <app-context-skill-dir>/scripts/resolve_app_context.py --app-id 79782 --env dev
python3 <app-context-skill-dir>/scripts/resolve_app_context.py --app-name self-container-test --env dev
上下文解析成功后，实际 zancli capability 命令继续携带相同的 --app-id 或 --app-name、--env，防止目标漂移。
列出当前应用类目下的 API 能力包：
python3 <plugin-root>/tools/zancli/ensure_zancli.py -- \
zancli capability list --app-name self-container-test --output json
按关键字过滤时，--api、--package、--status 三个过滤器互斥，不要同时传多个：
python3 <plugin-root>/tools/zancli/ensure_zancli.py -- \
zancli capability list --app-name self-container-test --api 交易 --output json
python3 <plugin-root>/tools/zancli/ensure_zancli.py -- \
zancli capability list --app-name self-container-test --package 商品 --output json
python3 <plugin-root>/tools/zancli/ensure_zancli.py -- \
zancli capability list --app-name self-container-test --status granted --output json
--status 取值：all（默认）| granted | not_granted | pending | rejected | withdrawn | unknown。
查看某个 API 能力包的详情，包括 API 列表和文档链接：
python3 <plugin-root>/tools/zancli/ensure_zancli.py -- \
zancli capability get --app-name self-container-test --package-id 1234 --output json
精确预检一个 API 是否已授权：
python3 <plugin-root>/tools/zancli/ensure_zancli.py -- \
zancli capability check --app-name self-container-test \
--api youzan.trade.get --no-interactive --output json
--api 必须传完整的 API name。只匹配到模糊候选时，命令返回候选列表，不会静默当作已授权放行。
check 的结果直接看退出码和 JSON 中的 allowed 字段，不需要解析文字：
| 情况 | 退出码 | 错误码 |
|---|---|---|
| 已授权 | 0 | 无，allowed:true |
| 未授权但可申请 | 非 0 | CAPABILITY_NOT_GRANTED |
| 申请审核中 | 非 0 | CAPABILITY_APPLICATION_PENDING |
| 申请被驳回 | 非 0 | CAPABILITY_APPLICATION_REJECTED |
| 当前类目不支持 | 非 0 | CAPABILITY_API_UNSUPPORTED |
| 只匹配到模糊候选 | 非 0 | CAPABILITY_API_AMBIGUOUS |
capability apply 是真实提交申请的写操作。只能在以下条件都满足后执行：
package-idreason 由用户提供，不能代填或编造提交前先把应用、环境、能力包 ID 和申请理由展示给用户复核。确认无误后再执行：
python3 <plugin-root>/tools/zancli/ensure_zancli.py -- \
zancli capability apply \
--app-name self-container-test \
--env prod \
--package-id <package-id> \
--reason '<reason>' \
--confirm
apply 成功后表示申请已经提交，后续状态以审核结果为准。可继续用 capability list --status pending 或按能力包关键字查询状态；也可进入 有赞云能力包页面 查看审核状态。