统一的 AI 技能开发流水线，维护符合 Agent Skills 开放标准 的可复用技能，实现跨平台无缝兼容。技能遵循一次编写，到处运行原则——在 Claude Code、OpenAI Codex、Cursor 及其他兼容平台上表现完全一致。

核心特性

• 🔄 统一技能库 – 单一代码库支持多个 AI 平台
• 📋 开放标准 – 遵循 agentskills.io 规范
• 🚀 系统级安装 – 通过安装器使技能在任何项目中可用
• 🎯 有机更新 – 遵循 SOLID、KISS、YAGNI、DRY 原则
• 📚 渐进披露 – 三层架构：元数据 → 操作 → 知识
• 🔍 语义发现 – 基于自然语言意图触发技能

平台兼容性

推荐开发环境

💡 VS Code + Claude Code / Codex 插件

为获得最佳技能开发体验，我们推荐使用 VS Code 配合 Claude Code 或 Codex 插件。

为什么选择这个组合？

项目结构

skills/
├── AGENTS.md              # 核心项目指令（工程原则）
├── CLAUDE.md              # Claude Code 特定配置
├── README.md              # 中文说明（本文件）
├── README_EN.md           # 英文说明
│
├── @install/              # 快速安装脚本（一键安装）
│   ├── install.sh        # macOS/Linux/WSL
│   ├── install.ps1       # Windows PowerShell
│   ├── install.bat       # Windows CMD
│   └── README.md         # 安装说明
│
├── init-project/          # 技能：项目文档生成器
│   ├── SKILL.md          # 技能定义（面向 AI）
│   ├── README.md         # 用户指南（面向人类）
│   ├── config.yaml       # 配置参数
│   ├── scripts/          # 自动化脚本
│   │   └── generate.py   # 生成 AGENTS.md + CLAUDE.md
│   └── templates/        # 文档模板
│
├── install-bensz-skills/  # 技能：系统级安装器
│   ├── SKILL.md          # 技能定义
│   ├── README.md         # 用户指南
│   ├── CHANGELOG.md      # 更新日志
│   ├── config.yaml       # 配置参数
│   └── scripts/          # 安装脚本
│
├── git-commit/            # 技能：智能 Git 提交
│   ├── SKILL.md          # 技能定义
│   ├── README.md         # 用户指南
│   └── scripts/          # 自动化脚本
│
├── git-publish-release/   # 技能：GitHub 发布
│   ├── SKILL.md          # 技能定义
│   ├── README.md         # 用户指南
│   └── scripts/          # 自动化脚本
│
├── auto-test-skill/       # 技能：技能级自动测试
│   ├── SKILL.md          # 技能定义
│   ├── README.md         # 用户指南
│   ├── config.yaml       # 配置参数
│   └── scripts/          # 测试脚本
│
└── auto-test-project/     # 技能：项目级自动测试
    ├── SKILL.md          # 技能定义
    ├── README.md         # 用户指南
    └── config.yaml       # 配置参数

快速开始

🚀 如何安装本项目的 skill

方法一：一键快速安装（推荐）

无需克隆项目，一行命令完成安装！

安装完成后，技能将自动安装到：

• ~/.claude/skills/ (Claude Code)
• ~/.codex/skills/ (OpenAI Codex)

方法二：本地安装

第一步：克隆本项目

git clone https://github.com/huangwb8/skills.git
cd skills

第二步：本项目的根目录打开 Claude Code 或 Codex，输入：

"install-bensz-skills 这个 skill 将本项目里的 skill 安装到 Codex 和 Claude Code 里"

就这么简单！所有 skill 将被安装到系统级，可在任何项目中使用。

方法三：手动安装

# 进入项目目录
cd skills

# 运行安装脚本
python3 install-bensz-skills/scripts/install.py --claude --codex

🎯 如何使用本项目的 skills

在 Claude Code 或 Codex 中打开本项目，直接使用自然语言触发技能：

# 项目初始化
"init-project 这个 skill 帮我初始化项目"

# 系统级安装
"install-bensz-skills 这个 skill 将本项目里的 skill 安装到 Codex 和 Claude Code 里"

# 自动化测试
"auto-test-skill 这个 skill 帮我测试 init-project 这个 skill"

就是这么简单！ 自然语言编程才是 Vibe Coding 的灵魂！

技能开发

文件结构

my-skill/
├── SKILL.md           # 必需：AI 指令（包含 YAML frontmatter）
├── README.md          # 推荐：用户指南
├── config.yaml        # 推荐：配置参数
├── CHANGELOG.md       # 可选：版本历史
├── references/        # 可选：详细文档
│   └── advanced-guide.md
└── scripts/           # 可选：自动化脚本
    └── process.py

快速创建

mkdir my-new-skill
cd my-new-skill
touch SKILL.md README.md config.yaml

架构层次

...