一套面向 AI 编码代理（Claude、Bob、Gemini、OpenCode、Codex、agy）的技能集合，提供为开源项目贡献的指导。这些技能通过 git remote get-url origin 自动检测当前项目，并从规则文件加载项目特定配置。

对于原生支持技能的代理（Claude、Bob、Codex、agy），助手被安装为6个面向用户的技能——只需描述你想做的事情（或直接调用/oss-*），代理会自动遵循相应的指南。对于其他代理（Gemini、OpenCode），单个命令是根据相同的指南生成的。

开始

任何项目都可以通过在其仓库根节点添加一个 .oss-ai-helper-rules/ 目录，并包含三个规则文件来使用该辅助工具：

使用添加项目指南为任何项目生成初始规则文件。一旦提交，每个贡献者会自动获得正确的配置——无需为每个用户安装项目专属规则。

安装

快速安装（所有代理）

选择性安装

工作原理

助手提供的指导原则与项目无关。

AI Agents OSS Helper

A collection of skills for AI coding agents (Claude, Bob, Gemini, OpenCode, Codex, agy) that provides guidelines for contributing to open source projects. The skills auto-detect the current project via git remote get-url origin and load project-specific configuration from rule files.

For agents that support skills natively (Claude, Bob, Codex, agy), the helper is installed as 6 focused, user-invocable skills — just describe what you want to do (or invoke /oss-* directly) and the agent follows the appropriate guidelines automatically. For other agents (Gemini, OpenCode), individual commands are generated from the same guidelines.

Documentation

Browse the full command and workflow reference at open-harness-engineering.github.io/ai-agents-oss-helper, generated from the guidelines and published via GitHub Pages.

Getting Started

Any project can use the helper by adding an .oss-ai-helper-rules/ directory to its repository root with three rule files:

my-project/
├── .oss-ai-helper-rules/
│   ├── project-info.md          # Repository URLs, issue trackers, related repos
│   ├── project-standards.md     # Build tools, commands, code style restrictions
│   └── project-guidelines.md    # Branch naming, commit formats, PR policies
└── ...

Use the Add Project guideline to generate initial rule files for any project. Once committed, every contributor gets the right configuration automatically — no per-user installation of project-specific rules required.

Installation

Quick Install (All Agents)

curl -fsSL https://raw.githubusercontent.com/Open-Harness-Engineering/ai-agents-oss-helper/main/install.sh | bash

Selective Install

# Clone the repository
git clone https://github.com/Open-Harness-Engineering/ai-agents-oss-helper.git
cd ai-agents-oss-helper

# Install for specific agent
./install.sh claude    # Claude only
./install.sh bob       # Bob only
./install.sh gemini    # Gemini CLI only
./install.sh opencode  # OpenCode only
./install.sh codex     # Codex only
./install.sh agy       # agy only
./install.sh           # All agents

Installing a specific version

By default the installer fetches the latest assets from main. To install from a published release tag instead, pass --version (or set the OSS_HELPER_VERSION environment variable). This applies to remote (curl | bash) installs:

# Pin a release with a flag
curl -fsSL https://raw.githubusercontent.com/Open-Harness-Engineering/ai-agents-oss-helper/main/install.sh | bash -s -- --version v1.0.0

# ...or with an environment variable
curl -fsSL https://raw.githubusercontent.com/Open-Harness-Engineering/ai-agents-oss-helper/main/install.sh | OSS_HELPER_VERSION=v1.0.0 bash

A local ./install.sh run installs the files from your current checkout, so to pin a version from a clone, check out the tag first (git checkout v1.0.0).