القائمة
查询和预检有赞云开放 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يبقى الأمر في سطر واحد. مرّر أفقيًا لمراجعته كاملًا قبل النسخ.
تفضّل نسخة محلية؟ نزّل الملفات المتاحة حاليًا لدى 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 或按能力包关键字查询状态；也可进入 有赞云能力包页面 查看审核状态。