7.9 KiB
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
# 添加市场（仅需一次）
/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 条目指向顶层插件目录。
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
从市场安装
# 添加市场（仅需一次）
/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
从本地检出安装
# 不安装直接测试单个插件
claude --plugin-dir ./distill
# 同时加载多个插件
claude --plugin-dir ./distill --plugin-dir ./lateral-thinking
在运行中的会话内，使用 /reload-plugins 无需重启即可加载变更。
卸载
claude plugin uninstall distill@abpai-skills
Codex
从本仓库安装（仓库级市场）
本仓库在 .agents/plugins/marketplace.json 中提供了带本地 source.path 条目的 Codex 市场。克隆仓库并在其中启动 Codex：
git clone https://github.com/abpai/skills.git
cd skills
codex
使用 codex /plugins 打开插件目录——所有 18 个 Codex 兼容插件会自动从仓库市场中显示。
个人安装
将插件复制到个人插件目录并在个人市场中注册：
# 复制插件
mkdir -p ~/.codex/plugins
cp -R ./distill ~/.codex/plugins/distill
# 添加到个人市场（~/.agents/plugins/marketplace.json）
# 每条记录需要 name、source.path 和 policy：
{
"name": "my-plugins",
"plugins": [
{
"name": "distill",
"source": { "source": "local", "path": "./.codex/plugins/distill" },
"policy": { "installation": "AVAILABLE" },
"category": "Productivity"
}
]
}
重启 Codex 以加载新插件。
禁用 / 重新启用
在 ~/.codex/config.toml 中切换单个插件：
[plugins.distill]
enabled = false
插件验证
Claude Code 内置验证
# 验证单个插件清单
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 scripts/validate-skills.sh
该脚本也会作为 pre-commit 钩子自动运行。
安全扫描
本仓库通过 pre-commit 集成了 Cisco Skill Scanner。
- 安装 pre-commit：
uv tool install pre-commit - 安装钩子：
uvx pre-commit install - （可选）将
.env.example复制为.env并自定义扫描器设置 - 手动运行：
uvx pre-commit run --all-files
许可证
MIT