메뉴
查询有赞应用构建计划、触发 pipeline 构建、查看构建记录状态与步骤日志。用于用户要求发布、部署、构建、重跑构建、查询 pipeline 状态或日志时；触发构建前必须解析应用上下文并取得对应用、环境、计划和分支的明确确认。
기본적으로 소스를 먼저 확인하는 Prompt가 선택됩니다. 직접 명령으로 전환하거나 로컬 사본을 다운로드할 수도 있습니다.
설치 여부를 결정하기 전에 SKILL.md와 SkillsMP에 표시된 보조 파일을 읽어 보세요.
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
직접 명령은 검토 Prompt를 거치지 않습니다. 실행하기 전에 소스를 확인하세요.
npx skills add https://github.com/youzan/youzanyun-toolkit --skill yzy-pipeline명령은 한 줄로 유지됩니다. 복사하기 전에 가로로 스크롤해 전체 내용을 확인하세요.
로컬 사본을 원하시나요? SkillsMP에서 현재 제공할 수 있는 파일을 다운로드하세요.
结合有赞云 llms.txt 文档导航、云文档中心搜索接口和 wiki 关键词搜索接口查询有赞云开放知识。用于回答开放平台、开发者接入、开放 API、开放消息、扩展点、定制需求、集成方案、工单答疑和能力咨询；其他有赞云开发 Skill 需要官方依据时也应使用本 Skill。
有赞云前端场景定制落地技能。用于识别并路由开放 2.0 前端定制需求到页面定制、独立页面、整页替换、下单/支付 Hook 等场景，按需查询有赞云官方文档或 yzy-knowledge-search，读取目标工程配置和相邻实现，完成最小必要代码修改。
查询和预检有赞云开放 API 能力包授权。用于设计或调用有赞云开放 API 前，确认当前应用类目下的 API 能力包、能力包详情、目标 API 是否已授权；所有应用级 capability 操作前必须先解析应用上下文并使用 zancli 校验登录。
SOC 직업 분류 기준
SKILL.md 표시 중
| name | yzy-pipeline |
| description | 查询有赞应用构建计划、触发 pipeline 构建、查看构建记录状态与步骤日志。用于用户要求发布、部署、构建、重跑构建、查询 pipeline 状态或日志时；触发构建前必须解析应用上下文并取得对应用、环境、计划和分支的明确确认。 |
所有 pipeline 操作都先使用 yzy-app-context 解析目标应用；该 skill 会连带完成 zancli 的安装和登录校验。不要直接根据当前目录、应用名或上一轮对话执行发布命令。
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、名称、环境、发布目标与已知状态：
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 --zone <zone>
解析成功后，后续所有 zancli 命令继续携带相同的 --app-id / --app-name、--env、--zone，避免目标漂移。
先用解析结果查询计划，再根据计划类型筛选。
通用查询：
python3 <plugin-root>/tools/zancli/ensure_zancli.py -- \
zancli pipeline plans --app-id <app-id> --env <env> --output json
仅当用户只关心特定技术栈时追加 --type：
python3 <plugin-root>/tools/zancli/ensure_zancli.py -- \
zancli pipeline plans --app-id <app-id> --env <env> --type CLOUD_FRONTEND --output json
从结果中归纳每个计划的 planId、名称、类型，以及最近一次构建的状态、分支和 commit。存在多个计划时，要求用户选择具体计划；不要猜测或选择最近一次成功的计划。
前端构建发布时，按下面顺序执行：
appId、appName、env 和 zone。CLOUD_FRONTEND 计划，不要手填或沿用旧的 planId。planId、名称、最近一次分支和 commit。--expected-app-id 和 --expected-env 复核。--pipeline-id 和 --branch 执行触发。触发构建是写操作。仅在用户明确确认“应用、环境、计划 ID、分支，以及开始构建”后执行：
appId 和环境再次解析上下文，使用 --expected-app-id 与 --expected-env 复核。--pipeline-id。应用存在多个计划时，缺少该参数会返回 PIPELINE_PLAN_AMBIGUOUS，不得据此重试或改选计划。--branch；未指定时，说明将使用当前跟踪的远程分支后再执行。--confirm --wait --timeout 15m 启动并等待终态。python3 <app-context-skill-dir>/scripts/resolve_app_context.py \
--app-id 79782 --env dev --expected-app-id 79782 --expected-env dev
python3 <plugin-root>/tools/zancli/ensure_zancli.py -- \
zancli pipeline trigger \
--app-id 79782 --env dev \
--pipeline-id 326 \
--branch feat/test-rpm \
--confirm --wait --timeout 15m \
--output json
构建失败时，命令以非 0 退出并返回 PIPELINE_RECORD_FAILED。保留返回的 record ID、失败状态和摘要；不要自动重试、切换分支或触发其他计划。
读取状态、历史记录或日志前，同样先解析应用上下文，并在命令中继续传递相同的应用选择参数：
python3 <plugin-root>/tools/zancli/ensure_zancli.py -- \
zancli pipeline status --record-id 727465 --app-id 79782 --env dev --output json
python3 <plugin-root>/tools/zancli/ensure_zancli.py -- \
zancli pipeline status --record-id 727465 --app-id 79782 --env dev --wait --interval 10s --timeout 15m --output json
python3 <plugin-root>/tools/zancli/ensure_zancli.py -- \
zancli pipeline records --pipeline-id 326 --app-id 79782 --env dev --page 1 --page-size 20 --output json
python3 <plugin-root>/tools/zancli/ensure_zancli.py -- \
zancli pipeline logs --step-id 8891234 --app-id 79782 --env dev --output json
--wait 会前台轮询至终态。step-id 从 pipeline status 的步骤列表取得。成功步骤返回 success:true 与空日志串是正常行为；只在失败步骤存在外部日志时再据此排查，不要将空日志误报为故障。