Agent Skills

这个仓库用于公开分发可安装的 agent skills。

技能列表

gitops-app-onboarding

用于 Baizhi GitOps 平台的项目接入工作流，适用于：

• deploy.baizhi.cloud
• registry.baizhi.cloud
• GitLab + Argo CD 的固定交付模型

适合处理：

• 给当前平台接入新项目
• 恢复 .gitlab-ci.yml、deploy/、Helm Chart、release bundle
• 修当前平台的发版链路
• 让应用仓库在发版时推送自己的 release 结果

执行时会遵守这些平台规则：

• 需要公网 HTTP 入口的应用使用 nginx + 单一 NodePort 作为平台接入层
• 百智云用户鉴权是平台必填接入项，需要逐项补齐 app_id 与证书材料
• 平台 shared 之外的私有依赖必须明确来源，不能只写不存在的连接参数
• 应用自带私有依赖的内部口令优先自动生成；外部集成凭据再向用户逐项索取
• 只允许应用仓库 CI 向 GitOps 仓库同步当前应用自己的 release 结果与版本引用；如果当前应用的 chart 版本由 GitOps 仓库中的 Application 维护，则只同步更新 apps/<app-name>/application.yaml 里的 targetRevision
• 如果运行时资源通过 releases/<app>/manifests/ 提供，就必须同步维护这个 path 与 Application 中对应的 source，不能只删目录不删引用
• 第三方镜像保持真实来源；只有当前应用 CI 实际发布的镜像才写到 registry.baizhi.cloud/<app-name>/...
• 镜像内自带的 nginx / 反向代理 upstream 必须和 Chart 渲染出来的 Service 名一致，不能混用裸服务名和 fullname 前缀

不适合处理：

• 通用 GitLab CI 改造
• 通用 Helm Chart 编写
• 未指向当前平台常量的通用 GitOps / Argo CD 任务
• 修改其他应用的 Application、任意 AppProject 或其他与当前应用版本引用无关的发布侧清单
• 改成 Ingress 驱动的对外暴露方式

安装

安装 gitops-app-onboarding：

npx skills add "https://deploy.baizhi.cloud/gitops-admin/agent-skills.git" --full-depth --skill gitops-app-onboarding -g -y

如果已经拿到本地副本，也可以直接从本地目录安装：

npx skills add "/path/to/agent-skills" --full-depth --skill gitops-app-onboarding -g -y

安装后可先确认是否已被识别：

npx skills add "https://deploy.baizhi.cloud/gitops-admin/agent-skills.git" --full-depth --skill gitops-app-onboarding --list

仓库结构

agent-skills/
├── README.md
└── gitops-app-onboarding/
    └── SKILL.md