northseadl/norix-skills / cnb-cool-integration
cnb-cool-integration
Verified针对 cnb.cool 的云原生构建(CNB Build):生成/修改 .cnb.yml 流水线、触发规则、 构建环境、runner 资源、缓存、环境变量、手动触发与调试。 在接入、迁移、优化或排查 CNB 构建配置时使用。
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 3.7 KB |
| agents/openai.yaml | config | 350 B |
| references/cache.md | markdown | 1.4 KB |
| references/cnb-yml.md | markdown | 1.3 KB |
| references/debug.md | markdown | 555 B |
| references/docker-and-runner.md | markdown | 2.2 KB |
| references/env.md | markdown | 876 B |
| references/file-reference.md | markdown | 1.4 KB |
| references/intro.md | markdown | 1.5 KB |
| references/recipes.md | markdown | 1.5 KB |
| references/trigger-rule.md | markdown | 1.1 KB |
| references/web-trigger.md | markdown | 1.6 KB |
SKILL.md
View on GitHub---
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`
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| 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: 198k | Updated | Claude CodeCodex | Verified | Install |
| 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: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| 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: 194k | Updated | Claude CodeCodex | Verified | Install |