213 lines
6.8 KiB
Markdown
213 lines
6.8 KiB
Markdown
# IBM i AI编程技能库
|
||
|
||
`IBM i` `AI助手` `SQL` `系统管理` `Claude Code`
|
||
|
||
# IBM i Agent 技能库
|
||
|
||
面向 AI 编程助手的 Agent 技能，用于操作 IBM i 系统。涵盖所有 IBM i SQL 服务类别的 **24 个技能**，提供 **219+ 预置工具**。
|
||
|
||
## 什么是 Agent 技能？
|
||
|
||
Agent 的能力日益增强，但通常缺乏可靠完成实际工作所需的上下文。技能（Skills）通过为 Agent 提供程序化知识以及**公司**、**团队**和**用户特定的上下文**来解决这一问题，Agent 可按需加载。拥有技能集的 Agent 能够根据当前任务动态扩展自身能力。
|
||
|
||
## 安装
|
||
|
||
技能以**插件**形式组织，按需安装：
|
||
|
||
| 插件 | 技能数 | 工具数 | 适用人群 |
|
||
|--------|--------|-------|----------|
|
||
| **ibmi-core** | 1 (ibmi) | 7 | 所有人 — CLI、文本转 SQL、模式发现 |
|
||
| **ibmi-database** | 5 | 51 | DBA、SQL 开发者 |
|
||
| **ibmi-system** | 18 | 161 | 系统管理员、运维、安全、DevOps |
|
||
| **ibmi-all** | 24 | 219+ | 安装全部 |
|
||
|
||
### 方式一：Claude Code 插件市场
|
||
|
||
```
|
||
/plugin marketplace add ajshedivy/ibmi-agent-skills
|
||
|
||
# 按角色安装：
|
||
/plugin install ibmi-core@ibmi-agent-skills # 从这里开始
|
||
/plugin install ibmi-database@ibmi-agent-skills # 适合 DBA
|
||
/plugin install ibmi-system@ibmi-agent-skills # 适合系统管理员
|
||
|
||
# 或安装全部：
|
||
/plugin install ibmi-all@ibmi-agent-skills
|
||
```
|
||
|
||
### 方式二：npx skills（多 Agent）
|
||
|
||
使用 [`npx skills`](https://github.com/vercel-labs/agent-skills) 安装技能，支持 Claude Code、Cursor、GitHub Copilot 及其他 40+ 个 Agent。
|
||
|
||
```bash
|
||
# 从 GitHub 安装
|
||
npx skills add ajshedivy/ibmi-agent-skills
|
||
|
||
# 或克隆后本地安装
|
||
git clone https://github.com/ajshedivy/ibmi-agent-skills.git
|
||
cd ibmi-agent-skills
|
||
npx skills add ./skills --list # 列出可用技能
|
||
npx skills add ./skills/ibmi # 核心技能（从这里开始）
|
||
npx skills add ./skills # 安装所有技能
|
||
```
|
||
|
||
#### 选项说明
|
||
|
||
| 选项 | 描述 |
|
||
|--------|-------------|
|
||
| `-g, --global` | 安装到用户目录而非项目目录 |
|
||
| `-a, --agent <agents...>` | 指定目标 Agent（如 `claude-code`、`cursor`） |
|
||
| `-s, --skill <skills...>` | 按名称安装指定技能 |
|
||
| `-l, --list` | 列出可用技能但不安装 |
|
||
| `-y, --yes` | 跳过所有确认提示 |
|
||
| `--all` | 无提示安装所有技能到所有 Agent |
|
||
|
||
#### 示例
|
||
|
||
```bash
|
||
# 仅安装到 Claude Code
|
||
npx skills add ./skills -a claude-code
|
||
|
||
# 全局安装（所有项目均可用）
|
||
npx skills add ./skills -g
|
||
|
||
# 非交互式安装
|
||
npx skills add ./skills -g -a claude-code -y --all
|
||
```
|
||
|
||
## 前提条件
|
||
|
||
需要将 [`ibmi-mcp-server`](https://github.com/IBM/ibmi-mcp-server) 连接到你的 Agent，提供以下能力：
|
||
- `describe_sql_object` — 获取 IBM i 对象的 DDL/元数据
|
||
- `execute_sql` — 在 IBM i 上执行 SQL SELECT 语句
|
||
|
||
### 配置 MCP 服务器
|
||
|
||
在 Agent 的 MCP 配置文件中添加以下内容（Claude Code 对应 `.mcp.json`）：
|
||
|
||
```json
|
||
{
|
||
"mcpServers": {
|
||
"ibmi-mcp-server": {
|
||
"command": "npx",
|
||
"args": ["-y", "@ibm/ibmi-mcp-server@latest"],
|
||
"env": {
|
||
"NODE_OPTIONS": "--no-deprecation",
|
||
"DB2i_HOST": "your-hostname.com",
|
||
"DB2i_USER": "your-username",
|
||
"DB2i_PASS": "your-password",
|
||
"DB2i_PORT": "8076",
|
||
"MCP_TRANSPORT_TYPE": "stdio",
|
||
"IBMI_ENABLE_EXECUTE_SQL": "true"
|
||
}
|
||
}
|
||
}
|
||
}
|
||
```
|
||
|
||
### IBM i CLI（可选）
|
||
|
||
[`ibmi` CLI](https://github.com/ajshedivy/ibmi-cli) 提供直接工具执行能力：
|
||
|
||
```bash
|
||
ibmi tool list_active_jobs --tools skills/work-management/tools/
|
||
ibmi sql "SELECT * FROM TABLE(QSYS2.ACTIVE_JOB_INFO()) FETCH FIRST 10 ROWS ONLY"
|
||
```
|
||
|
||
## 可用技能
|
||
|
||
### 核心（ibmi-core 插件）
|
||
|
||
| 技能 | 工具数 | 描述 |
|
||
|-------|-------|-------------|
|
||
| `ibmi` | 7 | CLI 用法、文本转 SQL 方法论、模式发现、SQL 验证 |
|
||
|
||
### 数据库（ibmi-database 插件）
|
||
|
||
| 技能 | 工具数 | 描述 |
|
||
|-------|-------|-------------|
|
||
| `database-utility` | 9 | 文件清单、对象统计、数据验证 |
|
||
| `database-application` | 7 | SQL 错误日志、SQLCODE 信息、系统限制 |
|
||
| `database-performance` | 8 | 索引、MTI、监视器、MQT、活动查询 |
|
||
| `database-plan-cache` | 7 | 计划缓存快照、事件、存储过程 |
|
||
| `journal` | 13 | 日志、接收方、日志对象、审计事件 |
|
||
|
||
### 系统（ibmi-system 插件）
|
||
|
||
#### 核心系统
|
||
|
||
| 技能 | 工具数 | 描述 |
|
||
|-------|-------|-------------|
|
||
| `work-management` | 15 | 作业、子系统、锁、作业队列、计划作业、已结束作业、SQL 活动 |
|
||
| `storage` | 9 | ASP、磁盘单元、临时存储、NVMe、用户存储 |
|
||
| `backup-and-recovery` | 5 | 保存文件、媒体库、磁带盒 |
|
||
| `communication` | 11 | 网络连接、路由、HTTP 服务器、TCP/IP、数据库连接、DNS |
|
||
| `application` | 13 | 命令、数据区域、数据队列、程序、事务、调用堆栈 |
|
||
|
||
#### 运维与监控
|
||
|
||
| 技能 | 工具数 | 描述 |
|
||
|-------|-------|-------------|
|
||
| `spool` | 9 | 输出队列、假脱机文件、假脱机消费者 |
|
||
| `ptf` | 11 | PTF 现状、组、固件、说明信、问题 PTF |
|
||
| `message-handling` | 8 | 消息队列、历史日志、回复列表、作业日志 |
|
||
| `system-health` | 8 | 系统状态、内存池、磁盘、限制 |
|
||
| `performance` | 7 | 采集服务、临时存储、I/O 指标 |
|
||
|
||
#### 安全与基础设施
|
||
|
||
| 技能 | 工具数 | 描述 |
|
||
|-------|-------|-------------|
|
||
| `security` | 17 | 用户配置文件、权限、证书、漏洞评估、授权列表 |
|
||
| `librarian` | 7 | 库列表、授权列表、对象权限 |
|
||
| `configuration` | 7 | 系统值、硬件、JVM 信息 |
|
||
| `product` | 5 | 软件产品、许可证 |
|
||
|
||
### 专项
|
||
|
||
| 技能 | 工具数 | 描述 |
|
||
|-------|-------|-------------|
|
||
| `java` | 5 | JVM 监控、堆/GC 分析 |
|
||
| `ifs` | 10 | IFS 浏览、搜索、权限、文件读取、比较 |
|
||
| `migrate-while-active` | 9 | 迁移状态、库/IFS 跟踪 |
|
||
| `journal` | 13 | 日志、接收方、日志对象、审计事件 |
|
||
| `mirror` | 12 | Db2 Mirror 状态、复制、NRG、重克隆 |
|
||
|
||
**合计：24 个技能，219+ 个工具**
|
||
|
||
## 管理技能
|
||
|
||
```bash
|
||
# 列出已安装的技能
|
||
npx skills list
|
||
|
||
# 检查更新
|
||
npx skills check
|
||
|
||
# 更新所有技能
|
||
npx skills update
|
||
|
||
# 移除某个技能
|
||
npx skills remove work-management
|
||
```
|
||
|
||
## 创建基础技能
|
||
|
||
技能创建非常简单——只需一个包含 YAML 前置元数据和说明的 `SKILL.md` 文件的文件夹：
|
||
|
||
```markdown
|
||
---
|
||
name: my-skill-name
|
||
description: 清晰描述该技能的功能及使用场景
|
||
---
|
||
|
||
# 我的技能名称
|
||
|
||
[Agent 激活此技能后将遵循的指令]
|
||
```
|
||
|
||
详细指南请参考 [skill-creator](./skills/skill-creator/) 技能，完整规范见 [Agent Skills 文档](https://agentskills.io/home)。
|
||
|
||
## 许可证
|
||
|
||
Apache-2.0 |