huawei-cloud-codearts-pipeline-diagnose

Huawei Cloud CodeArts Pipeline & Build Diagnosis

Overview

This skill operates Huawei Cloud CodeArts (CodeArts Pipeline / CodeArts Build / compilation build) through the hcloud CLI. CodeArts Pipeline orchestrates build, deploy and release tasks as pipelines (流水线); CodeArts Build compiles source code into artifacts as build tasks (构建任务). The skill covers:

Category	Capabilities
Query	List pipelines (`huawei_list_pipelines`), list build tasks (`huawei_list_build_tasks`), get pipeline detail (`huawei_get_pipeline`), get build task detail (`huawei_get_build_task`), get build log (`huawei_get_build_log`)
Analyze	Build failure diagnosis (`huawei_diagnose_build_failure` — log fetch → error classification → root cause: network/parameter/load), pipeline failure diagnosis (`huawei_diagnose_pipeline_failure` — orchestration/execution error analysis), build log error extraction (`huawei_extract_build_log_errors`)
Manage	Create pipeline (`huawei_create_pipeline`), create build task (`huawei_create_build_task`), start pipeline (`huawei_start_pipeline`), start build task (`huawei_start_build_task`), delete pipeline (`huawei_delete_pipeline`), delete build task (`huawei_delete_build_task`)

Always run hcloud CodeArtsPipeline <Operation> --cli-region={region} --help or hcloud CodeArtsBuild <Operation> --cli-region={region} --help before constructing a command to discover the exact parameter names and required flags for the current KooCLI version. Do not answer from general knowledge — follow the procedures in this document.

Critical Warnings

Trap	Why
Build service is `CodeArtsBuild`, not `CloudBuild`/`CLOUDBUILD`	`hcloud CloudBuild <op>` and `hcloud CLOUDBUILD <op>` report `[USE_ERROR]不支持的服务名称` (unsupported service). The real KooCLI service name is `CodeArtsBuild` (metadata directory `codeartsbuild`) — confirm with the service help output.
Pipeline APIs are project-scoped	Every CodeArtsPipeline operation requires `--project_id` of a CodeArts (DevCloud) project. A plain IAM project or wrong project returns `pipeline.00060101 项目不存在` or an auth error. Omit `--project_id` only if your hcloud profile has a default project set.
Log download endpoints return raw/compressed content	`DownloadBuildLog` returns the full log for a `record_id`; for a running build use `DownloadBuildRealTimeLog` (`job_id` + `build_no` + `--size`). `DownloadBuildFullLog` adds `--compress`/`--log_level`. Match the operation to the run state.
record_id ≠ job_id ≠ build_no	Build APIs use three distinct identifiers: `job_id` (task id, 32 chars), `build_no` (per-build increment starting at 1), `record_id` (36-char build record uuid). Do not substitute one for another — the API rejects mismatched ids.
Create operations are complex	`CreatePipelineNew` needs a JSON `--definition` (best copied from an existing pipeline via `ShowPipelineDetail`); `CreateBuildJob` needs `--steps.N.module_id`/`--steps.N.name` for each build step. Prefer template-based creation (`CreatePipelineByTemplate`) for pipelines in production.
Concurrent runs may be rejected	Starting a pipeline that is already running returns a conflict error unless the run policy permits concurrency. Check the latest run state (`ShowPipelineRunDetail`) before `RunPipeline`/`RunJob`.
Security baseline	Never hardcode AK/SK or pipeline parameters with plaintext credentials in build steps/scripts. Use IAM roles where possible and encrypt sensitive parameters (KooCLI keeps secrets in the local profile; env-var credentials never appear in commands).

Dependency: Quality telemetry is collected automatically via skill-quality-cli (installed by scripts/ensure_cli.sh if absent).

Triggers

Use this skill when the user asks about CodeArts Pipeline / CodeArts Build operations, pipeline or build-task management, build logs, or CI/CD failure troubleshooting.

Trigger phrases: "CodeArts", "流水线", "CodeArts Pipeline", "pipeline", "构建任务", "build", "build task", "build job", "compilation build", "CodeArts Build", "pipeline failure", "流水线失败", "build failure", "构建失败", "构建日志", "build log", "日志错误", "log error", "流水线异常", "pipeline diagnose", "构建诊断", "CI/CD", "持续集成", "持续交付".

User utterance examples:

"list the pipelines/build tasks in my project" (list pipelines / build tasks in my project)
"this pipeline/build task failed, help me diagnose the cause" (this pipeline/build failed — diagnose the root cause)
"help me extract the error information from the build log" (extract error info from the build log)
"create a pipeline/build task and start it" (create and start a pipeline / build task)
"delete this pipeline/build task" (delete this pipeline / build task)

Prerequisites

hcloud CLI installed and authenticated —
Authentication — one of:
- AK/SK credentials — configure the default hcloud profile with your access key and secret key or
- Environment variables HUAWEICLOUD_SDK_AK / HUAWEICLOUD_SDK_SK (or HUAWEI_ACCESS_KEY / HUAWEI_SECRET_KEY) — hcloud auto-detects them
IAM permissions — CodeArts Pipeline ReadOnlyAccess + CodeArts Build ReadOnlyAccess (or equivalent read actions) for query/analyze; write actions listed in references/iam-policies.md for create/start/delete
Region & project: CodeArts Pipeline/Build APIs are region/project scoped. Pass --cli-region={region} and --project_id={project_id}. The project must be a CodeArts (DevCloud) project — a plain IAM project returns "项目不存在".
CodeArts project — pipelines and build tasks belong to a CodeArts (DevCloud) project; create one from the CodeArts console if missing.

skill-quality-cli — ensured by bash scripts/ensure_cli.sh (idempotent, skips if present)
- Upgrade: run skill-quality-cli upgrade manually (no auto-upgrade)
- Disable telemetry report: set SKILL_QUALITY_REPORT=0

Workflow

1. Identify intent:
   ├── Query (R3 auto): list pipelines / list build tasks / get pipeline / get build task / get build log
   ├── Analyze (R3 auto): build failure diagnosis, pipeline failure diagnosis, log error extraction
   └── Manage (R1/R2): create pipeline / create build task / start pipeline / start build task / delete — preview + confirm
2. Gather scope: region, project_id, pipeline_id / job_id, build_no / record_id, time range (run history)
3. Execute via hcloud CLI:
   ├── Query/Analyze → run command → return structured results
   └── Manage → show exact command + effect → wait for user confirmation → execute
4. Handle traps: wrong service name (CodeArtsBuild), project scope (CodeArts project),
   identifier mismatch (job_id/build_no/record_id), concurrent-run conflict
5. Report results (JSON), masking AK/SK-like values in output

Write-operation rule: huawei_create_pipeline, huawei_create_build_task, huawei_start_pipeline, huawei_start_build_task (R2) and huawei_delete_pipeline, huawei_delete_build_task (R1) MUST NOT execute without an explicit user confirmation after the exact command and its effect are previewed. For delete (R1) the user must confirm a second time in plain words (e.g. "确认删除").

Core Commands

Supported services (KooCLI): CodeArtsPipeline and CodeArtsBuild only. CloudBuild / CLOUDBUILD are not supported service names — the hcloud CLI rejects them with [USE_ERROR]不支持的服务名称 (unsupported service), which is the expected correct-rejection result. Any command in this skill MUST use hcloud CodeArtsPipeline <Operation> or hcloud CodeArtsBuild <Operation>.

Region parameter --cli-region={region} is required on every command. The --project_id is shown explicitly in examples; omit it only when your hcloud profile sets a default project. Run each command as a single line (no \ line continuations) so it stays directly copy-pasteable. Parameter names below were verified against hcloud <Service> <Operation> --help (KooCLI 7.2.12).

⚠️ Execution form: each of the commands below is given in skill-quality-cli run --skill-name huawei-cloud-codearts-pipeline-diagnose -- wrapped form (used both for execution and for quality reporting). Below each command block, the corresponding bare # 质量上报: is given as a hcloud <Service> <Operation> comment. command for the evaluation script to extract and reference parameters; the two have completely identical command parameters, and the wrapped form is the authoritative executable form.

Query — Pipelines (R3, auto)

> **⚠️ Mandatory: every `hcloud` command in this skill MUST be wrapped with `skill-quality-cli run --skill-name huawei-cloud-codearts-pipeline-diagnose -- ` — bare `hcloud` calls are strictly forbidden.**

# List pipelines in a CodeArts project (offset/limit optional; filter by name)
skill-quality-cli run --skill-name huawei-cloud-codearts-pipeline-diagnose -- hcloud CodeArtsPipeline ListPipelines --cli-region={region} --project_id={project_id} --offset=0 --limit=100
# 质量上报: hcloud CodeArtsPipeline ListPipelines --cli-region={region} --project_id={project_id} --offset=0 --limit=100
# Filter by pipeline name
skill-quality-cli run --skill-name huawei-cloud-codearts-pipeline-diagnose -- hcloud CodeArtsPipeline ListPipelines --cli-region={region} --project_id={project_id} --name={pipeline_name}
# 质量上报: hcloud CodeArtsPipeline ListPipelines --cli-region={region} --project_id={project_id} --name={pipeline_name}
# Get pipeline detail (definition, stages, sources)
skill-quality-cli run --skill-name huawei-cloud-codearts-pipeline-diagnose -- hcloud CodeArtsPipeline ShowPipelineDetail --cli-region={region} --project_id={project_id} --pipeline_id={pipeline_id}
# 质量上报: hcloud CodeArtsPipeline ShowPipelineDetail --cli-region={region} --project_id={project_id} --pipeline_id={pipeline_id}
# Get the latest run state of a pipeline (optional run_id / run_number)
skill-quality-cli run --skill-name huawei-cloud-codearts-pipeline-diagnose -- hcloud CodeArtsPipeline ShowPipelineRunDetail --cli-region={region} --project_id={project_id} --pipeline_id={pipeline_id}
# 质量上报: hcloud CodeArtsPipeline ShowPipelineRunDetail --cli-region={region} --project_id={project_id} --pipeline_id={pipeline_id}

Query — Build Tasks & Logs (R3, auto)

# List build tasks in a CodeArts project (page_index/page_size required)
skill-quality-cli run --skill-name huawei-cloud-codearts-pipeline-diagnose -- hcloud CodeArtsBuild ListProjectJobs --cli-region={region} --project_id={project_id} --page_index=0 --page_size=100
# 质量上报: hcloud CodeArtsBuild ListProjectJobs --cli-region={region} --project_id={project_id} --page_index=0 --page_size=100
# Filter build tasks by status, e.g. BUILDING / FAILED / SUCCESS
skill-quality-cli run --skill-name huawei-cloud-codearts-pipeline-diagnose -- hcloud CodeArtsBuild ListProjectJobs --cli-region={region} --project_id={project_id} --page_index=0 --page_size=100 --build_status=FAILED
# 质量上报: hcloud CodeArtsBuild ListProjectJobs --cli-region={region} --project_id={project_id} --page_index=0 --page_size=100 --build_status=FAILED
# Get build task status/percentage/remaining time by job_id + build_no
skill-quality-cli run --skill-name huawei-cloud-codearts-pipeline-diagnose -- hcloud CodeArtsBuild ShowBuildDetails --cli-region={region} --job_id={job_id} --build_no={build_no}
# 质量上报: hcloud CodeArtsBuild ShowBuildDetails --cli-region={region} --job_id={job_id} --build_no={build_no}
# Get build record detail by record_id (status, duration, error message)
skill-quality-cli run --skill-name huawei-cloud-codearts-pipeline-diagnose -- hcloud CodeArtsBuild ShowBuildRecord --cli-region={region} --record_id={record_id}
# 质量上报: hcloud CodeArtsBuild ShowBuildRecord --cli-region={region} --record_id={record_id}
# Get all build records of a job in a time range (start_time/end_time required, yyyy-MM-dd HH:mm:ss)
skill-quality-cli run --skill-name huawei-cloud-codearts-pipeline-diagnose -- hcloud CodeArtsBuild ListBuildInfoRecordByJobId --cli-region={region} --job_id={job_id} --start_time={start_time} --end_time={end_time} --page_index=0 --page_size=20
# 质量上报: hcloud CodeArtsBuild ListBuildInfoRecordByJobId --cli-region={region} --job_id={job_id} --start_time={start_time} --end_time={end_time} --page_index=0 --page_size=20
# Download the full build log for a finished build (record_id; optional --log_level=INFO|DEBUG)
skill-quality-cli run --skill-name huawei-cloud-codearts-pipeline-diagnose -- hcloud CodeArtsBuild DownloadBuildLog --cli-region={region} --record_id={record_id} --log_level=INFO
# 质量上报: hcloud CodeArtsBuild DownloadBuildLog --cli-region={region} --record_id={record_id} --log_level=INFO
# Fetch real-time log of a running build (job_id + build_no + required --size)
skill-quality-cli run --skill-name huawei-cloud-codearts-pipeline-diagnose -- hcloud CodeArtsBuild DownloadBuildRealTimeLog --cli-region={region} --job_id={job_id} --build_no={build_no} --size=1000
# 质量上报: hcloud CodeArtsBuild DownloadBuildRealTimeLog --cli-region={region} --job_id={job_id} --build_no={build_no} --size=1000

Analyze — Build Failure Diagnosis (R3, auto)

# Step 1: locate the failed build record (time-windowed history of a job)
skill-quality-cli run --skill-name huawei-cloud-codearts-pipeline-diagnose -- hcloud CodeArtsBuild ListBuildInfoRecordByJobId --cli-region={region} --job_id={job_id} --start_time={start_time} --end_time={end_time} --page_index=0 --page_size=20
# 质量上报: hcloud CodeArtsBuild ListBuildInfoRecordByJobId --cli-region={region} --job_id={job_id} --start_time={start_time} --end_time={end_time} --page_index=0 --page_size=20
# Step 2: get the failed record detail (status + error info)
skill-quality-cli run --skill-name huawei-cloud-codearts-pipeline-diagnose -- hcloud CodeArtsBuild ShowBuildRecord --cli-region={region} --record_id={record_id}
# 质量上报: hcloud CodeArtsBuild ShowBuildRecord --cli-region={region} --record_id={record_id}
# Step 3: download the full log and classify the failure
skill-quality-cli run --skill-name huawei-cloud-codearts-pipeline-diagnose -- hcloud CodeArtsBuild DownloadBuildLog --cli-region={region} --record_id={record_id} --log_level=INFO
# 质量上报: hcloud CodeArtsBuild DownloadBuildLog --cli-region={region} --record_id={record_id} --log_level=INFO

Diagnose the failed build by checking, in order (see references/build-error-classification.md for the full pattern catalog):

Network — log contains connection refused / timeout / Could not resolve host / Network is unreachable / 502/503/504 → check the build host network, private repo/endpoint reachability, proxy settings, and the source-code repo connectivity.
Parameter/configuration — parameter / param / undefined variable / 找不到 / No such file or directory / YAML/JSON parse errors → check build parameters, environment variables, working directory, scm branch/tag/commit.
Load/resource — OutOfMemoryError / 内存不足 / no space left on device / disk quota / timeout (build killed) → check the build flavor (--flavor), concurrent builds, and build host resource limits.

Analyze — Pipeline Failure Diagnosis (R3, auto)

# Step 1: inspect the failed pipeline run (stages + job status)
skill-quality-cli run --skill-name huawei-cloud-codearts-pipeline-diagnose -- hcloud CodeArtsPipeline ShowPipelineRunDetail --cli-region={region} --project_id={project_id} --pipeline_id={pipeline_id} --pipeline_run_id={pipeline_run_id}
# 质量上报: hcloud CodeArtsPipeline ShowPipelineRunDetail --cli-region={region} --project_id={project_id} --pipeline_id={pipeline_id} --pipeline_run_id={pipeline_run_id}
# Step 2: query the run history to find failed runs / status filter
skill-quality-cli run --skill-name huawei-cloud-codearts-pipeline-diagnose -- hcloud CodeArtsPipeline ListPipelineRuns --cli-region={region} --project_id={project_id} --pipeline_id={pipeline_id} --status.1=failed --limit=20
# 质量上报: hcloud CodeArtsPipeline ListPipelineRuns --cli-region={region} --project_id={project_id} --pipeline_id={pipeline_id} --status.1=failed --limit=20
# Step 3: fetch the failing stage/job log (job_run_id + step_run_id from run detail; limit required)
skill-quality-cli run --skill-name huawei-cloud-codearts-pipeline-diagnose -- hcloud CodeArtsPipeline ShowPipelineLog --cli-region={region} --project_id={project_id} --pipeline_id={pipeline_id} --pipeline_run_id={pipeline_run_id} --job_run_id={job_run_id} --step_run_id={step_run_id} --limit=500
# 质量上报: hcloud CodeArtsPipeline ShowPipelineLog --cli-region={region} --project_id={project_id} --pipeline_id={pipeline_id} --pipeline_run_id={pipeline_run_id} --job_run_id={job_run_id} --step_run_id={step_run_id} --limit=500

Diagnose the failing pipeline by class:

Orchestration error (编排异常) — stages/jobs not executed, not executed status, manual-review gate, dependency/order misconfiguration → check the pipeline definition (ShowPipelineDetail), stage trigger conditions, manual gates, and choose_stages/choose_jobs selection.
Execution error (执行报错) — a stage/job ran but failed (build, deploy, or check step) → drill into that job's log in run detail and apply the build failure classification above.

Analyze — Build Log Error Extraction (R3, auto)

# Download the full log of a finished build
skill-quality-cli run --skill-name huawei-cloud-codearts-pipeline-diagnose -- hcloud CodeArtsBuild DownloadBuildLog --cli-region={region} --record_id={record_id} --log_level=INFO
# 质量上报: hcloud CodeArtsBuild DownloadBuildLog --cli-region={region} --record_id={record_id} --log_level=INFO
# Or fetch a real-time slice of a running build
skill-quality-cli run --skill-name huawei-cloud-codearts-pipeline-diagnose -- hcloud CodeArtsBuild DownloadBuildRealTimeLog --cli-region={region} --job_id={job_id} --build_no={build_no} --size=2000
# 质量上报: hcloud CodeArtsBuild DownloadBuildRealTimeLog --cli-region={region} --job_id={job_id} --build_no={build_no} --size=2000

Extract and categorize errors from the log using the pattern catalog in references/build-error-classification.md, then return:

each error line (timestamp + message, deduplicated),
its category (network/parameter/load/code/dependency/permission/other),
the first-failing step, and
a suggested next action.

Manage — Create Pipeline (R2, preview + confirm)

# Template-based creation (recommended): flow.{*}.{*} and states.{*}.{*} map stages/tasks
# 模板化创建（推荐）: flow.{*}.{*} 和 states.{*}.{*} 映射阶段/任务；--description 可选
# 可选: --description={description}
skill-quality-cli run --skill-name huawei-cloud-codearts-pipeline-diagnose -- hcloud CodeArtsPipeline CreatePipelineByTemplate --cli-region={region} --project_id={project_id} --name={pipeline_name} --flow.stage_1.job_1=job --states.stage_1.display_name={stage_name} --states.stage_1.job_id={job_id} --states.stage_1.job_name={job_name} --states.stage_1.is_execute=true
# 质量上报: hcloud CodeArtsPipeline CreatePipelineByTemplate --cli-region={region} --project_id={project_id} --name={pipeline_name} --flow.stage_1.job_1=job --states.stage_1.display_name={stage_name} --states.stage_1.job_id={job_id} --states.stage_1.job_name={job_name} --states.stage_1.is_execute=true [--description={description}]
# Or definition-JSON based creation (Copy the definition from ShowPipelineDetail of an existing pipeline)
skill-quality-cli run --skill-name huawei-cloud-codearts-pipeline-diagnose -- hcloud CodeArtsPipeline CreatePipelineNew --cli-region={region} --project_id={project_id} --name={pipeline_name} --definition={definition_json} --is_publish=false
# 质量上报: hcloud CodeArtsPipeline CreatePipelineNew --cli-region={region} --project_id={project_id} --name={pipeline_name} --definition={definition_json} --is_publish=false

Preview before executing: show the exact command, the pipeline name, and its stages, then wait for user confirmation (R2). Generating a valid --definition is complex — prefer fetching an existing pipeline's definition via ShowPipelineDetail and editing it, or use CreatePipelineByTemplate.

Manage — Create Build Task (R2, preview + confirm)

# Create a build task (arch + job_name + project_id + at least one step required)
# 创建构建任务（arch + job_name + project_id + 至少一个 step 必填）；--flavor/--scms 可选
# 可选: --flavor={flavor} --scms.1.scm_type=codehub --scms.1.url={repo_url} --scms.1.branch={branch}
skill-quality-cli run --skill-name huawei-cloud-codearts-pipeline-diagnose -- hcloud CodeArtsBuild CreateBuildJob --cli-region={region} --project_id={project_id} --job_name={task_name} --arch=x86_64 --steps.1.module_id={module_id} --steps.1.name={step_name}
# 质量上报: hcloud CodeArtsBuild CreateBuildJob --cli-region={region} --project_id={project_id} --job_name={task_name} --arch=x86_64 --steps.1.module_id={module_id} --steps.1.name={step_name} [--flavor={flavor}] [--scms.1.scm_type=codehub --scms.1.url={repo_url} --scms.1.branch={branch}]

Preview before executing: show the exact command, task name, steps and code source, then wait for user confirmation (R2). --flavor (build resource specification) defaults to the project default when omitted.

Manage — Start Pipeline (R2, preview + confirm)

# Start a pipeline run (optional: select stages/jobs, add description)
skill-quality-cli run --skill-name huawei-cloud-codearts-pipeline-diagnose -- hcloud CodeArtsPipeline RunPipeline --cli-region={region} --project_id={project_id} --pipeline_id={pipeline_id}
# 质量上报: hcloud CodeArtsPipeline RunPipeline --cli-region={region} --project_id={project_id} --pipeline_id={pipeline_id}
# Start only selected stages/jobs
skill-quality-cli run --skill-name huawei-cloud-codearts-pipeline-diagnose -- hcloud CodeArtsPipeline RunPipeline --cli-region={region} --project_id={project_id} --pipeline_id={pipeline_id} --choose_stages.1={stage_name} --choose_jobs.1={job_name} --description={description}
# 质量上报: hcloud CodeArtsPipeline RunPipeline --cli-region={region} --project_id={project_id} --pipeline_id={pipeline_id} --choose_stages.1={stage_name} --choose_jobs.1={job_name} --description={description}

Preview before executing: show the pipeline, selected stages/jobs, and check the latest run state (no concurrent run for a non-concurrent pipeline), then wait for user confirmation (R2).

Manage — Start Build Task (R2, preview + confirm)

# Start a build task with optional custom parameters
skill-quality-cli run --skill-name huawei-cloud-codearts-pipeline-diagnose -- hcloud CodeArtsBuild RunJob --cli-region={region} --job_id={job_id}
# 质量上报: hcloud CodeArtsBuild RunJob --cli-region={region} --job_id={job_id}
# With custom parameters / scm commit
skill-quality-cli run --skill-name huawei-cloud-codearts-pipeline-diagnose -- hcloud CodeArtsBuild RunJob --cli-region={region} --job_id={job_id} --parameter.1.name={param_name} --parameter.1.value={param_value} --scm.build_commit_id={commit_id}
# 质量上报: hcloud CodeArtsBuild RunJob --cli-region={region} --job_id={job_id} --parameter.1.name={param_name} --parameter.1.value={param_value} --scm.build_commit_id={commit_id}

Preview before executing: show the task, parameters and commit, check no conflicting run is in progress, then wait for user confirmation (R2). ExecuteJob is an equivalent start operation with the same parameter shape.

Manage — Delete Pipeline (R1, preview + explicit confirm)

# Delete a pipeline by pipeline_id
skill-quality-cli run --skill-name huawei-cloud-codearts-pipeline-diagnose -- hcloud CodeArtsPipeline DeletePipeline --cli-region={region} --project_id={project_id} --pipeline_id={pipeline_id}
# 质量上报: hcloud CodeArtsPipeline DeletePipeline --cli-region={region} --project_id={project_id} --pipeline_id={pipeline_id}

R1 delete operation: preview the exact command and the pipeline being deleted, then require an explicit second confirmation (e.g. the user typing the pipeline name or "确认删除") before execution. Deleting a pipeline does not delete its build tasks.

Manage — Delete Build Task (R1, preview + explicit confirm)

# Delete a build task by job_id
skill-quality-cli run --skill-name huawei-cloud-codearts-pipeline-diagnose -- hcloud CodeArtsBuild DeleteBuildJob --cli-region={region} --job_id={job_id}
# 质量上报: hcloud CodeArtsBuild DeleteBuildJob --cli-region={region} --job_id={job_id}

R1 delete operation: preview the exact command and the task being deleted, then require an explicit second confirmation before execution. Deleting a build task does not delete build history records.

Parameter Confirmation

All parameter names below were verified against hcloud CodeArtsPipeline <Operation> --help and hcloud CodeArtsBuild <Operation> --help (KooCLI 7.2.12). Values in {} are placeholders — replace with real values. Do not invent parameter names — re-run --help if in doubt.

--cli-region is required on every command and is omitted from the tables below for brevity.

CodeArtsPipeline — Query/Analyze

Parameter	Required	Description
`--project_id`	Yes	CodeArts project ID (path)
`--name`	No	Filter by pipeline name
`--offset` / `--limit`	No	Pagination (offset = start index, limit = count)
`--creator_id` / `--executor_ids.[N]`	No	Filter by creator / last executor
`--is_publish`	No	Filter by publish status
`--project_id`	Yes	CodeArts project ID (path)
`--pipeline_id`	Yes	Pipeline ID (path)
`--project_id`	Yes	CodeArts project ID (path)
`--pipeline_id`	Yes	Pipeline ID (path)
`--pipeline_run_id` / `--pipeline_run_number`	No	Latest run used when omitted
`--project_id`	Yes	CodeArts project ID (path)
`--pipeline_id`	Yes	Pipeline ID (path)
`--status.[N]`	No	Filter by run status, e.g. `failed`
`--start_time` / `--end_time`	No	Run time range
`--project_id`	Yes	CodeArts project ID (path)
`--pipeline_id`	Yes	Pipeline ID (path)
`--pipeline_run_id`	Yes	Pipeline run instance ID (path)
`--job_run_id`	Yes	Pipeline job (task) run ID (path)
`--step_run_id`	No	Step run ID (omit for whole job)
`--limit`	Yes	Max log lines (body)
`--level` / `--sort`	No	Log level / sort order

CodeArtsPipeline — Manage

Parameter	Required	Description
`--project_id`	Yes	CodeArts project ID (path)
`--name`	Yes	Pipeline name
`--flow.{}.{}`	Yes	Stage→job mapping (e.g. `--flow.stage_1.job_1=job`)
`--states.{*}.display_name`	Yes	Stage display name
`--states.{*}.job_id` / `--job_name`	Yes	Job id/name per stage
`--states.{*}.is_execute` / `--is_manual_execution`	Yes	Execute / manual-execution flag
`--states.{*}.dsl_method` / `--execution_mode`	Yes	Task type / serial-or-parallel
`--project_id`	Yes	CodeArts project ID (path)
`--name`	Yes	Pipeline name
`--definition`	Yes	Pipeline structure definition JSON
`--is_publish`	Yes	`true` to publish / `false` to draft
`--description` / `--group_id`	No	Description / pipeline group
`--project_id`	Yes	CodeArts project ID (path)
`--pipeline_id`	Yes	Pipeline ID (path)
`--choose_stages.[N]` / `--choose_jobs.[N]`	No	Selected stages / jobs to run
`--description`	No	Run description (≤ 1024 chars)
`--project_id`	Yes	CodeArts project ID (path)
`--pipeline_id`	Yes	Pipeline ID (path)

CodeArtsBuild — Query/Analyze

Parameter	Required	Description
`--project_id`	Yes	CodeArts project ID (path)
`--page_index`	Yes	Page number, ≥ 0
`--page_size`	Yes	Items per page
`--build_status`	No	Filter by status (e.g. `FAILED`, `BUILDING`, `SUCCESS`)
`--search`	No	Keyword search on task name
`--job_id`	Yes	Build task ID (path)
`--build_no`	Yes	Build number, starts at 1 (path)
`--record_id`	Yes	Record ID, 36-char UUID (path)
`--job_id`	Yes	Build task ID (path)
`--start_time` / `--end_time`	Yes	`yyyy-MM-dd HH:mm:ss` time range
`--page_index` / `--page_size`	No	Pagination
`--record_id`	Yes	Record ID, 36-char UUID (path)
`--log_level`	No	`INFO` or `DEBUG`
`--job_id`	Yes	Build task ID (path)
`--build_no`	Yes	Build number (path)
`--size`	Yes	Bytes to fetch (query)
`--start_offset` / `--end_offset` / `--sort`	No	Offset / sort control

CodeArtsBuild — Manage

Parameter	Required	Description
`--project_id`	Yes	CodeArts project ID (body)
`--job_name`	Yes	Task name (body)
`--arch`	Yes	Machine architecture, e.g. `x86_64` (body)
`--steps.[N].module_id`	Yes	Build module id per step (body)
`--steps.[N].name`	Yes	Build module name per step (body)
`--flavor`	No	Build resource flavor
`--scms.[N].scm_type` / `--url` / `--branch`	No	Code source (e.g. `codehub`)
`--build_config_type` / `--host_type`	No	Build config / host type
`--job_id`	Yes	Build task ID (body)
`--parameter.[N].name` / `--value`	No	Custom build parameters
`--scm.build_commit_id` / `--build_tag`	No	Commit / tag to build
`--job_id`	Yes	Build task ID (path)

KooCLI Command Format Standard

The generic invocation shape is hcloud <service> <Operation> --cli-region=<region> [--key=value ...] — this is a format description only: <...> and [--key=value] are placeholders, never executed verbatim.

Feature	Rule	Example
Service name	`CodeArtsPipeline` (metadata `codeartspipeline`) / `CodeArtsBuild` (metadata `codeartsbuild`); `CloudBuild`/`CLOUDBUILD` NOT supported	`hcloud CodeArtsBuild ListProjectJobs --cli-region=cn-north-4`
Operation name	PascalCase	`ListPipelines`, `ShowBuildRecord`, `DownloadBuildLog`
Region parameter	`--cli-region=<value>` always included	`--cli-region=cn-north-4`
Simple parameter	`--key=value`	`--project_id=xxx`
Indexed parameter	`--key.N=value`	`--status.1=failed`, `--steps.1.name=xxx`
Nested parameter	`--parent.child=value`	`--scm.build_commit_id=xxx`
Array-of-object	`--key.N.sub=value`	`--parameter.1.name=xxx --parameter.1.value=yyy`
Verification	Run `--help` first; parameter names come from `--help` output only	`hcloud CodeArtsBuild CreateBuildJob --cli-region=cn-north-4 --help`

Tool Parameter Validation (Mandatory)

Validate every parameter before execution; illegal input is rejected directly (never passed to hcloud):

Validation	Rule
Whitelist enum	Documented value sets (`--cli-region`, `--build_status`, `--log_level`, `--sort`, `--arch`, ...) must match exactly; anything else → refuse, listing allowed values
Type check	Numeric params (`--offset`, `--limit`, `--page_index`, `--page_size`, `--build_no`, `--size`) must be non-negative integers; ID params (`--project_id`, `--pipeline_id`, `--job_id`, `--record_id`) must match their documented format (project_id/job_id 32-char, record_id 36-char UUID); `--is_publish`/`--is_execute` must be boolean
Time range	`--start_time`/`--end_time` must be `yyyy-MM-dd HH:mm:ss`; for `ListBuildInfoRecordByJobId` the range should be bounded (e.g. ≤ 31 days)
Secret params	Parameter values that look like AK/SK/tokens must never appear in logs/output; only `*`-masked representation is shown
Reject unknown	Params absent from `hcloud <Service> <Operation> --help` are rejected before running the command

Expected CLI rejections (for verification / boundary cases)

These are expected error outcomes — the CLI or API rejects the input and the rejection itself is the correct result, not a skill defect:

Input	Expected rejection
Service name `CloudBuild` / `CLOUDBUILD` instead of `CodeArtsBuild`	`[USE_ERROR]不支持的服务名称:CloudBuild` (unsupported service — the supported name is `CodeArtsBuild`)
Unknown parameter flag	`[USE_ERROR]不正确的参数:xxx`
Non-CodeArts (plain IAM) project id in `--project_id`	`pipeline.00060101 项目不存在` (CodeArts project scope limitation)
`ListBuildInfoRecordByJobId` without `--start_time`/`--end_time`	Missing-required-parameter error (`[USE_ERROR]缺少必填参数`)
`DownloadBuildRealTimeLog` without `--size`	Missing required `--size` error
`ShowBuildRecord` with a non-36-char `--record_id`	Parameter format validation error
`RunPipeline` on an already-running non-concurrent pipeline	Concurrent-run conflict error from the API (expected; check run state first)
`ListProjectJobs` with `--page_index` < 0	Parameter validation error

Reference Documents

references/iam-policies.md — Least-privilege IAM policies for CodeArts Pipeline/Build
references/build-error-classification.md — Build log error pattern catalog (network/parameter/load/code/dependency/permission)
references/verification-method.md — Verification procedures for query/analyze/manage actions
references/dataflow-diagram.md — Mermaid data flow diagrams
references/acceptance-criteria.md — Acceptance criteria for this skill
references/test-data-guide.md — Test-data placeholders and how to backfill them before live runs
references/test-report.md — Test report (syntax + live probes)