القائمة
在执行有赞应用级发布、能力、日志、链路追踪或 RDS 操作前，解析并校验目标应用上下文。适用于 pipeline、capability、log、trace、rds 命令；不适用于账号或不关联应用的通用命令。
يُحدَّد Prompt الذي يراجع المصدر أولًا بشكل افتراضي. يمكنك التبديل إلى أمر مباشر أو تنزيل نسخة محلية.
اقرأ SKILL.md وأي ملفات مرافقة يعرضها SkillsMP قبل أن تقرر التثبيت.
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
يتجاوز الأمر المباشر Prompt المخصّص للمراجعة. افحص المصدر قبل تشغيله.
npx skills add https://github.com/youzan/youzanyun-toolkit --skill yzy-app-contextيبقى الأمر في سطر واحد. مرّر أفقيًا لمراجعته كاملًا قبل النسخ.
تفضّل نسخة محلية؟ نزّل الملفات المتاحة حاليًا لدى SkillsMP.
结合有赞云 llms.txt 文档导航、云文档中心搜索接口和 wiki 关键词搜索接口查询有赞云开放知识。用于回答开放平台、开发者接入、开放 API、开放消息、扩展点、定制需求、集成方案、工单答疑和能力咨询；其他有赞云开发 Skill 需要官方依据时也应使用本 Skill。
有赞云前端场景定制落地技能。用于识别并路由开放 2.0 前端定制需求到页面定制、独立页面、整页替换、下单/支付 Hook 等场景，按需查询有赞云官方文档或 yzy-knowledge-search，读取目标工程配置和相邻实现，完成最小必要代码修改。
查询和预检有赞云开放 API 能力包授权。用于设计或调用有赞云开放 API 前，确认当前应用类目下的 API 能力包、能力包详情、目标 API 是否已授权；所有应用级 capability 操作前必须先解析应用上下文并使用 zancli 校验登录。
استنادا إلى تصنيف SOC المهني
عرض SKILL.md
| name | yzy-app-context |
| description | 在执行有赞应用级发布、能力、日志、链路追踪或 RDS 操作前，解析并校验目标应用上下文。适用于 pipeline、capability、log、trace、rds 命令；不适用于账号或不关联应用的通用命令。 |
执行 pipeline、capability、log、trace 或 rds 组的任何命令前，必须先运行本 skill 的上下文解析脚本。该脚本会自动完成 zancli 安装与登录校验；不要绕过它直接执行应用级命令。
脚本入口同时提供 PowerShell、Python 和 Bash 三种形式。Windows 原生环境优先使用 PowerShell；通用环境优先尝试 Python；如果当前环境没有可用 PowerShell/Python 但有 Bash，再尝试 Bash 入口。
在目标应用仓库目录中，优先让 zancli 按当前目录推断：
powershell -ExecutionPolicy Bypass -File <plugin-root>/tools/zancli/ensure_zancli.ps1 -- zancli app context --output json
# or:
python3 <app-context-skill-dir>/scripts/resolve_app_context.py
# fallback when bash is available:
bash <plugin-root>/tools/zancli/app_context.sh
用户已经指定目标时，完整传递通用选择参数：
powershell -ExecutionPolicy Bypass -File <plugin-root>/tools/zancli/ensure_zancli.ps1 -- zancli app context --app-id 79782 --env dev --output json
powershell -ExecutionPolicy Bypass -File <plugin-root>/tools/zancli/ensure_zancli.ps1 -- zancli app context --app-name self-container-test --env dev --output json
# or:
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
# fallback when bash is available:
bash <plugin-root>/tools/zancli/app_context.sh --app-id 79782 --env dev
bash <plugin-root>/tools/zancli/app_context.sh --app-name self-container-test --env dev
脚本输出 zancli app context --output json 的完整 JSON，并至少校验 appId、appName 和环境。调用后先向用户说明解析到的应用 ID、名称、应用类型、环境、发布目标、绑定 addon 与开放能力状态；不要只依据目录名或用户口述推断。
zancli 命令传入相同的 --app-id 或 --app-name、--env，防止当前目录变化导致目标漂移。--expected-app-id 和 --expected-env 再解析一次，匹配后才执行操作。appId 或环境不匹配、当前目录无法推断、返回不完整或存在歧义时，停止后续操作，要求用户显式提供 --app-id 或 --app-name 与 --env。用户确认“对应用 79782 的 dev 环境执行”后：
python3 <app-context-skill-dir>/scripts/resolve_app_context.py \
--app-id 79782 --env dev --expected-app-id 79782 --expected-env dev
校验成功后，实际命令必须继续携带相同选择参数。若业务命令返回 UNAUTHENTICATED 或“登录失效”，重新运行本 skill，不要直接重试业务命令。