voltsp

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

VoltSP Pipeline Engineering

VoltSP 管道工程

Use this skill as a compact execution guide, then load only the reference file needed for the current task.

Prefer official VoltSP documentation whenever details conflict with memory.

将本技能作为简洁的执行指南使用，然后仅加载当前任务所需的参考文件。

当本技能内容与官方VoltSP文档存在细节冲突时，以官方文档为准。

Choose the track

选择路径

Choose pipeline definition style:

Java DSL: read

references/pipelines-java.md

and

references/maven-setup.md

YAML API: read
```
references/pipelines-yaml.md
```
.

Choose runtime/deployment context:

Local CLI: read
```
references/cli-bare-metal.md
```
.
Kubernetes/Helm: read
```
references/kubernetes.md
```
.

Configure values and secrets:

Runtime configuration model + interpolation + secure config: read
```
references/configuration.md
```
.

Implement pipeline logic and tests:

For list of plugins and their APIS: read
```
references/plugins-catalog.md
```
.
Plugin deep dives and response format: read
```
references/plugins.md
```
.
Test strategy (unit/in-process/Testcontainers): read
```
references/testing.md
```
.
E2E-backed pipeline implementation patterns: read
```
references/pipeline-kinds.md
```
.

选择管道定义风格：

Java DSL：阅读

references/pipelines-java.md

和

references/maven-setup.md

。

YAML API：阅读
```
references/pipelines-yaml.md
```
。

选择运行时/部署环境：

本地CLI：阅读
```
references/cli-bare-metal.md
```
。
Kubernetes/Helm：阅读
```
references/kubernetes.md
```
。

配置值与密钥：

运行时配置模型 + 插值 + 安全配置：阅读
```
references/configuration.md
```
。

实现管道逻辑与测试：

插件列表及其API：阅读
```
references/plugins-catalog.md
```
。
插件深度解析与响应格式：阅读
```
references/plugins.md
```
。
测试策略（单元测试/进程内测试/Testcontainers）：阅读
```
references/testing.md
```
。
基于端到端测试的管道实现模式：阅读
```
references/pipeline-kinds.md
```
。

Deterministic resources

确定性资源

Use deterministic helpers for repetitive or fragile setup work:

Create starter files from templates with:

python3 scripts/scaffold_voltsp_pipeline.py --out-dir <dir> --pipeline-name <name> --track <java|yaml|both>

Validate separation of pipeline definition vs runtime config/helm values with:

python3 scripts/check_voltsp_yaml_layout.py --definition <pipeline.yaml> [--config <config.yaml>] [--helm-values <values.yaml>]

Template files used by the scaffold script:

assets/templates/java/Pipeline.java.tmpl

```
assets/templates/maven/pom.xml
```

assets/templates/yaml/pipeline-definition.yaml

assets/templates/yaml/runtime-config.yaml

```
assets/templates/helm/values.yaml
```

使用确定性工具类完成重复或易出错的设置工作：

通过以下命令从模板创建初始文件：

python3 scripts/scaffold_voltsp_pipeline.py --out-dir <dir> --pipeline-name <name> --track <java|yaml|both>

。

通过以下命令验证管道定义与运行时配置/Helm值的分离情况：

python3 scripts/check_voltsp_yaml_layout.py --definition <pipeline.yaml> [--config <config.yaml>] [--helm-values <values.yaml>]

。

脚手架脚本使用的模板文件：

assets/templates/java/Pipeline.java.tmpl

```
assets/templates/maven/pom.xml
```

assets/templates/yaml/pipeline-definition.yaml

assets/templates/yaml/runtime-config.yaml

```
assets/templates/helm/values.yaml
```

Output rules

输出规则

Return copy-pasteable commands and files.
Keep environment-specific values in config, not hardcoded in pipeline logic.
Use secure paths for secrets (
```
--configSecure
```
, Helm
```
configurationSecure
```
, or secret interpolation) instead of plain values.

返回可直接复制粘贴的命令和文件。
将环境特定值保留在配置中，不要硬编码到管道逻辑里。
使用安全路径存储密钥（
```
--configSecure
```
、Helm
```
configurationSecure
```
或密钥插值），而非明文值。