Skip to content

northseadl/norix-skills / cnb-cool-integration

cnb-cool-integration

Verified

针对 cnb.cool 的云原生构建(CNB Build):生成/修改 .cnb.yml 流水线、触发规则、 构建环境、runner 资源、缓存、环境变量、手动触发与调试。 在接入、迁移、优化或排查 CNB 构建配置时使用。

FileKindSize
SKILL.mdskill md3.7 KB
agents/openai.yamlconfig350 B
references/cache.mdmarkdown1.4 KB
references/cnb-yml.mdmarkdown1.3 KB
references/debug.mdmarkdown555 B
references/docker-and-runner.mdmarkdown2.2 KB
references/env.mdmarkdown876 B
references/file-reference.mdmarkdown1.4 KB
references/intro.mdmarkdown1.5 KB
references/recipes.mdmarkdown1.5 KB
references/trigger-rule.mdmarkdown1.1 KB
references/web-trigger.mdmarkdown1.6 KB
---
name: cnb-cool-integration
metadata:
  version: 0.1.1
description: |
  针对 cnb.cool 的云原生构建(CNB Build):生成/修改 .cnb.yml 流水线、触发规则、
  构建环境、runner 资源、缓存、环境变量、手动触发与调试。
  在接入、迁移、优化或排查 CNB 构建配置时使用。
---

# CNB 云原生构建(cnb.cool)

## 你要输出什么

- `.cnb.yml`(必选):基于用户目标生成或最小改动修改,并解释触发与并发关系(pipeline 并发 / stage 串行 / job 并发)。
- 需要时额外输出:
  - `.cnb/web_trigger.yml`:需要“手动触发按钮/参数/选择目标构建”时。
  - `.cnb/env/*.yml`:需要复用环境变量或跨仓库 `imports` 时(见 `references/env.md`)。
- 注意:若用户使用的是 CODING 平台的云原生构建(配置文件为 `.coding-ci.yml`),语法与变量机制(尤其 `exports/imports`、内置任务等)与本 CNB 有差异,应改用 `coding-ci` Skill。

## 开始前先问(尽量一次问完)

1. 默认分支与触发分支:哪些分支要跑?是否需要 `$` 兜底配置?
2. 事件:`push` / `pull_request` / `commit.add` / `web_trigger_*` / `schedule` / `api_trigger` 等需要哪些?
3. 构建语言与命令:例如 Go/Node/Java,具体 `test/build/lint` 命令。
4. 构建环境:直接用 `docker.image`,还是 `docker.build`/`docker.devcontainer`?是否需要共享 `volumes`?
5. 资源与速度:runner 需要多少 `cpus/mem/disk`?是否需要 `tags`?
6. 缓存与参数:需要缓存什么(`node_modules` / `go` / `maven` / `npm cache`)?是否需要跨节点缓存(`docker:cache`)?是否需要 `exports` 传参?
7. 发布与手动:是否需要 `docker build & push`、部署、以及 web_trigger 按钮?

## 配置生成/修改流程

### 1) 选用 `.cnb.yml` 结构

- **推荐**:`<branch> -> <event> -> [pipelines]`(最直观)
- **需要跨分支复用**:使用 `imports` 或 YAML 锚点(见 `references/cnb-yml.md`、`references/file-reference.md`)

### 2) 写最小可跑的 pipeline

- pipeline 内 `stages` 默认串行;stage 内 `jobs` 默认并发。
- 同一 `<branch>/<event>` 下多个 pipeline **并发**,并共享相同 docker 环境与 runner(见 `references/cnb-yml.md`)。

### 3) 加入缓存与复用

- 用 `docker.volumes` 缓存目录(copy-on-write,跨 stage 复制;见 `references/cache.md`)。
- 需要跨节点共享时,用 `docker:cache`(见 `references/cache.md`)。

### 4) 补齐触发与手动能力

- 分支匹配用 glob;不匹配时可用 `$` 兜底。
- web_trigger 的 event 为 `web_trigger_<button-id>`(需要 `.cnb/web_trigger.yml`;见 `references/web-trigger.md`)。

### 5) 出问题先按这套排查

- 触发没跑:检查 branch glob、event 名、是否被 `skip-cnb`/`skip-cnb: <stage>` 跳过(见 `references/trigger-rule.md`、`references/recipes.md`)。
- 缓存没命中:确认 `volumes` 挂载路径一致;需要跨节点则改用 `docker:cache`(见 `references/cache.md`)。
- 需要进机排查:按 `login` debug 配置加一段可登录 stage(见 `references/debug.md`)。

## 常见用户请求 → 你应加载的参考

- 只问“怎么写 `.cnb.yml`”:读 `references/cnb-yml.md` 与 `references/docker-and-runner.md`
- 只问“触发规则/事件/分支匹配”:读 `references/trigger-rule.md`
- 只问“env/imports/exports”:读 `references/env.md`
- 只问“缓存/加速”:读 `references/cache.md`
- 只问“手动触发按钮”:读 `references/web-trigger.md`
- 只问“登录调试”:读 `references/debug.md`
- 只问“Monorepo 按需构建 / Docker build&push / 跳过构建 / 超时 / 权限”:读 `references/recipes.md`
slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack."Stars: 198kUpdated Claude CodeCodexVerifiedInstall
ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt.Stars: 194kUpdated Claude CodeCodexVerifiedInstall