# 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` 作为平台接入层
- 百智云用户鉴权是平台必填接入项，需要逐项补齐 `env` 与证书材料
- 平台 shared 之外的私有依赖必须明确来源，不能只写不存在的连接参数
- 应用自带私有依赖的内部口令优先自动生成；外部集成凭据再向用户逐项索取
- 只允许应用仓库 CI 向 GitOps 仓库同步当前应用自己的 release 结果

不适合处理：

- 通用 GitLab CI 改造
- 通用 Helm Chart 编写
- 未指向当前平台常量的通用 GitOps / Argo CD 任务
- 修改 GitOps 仓库中的 `Application`、`AppProject` 或其他发布侧清单
- 改成 Ingress 驱动的对外暴露方式

## 安装

安装 `gitops-app-onboarding`：

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

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

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

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

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

## 仓库结构

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