mc-skills/catalog

Fork 0

mc-skills 52efc07510 catalog: 更新 2026-04-07 11:44

2026-04-07 11:44:56 +08:00

6.8 KiB

Raw Permalink Blame History

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 安装技能，支持 Claude Code、Cursor、GitHub Copilot 及其他 40+ 个 Agent。

# 从 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

示例

# 仅安装到 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 连接到你的 Agent，提供以下能力：

describe_sql_object — 获取 IBM i 对象的 DDL/元数据
execute_sql — 在 IBM i 上执行 SQL SELECT 语句

配置 MCP 服务器

在 Agent 的 MCP 配置文件中添加以下内容（Claude Code 对应 .mcp.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 提供直接工具执行能力：

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+ 个工具

管理技能

# 列出已安装的技能
npx skills list

# 检查更新
npx skills check

# 更新所有技能
npx skills update

# 移除某个技能
npx skills remove work-management

创建基础技能

技能创建非常简单——只需一个包含 YAML 前置元数据和说明的 SKILL.md 文件的文件夹：

---
name: my-skill-name
description: 清晰描述该技能的功能及使用场景
---

# 我的技能名称

[Agent 激活此技能后将遵循的指令]

详细指南请参考 skill-creator 技能，完整规范见 Agent Skills 文档。

许可证

Apache-2.0

6.8 KiB Raw Permalink Blame History Unescape Escape