# AI工作流插件集合

`Claude Code` `Codex` `插件` `AI工具` `开发效率`

# abpai/skills — Claude Code 市场 + Codex 插件仓库

一个可复用的 AI 工作流插件与技能集合，涵盖结构化规划、跨领域思维、多模型工具链及开发者生产力提升。

本仓库现已为两种运行时提供元数据：

- Claude Code 插件：通过 `.claude-plugin/plugin.json` 及根目录 Claude 市场
- Codex 插件：通过 `.codex-plugin/plugin.json` 及 `.agents/plugins/marketplace.json` 中的仓库级 Codex 市场

## 快速开始

### Claude Code

```bash
# 添加市场（仅需一次）
/plugin marketplace add abpai/skills

# 安装规划类技能
/plugin install distill@abpai-skills
/plugin install lateral-thinking@abpai-skills
/plugin install codex-exec@abpai-skills
/plugin install pi@abpai-skills
```

### Codex

Codex 目前支持仓库级和个人本地市场。本仓库在 `.agents/plugins/marketplace.json` 中提供了一个仓库市场，通过本地 `source.path` 条目指向顶层插件目录。

```bash
git clone https://github.com/abpai/skills.git
cd skills
codex
```

在本仓库中启动或重启 Codex，打开插件目录，从本次检出暴露的仓库市场安装插件。

Codex 公共插件目录发布功能仍在规划中，因此本仓库的 Codex 路径为仓库本地模式，而非上述 Claude 风格的远程市场流程。

`pi` 插件有意从本仓库的 Codex 市场中排除。它是一个 Claude 原生插件，通过调用 `codex` CLI 进行第二方研究与审查，而非安装到 Codex 本身。

## 插件列表

### 规划与推理

| 插件 | 功能描述 | 独立使用？ |
|------|---------|-----------|
| **distill** | 将复杂系统分解为核心原语，适用于代码库、论文、对话记录。 | 是 |
| **lateral-thinking** | 跨领域假设生成，从遥远领域中挖掘可迁移的机制。 | 是 |
| **codex-exec** | 将提示词委托给 OpenAI Codex CLI 进行二次意见与对抗性审查。 | 是 |
| **pi** | Claude 原生的规划/生成/评估框架，用于长周期工程任务，在关键节点可选接入 Codex 批评。 | 仅 Claude |

### 代码质量

| 插件 | 功能描述 |
|------|---------|
| **code-simplifier** | 简化并优化代码，提升清晰度、一致性与可维护性 |
| **dead-code-eliminator** | 审计不可达函数、未使用导入、孤立类及过期标志 |
| **review-and-commit** | 审查未提交的变更，并准备安全的原子提交 |

### 开发者生产力

| 插件 | 功能描述 |
|------|---------|
| **debate** | 结构化架构辩论：Claude 提出方案，Codex 批评，Claude 综合 |
| **cli-design-expert** | 设计或审查 CLI 的可用性：标志、退出码、TTY 行为 |
| **project-memory** | 通过 `.agents/LEARNINGS.md` 实现常驻记忆——错误、模式与偏好 |
| **scratch** | 通过可运行的 `.scratch/` 探索脚本理解项目内部机制 |
| **socratic-code-owner** | 向开发者提问 AI 生成的代码，确保其真正理解 |

### 工具

| 插件 | 功能描述 |
|------|---------|
| **agent-browser** | 浏览器自动化：导航、填表、点击、截图、数据提取 |
| **beautiful-mermaid** | 将 Mermaid 图表渲染为 SVG 和 PNG |
| **claude** | 运行 Claude Code CLI，用于任务委托、会话续接、机器可读输出 |
| **try** | 在采用新库、工具或仓库之前进行评估——提示驱动的演示 |
| **visualize** | 为系统、计划或代码流程生成自包含的 HTML 可视化 |

### 语言与平台

| 插件 | 功能描述 |
|------|---------|
| **bun-expert** | Bun 运行时专家指导：配置、服务器、API、测试、Node.js 迁移 |
| **dokploy** | 通过 CLI 操作 Dokploy：项目、环境、应用、数据库 |

### 写作

| 插件 | 功能描述 |
|------|---------|
| **human-writer** | 编辑文章使其读起来自然、像人写的——去除模型生成文本的痕迹 |

## 仓库结构

```
abpai/skills/
├── .agents/plugins/
│   └── marketplace.json       ← Codex 仓库市场
├── .claude-plugin/
│   └── marketplace.json       ← Claude 市场目录
├── <plugin>/                  ← 大多数插件同时支持两种运行时
│   ├── .claude-plugin/plugin.json
│   ├── .codex-plugin/plugin.json  ← 可安装到 Codex 时可选
│   └── skills/<plugin>/
│       ├── SKILL.md
│       └── references/        （如有）
├── pi/                        ← 有意设计为仅 Claude 的例外
│   ├── .claude-plugin/plugin.json
│   ├── agents/
│   ├── commands/
│   └── skills/pi-protocol/
└── README.md
```

在每个插件目录中，只有 `plugin.json` 放在 `.claude-plugin/` 内。`skills/`、`agents/`、`commands/` 和 `hooks/` 保留在插件根目录。

## 安装插件

### Claude Code

#### 从市场安装

```bash
# 添加市场（仅需一次）
/plugin marketplace add abpai/skills

# 浏览可用插件
/plugin

# 安装插件（默认用户作用域）
claude plugin install distill@abpai-skills

# 安装到项目作用域（通过 .claude/settings.json 与团队共享）
claude plugin install distill@abpai-skills --scope project

# 安装到本地作用域（gitignore，个人使用）
claude plugin install distill@abpai-skills --scope local
```

#### 从本地检出安装

```bash
# 不安装直接测试单个插件
claude --plugin-dir ./distill

# 同时加载多个插件
claude --plugin-dir ./distill --plugin-dir ./lateral-thinking
```

在运行中的会话内，使用 `/reload-plugins` 无需重启即可加载变更。

#### 卸载

```bash
claude plugin uninstall distill@abpai-skills
```

### Codex

#### 从本仓库安装（仓库级市场）

本仓库在 `.agents/plugins/marketplace.json` 中提供了带本地 `source.path` 条目的 Codex 市场。克隆仓库并在其中启动 Codex：

```bash
git clone https://github.com/abpai/skills.git
cd skills
codex
```

使用 `codex /plugins` 打开插件目录——所有 18 个 Codex 兼容插件会自动从仓库市场中显示。

#### 个人安装

将插件复制到个人插件目录并在个人市场中注册：

```bash
# 复制插件
mkdir -p ~/.codex/plugins
cp -R ./distill ~/.codex/plugins/distill

# 添加到个人市场（~/.agents/plugins/marketplace.json）
# 每条记录需要 name、source.path 和 policy：
```

```json
{
  "name": "my-plugins",
  "plugins": [
    {
      "name": "distill",
      "source": { "source": "local", "path": "./.codex/plugins/distill" },
      "policy": { "installation": "AVAILABLE" },
      "category": "Productivity"
    }
  ]
}
```

重启 Codex 以加载新插件。

#### 禁用 / 重新启用

在 `~/.codex/config.toml` 中切换单个插件：

```toml
[plugins.distill]
enabled = false
```

## 插件验证

### Claude Code 内置验证

```bash
# 验证单个插件清单
claude plugin validate ./distill

# 验证所有插件
for dir in */; do
  [ -f "$dir.claude-plugin/plugin.json" ] && claude plugin validate "./$dir"
done
```

### Codex

Codex 目前没有内置的 `validate` 命令。请使用下方的项目验证脚本，它会同时检查 Claude 和 Codex 的清单。

### 项目验证脚本

本仓库在 `scripts/validate-skills.sh` 中提供了一个综合验证器，检查内容包括：

- Claude 和 Codex 插件清单（名称、版本、描述、路径）
- SKILL.md 前置信息（名称、描述、metadata.version）
- Agent 和命令前置信息
- 两个 marketplace.json 目录（完整性与一致性）
- versions.json（所有技能均存在且版本匹配）

```bash
bash scripts/validate-skills.sh
```

该脚本也会作为 pre-commit 钩子自动运行。

## 安全扫描

本仓库通过 pre-commit 集成了 [Cisco Skill Scanner](https://github.com/cisco-ai-defense/skill-scanner)。

1. 安装 pre-commit：`uv tool install pre-commit`
2. 安装钩子：`uvx pre-commit install`
3. （可选）将 `.env.example` 复制为 `.env` 并自定义扫描器设置
4. 手动运行：`uvx pre-commit run --all-files`

## 许可证

MIT