# 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