63 lines
1.8 KiB
Markdown
63 lines
1.8 KiB
Markdown
# 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 结果
|
||
- 按固定 nginx + `NodePort` 代理模型组织前后端对外暴露
|
||
- 按用户或平台已分配的 `NodePort` 配置 nginx 对外入口
|
||
- 在必填私有配置缺失时先逐项询问，再保留未解决的缺失警告
|
||
- 在应用依赖平台 shared 之外的私有服务时，补齐对应资源或明确外部依赖来源，而不是只写连接参数
|
||
- 对应用自带私有依赖的内部口令优先自动生成，对外部集成凭据再向用户逐项索取
|
||
|
||
不适合处理：
|
||
|
||
- 通用 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
|
||
```
|