npm - add-ai-tools - Versions diffs - 1.1.1 → 1.1.2 - Mend

add-ai-tools 1.1.1 → 1.1.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (5) hide show

package/README.ja.md ADDED Viewed

@@ -0,0 +1,194 @@
+# add-ai-tools
+様々なソースからAIエージェントリソース（Skills、Rules、Agents）を単一のコマンドでインストールできる汎用CLIツールです。
+**[English](./README.md)** | **[한국어](./README.ko.md)** | **[中文](./README.zh-CN.md)**
+## 概要
+`add-ai-tools`はAIコーディングアシスタントリソースの管理を簡素化します。GitHubまたはBitbucketリポジトリからリソースを取得し、お好みのAIエージェントに適切な場所にインストールします。
+### 主な機能
+- **マルチソース対応** - GitHub、Bitbucket、Git SSH URLからインストール
+- **マルチエージェント対応** - Claude Code、Cursor、GitHub Copilot、Antigravityに対応
+- **インタラクティブモード** - リソース選択をガイドするプロンプト
+- **ZIPエクスポート** - リソースをポータブルなZIPアーカイブとしてエクスポート
+- **スマートな重複処理** - スキップ、上書き、リネーム、バックアップ、比較オプション
+- **一括インストール** - 複数のリソースを一度にインストール
+## インストール
+```bash
+# グローバルインストール
+npm install -g add-ai-tools
+# またはnpxで直接使用
+npx add-ai-tools
+```
+## クイックスタート
+### GitHubからインストール
+```bash
+# GitHub省略形を使用
+npx add-ai-tools owner/repo
+# 完全なGitHub URLを使用
+npx add-ai-tools https://github.com/owner/repo
+# 特定のパスからリソースをインストール
+npx add-ai-tools https://github.com/owner/repo/tree/main/skills/my-skill
+```
+### インタラクティブモード
+```bash
+npx add-ai-tools
+```
+インタラクティブモードは以下の手順をガイドします：
+1. AIエージェントの選択（Claude Code、Cursorなど）
+2. ソースリポジトリの入力
+3. リソースタイプの選択（Skills、Rules、Agents）
+4. インストールする特定のリソースの選択
+5. インストールスコープの選択（プロジェクトまたはグローバル）
+### ZIPとしてエクスポート
+```bash
+# インタラクティブプロンプトでエクスポート
+npx add-ai-tools owner/repo --zip
+# プロンプトなしで全リソースをエクスポート
+npx add-ai-tools owner/repo --zip -y
+```
+## 対応ソース
+| 形式 | 例 | 状態 |
+|------|-----|:----:|
+| GitHub省略形 | `owner/repo` | ✓ |
+| GitHub URL | `https://github.com/owner/repo` | ✓ |
+| パス付きGitHub URL | `https://github.com/owner/repo/tree/main/skills/my-skill` | ✓ |
+| Bitbucket URL | `https://bitbucket.org/workspace/repo` | ✓ |
+| Git SSH (GitHub) | `git@github.com:owner/repo.git` | ✓ |
+| Git SSH (Bitbucket) | `git@bitbucket.org:owner/repo.git` | ✓ |
+| GitLab URL | `https://gitlab.com/owner/repo` | 近日対応予定 |
+## コマンドラインオプション
+| オプション | 説明 | デフォルト |
+|------------|------|-----------|
+| `[source]` | リポジトリURLまたは省略形（オプション） | - |
+| `--agent <agent>` | ターゲットエージェント | `claude-code` |
+| `--scope <scope>` | インストールスコープ（`project`または`global`） | `project` |
+| `-y, --yes` | すべての確認プロンプトをスキップ | `false` |
+| `--zip` | インストールの代わりにZIPとしてリソースをエクスポート | `false` |
+| `-h, --help` | ヘルプ情報を表示 | - |
+| `-V, --version` | バージョン番号を表示 | - |
+### 利用可能なエージェント
+- `claude-code` - Claude Code（Anthropic）
+- `cursor` - Cursor IDE
+- `github-copilot` - GitHub Copilot
+- `antigravity` - Antigravity
+## 対応エージェントとリソース
+| エージェント | Skills | Rules | Agents |
+|-------------|:------:|:-----:|:------:|
+| Claude Code | ✓ | ✓ | ✓ |
+| Cursor | ✓ | ✓ | - |
+| GitHub Copilot | ✓ | ✓ | - |
+| Antigravity | ✓ | ✓ | - |
+## インストールパス
+リソースはエージェント固有の場所にインストールされます：
+| エージェント | プロジェクトスコープ | グローバルスコープ |
+|-------------|---------------------|-------------------|
+| Claude Code | `.claude/skills/`、`.claude/rules/`、`.claude/agents/` | `~/.claude/skills/`、`~/.claude/rules/`、`~/.claude/agents/` |
+| Cursor | `.cursor/skills/`、`.cursor/rules/` | `~/.cursor/skills/`、`~/.cursor/rules/` |
+| GitHub Copilot | `.github/skills/`、`.github/instructions/` | `~/.copilot/skills/`、`~/.copilot/instructions/` |
+| Antigravity | `.agent/skills/`、`.agent/rules/` | `~/.gemini/antigravity/skills/`、`~/.gemini/antigravity/rules/` |
+## リソース構造
+リソースは標準的な構造に従います：
+```
+skill-name/
+├── SKILL.md           # メインスキルファイル（必須）
+├── scripts/           # 実行可能なスクリプト（オプション）
+├── references/        # 参考ドキュメント（オプション）
+└── assets/            # 静的アセット（オプション）
+```
+このツールはリソースのインストール時に兄弟ディレクトリ（`scripts/`、`references/`、`assets/`）を自動的に処理します。
+## 重複処理
+インストール先にリソースが既に存在する場合、以下を選択できます：
+| アクション | 説明 |
+|-----------|------|
+| **スキップ** | 既存のファイルを変更せずに保持 |
+| **上書き** | 新しいバージョンで置き換え |
+| **リネーム** | 新しい名前で保存（例：`skill-2`、`skill-3`） |
+| **バックアップ** | 置き換え前に既存ファイルの`.backup`を作成 |
+| **比較** | 差分比較を表示して決定 |
+同一の内容は自動的に検出されスキップされます。
+## 使用例
+```bash
+# 人気リポジトリからすべてのリソースをインストール
+npx add-ai-tools vercel-labs/ai-chatbot
+# グローバルスコープでCursorにインストール
+npx add-ai-tools owner/repo --agent cursor --scope global
+# プロンプトなしでインストール（すべてのデフォルト値を受け入れ）
+npx add-ai-tools owner/repo -y
+# インタラクティブモード - 引数不要
+npx add-ai-tools
+# 共有用にリソースをZIPとしてエクスポート
+npx add-ai-tools owner/repo --zip
+# プロンプトなしで全リソースをエクスポート
+npx add-ai-tools owner/repo --zip -y
+# Bitbucketからインストール
+npx add-ai-tools https://bitbucket.org/workspace/repo
+# サブディレクトリから特定のスキルをインストール
+npx add-ai-tools https://github.com/owner/repo/tree/main/skills/code-review
+```
+## 動作の仕組み
+1. **ソースの解析** - 入力（省略形、URL、SSH）を解析してリポジトリを識別
+2. **リソースの取得** - Git Trees APIを使用してリポジトリ構造を効率的に取得
+3. **メタデータの解析** - リソースファイルからYAML frontmatterを抽出（名前、説明など）
+4. **重複の処理** - 既存のリソースを確認し、必要に応じてアクションをプロンプト
+5. **インストール** - 正しいエージェント固有の場所にファイルをアトミックに書き込み
+## 必要要件
+- Node.js 18.0.0以上
+- npmまたはpnpm
+## コントリビューション
+コントリビューションを歓迎します！IssueやPull Requestをお気軽に提出してください。
+## ライセンス
+MIT

package/README.ko.md ADDED Viewed

@@ -0,0 +1,194 @@
+# add-ai-tools
+다양한 소스에서 AI 에이전트 리소스(Skills, Rules, Agents)를 단일 명령으로 설치하는 범용 CLI 도구입니다.
+**[English](./README.md)** | **[中文](./README.zh-CN.md)** | **[日本語](./README.ja.md)**
+## 개요
+`add-ai-tools`는 AI 코딩 어시스턴트 리소스 관리를 단순화합니다. GitHub, Bitbucket 저장소에서 리소스를 가져와 선호하는 AI 에이전트에 맞는 위치에 설치합니다.
+### 주요 기능
+- **다중 소스 지원** - GitHub, Bitbucket, Git SSH URL에서 설치
+- **다중 에이전트 지원** - Claude Code, Cursor, GitHub Copilot, Antigravity 지원
+- **대화형 모드** - 쉬운 리소스 선택을 위한 가이드 프롬프트
+- **ZIP 내보내기** - 휴대 가능한 ZIP 아카이브로 리소스 내보내기
+- **스마트 중복 처리** - 건너뛰기, 덮어쓰기, 이름 변경, 백업, 비교 옵션
+- **일괄 설치** - 여러 리소스를 한 번에 설치
+## 설치
+```bash
+# 전역 설치
+npm install -g add-ai-tools
+# 또는 npx로 직접 사용
+npx add-ai-tools
+```
+## 빠른 시작
+### GitHub에서 설치
+```bash
+# GitHub 축약형 사용
+npx add-ai-tools owner/repo
+# 전체 GitHub URL 사용
+npx add-ai-tools https://github.com/owner/repo
+# 특정 경로의 리소스 설치
+npx add-ai-tools https://github.com/owner/repo/tree/main/skills/my-skill
+```
+### 대화형 모드
+```bash
+npx add-ai-tools
+```
+대화형 모드는 다음 단계를 안내합니다:
+1. AI 에이전트 선택 (Claude Code, Cursor 등)
+2. 소스 저장소 입력
+3. 리소스 유형 선택 (Skills, Rules, Agents)
+4. 설치할 특정 리소스 선택
+5. 설치 범위 선택 (프로젝트 또는 전역)
+### ZIP으로 내보내기
+```bash
+# 대화형 프롬프트로 내보내기
+npx add-ai-tools owner/repo --zip
+# 프롬프트 없이 모든 리소스 내보내기
+npx add-ai-tools owner/repo --zip -y
+```
+## 지원되는 소스
+| 형식 | 예시 | 상태 |
+|------|------|:----:|
+| GitHub 축약형 | `owner/repo` | ✓ |
+| GitHub URL | `https://github.com/owner/repo` | ✓ |
+| 경로 포함 GitHub URL | `https://github.com/owner/repo/tree/main/skills/my-skill` | ✓ |
+| Bitbucket URL | `https://bitbucket.org/workspace/repo` | ✓ |
+| Git SSH (GitHub) | `git@github.com:owner/repo.git` | ✓ |
+| Git SSH (Bitbucket) | `git@bitbucket.org:owner/repo.git` | ✓ |
+| GitLab URL | `https://gitlab.com/owner/repo` | 준비 중 |
+## 명령줄 옵션
+| 옵션 | 설명 | 기본값 |
+|------|------|--------|
+| `[source]` | 저장소 URL 또는 축약형 (선택사항) | - |
+| `--agent <agent>` | 대상 에이전트 | `claude-code` |
+| `--scope <scope>` | 설치 범위 (`project` 또는 `global`) | `project` |
+| `-y, --yes` | 모든 확인 프롬프트 건너뛰기 | `false` |
+| `--zip` | 설치 대신 ZIP으로 리소스 내보내기 | `false` |
+| `-h, --help` | 도움말 정보 표시 | - |
+| `-V, --version` | 버전 번호 표시 | - |
+### 사용 가능한 에이전트
+- `claude-code` - Claude Code (Anthropic)
+- `cursor` - Cursor IDE
+- `github-copilot` - GitHub Copilot
+- `antigravity` - Antigravity
+## 지원 에이전트 및 리소스
+| 에이전트 | Skills | Rules | Agents |
+|---------|:------:|:-----:|:------:|
+| Claude Code | ✓ | ✓ | ✓ |
+| Cursor | ✓ | ✓ | - |
+| GitHub Copilot | ✓ | ✓ | - |
+| Antigravity | ✓ | ✓ | - |
+## 설치 경로
+리소스는 에이전트별 위치에 설치됩니다:
+| 에이전트 | 프로젝트 범위 | 전역 범위 |
+|---------|--------------|----------|
+| Claude Code | `.claude/skills/`, `.claude/rules/`, `.claude/agents/` | `~/.claude/skills/`, `~/.claude/rules/`, `~/.claude/agents/` |
+| Cursor | `.cursor/skills/`, `.cursor/rules/` | `~/.cursor/skills/`, `~/.cursor/rules/` |
+| GitHub Copilot | `.github/skills/`, `.github/instructions/` | `~/.copilot/skills/`, `~/.copilot/instructions/` |
+| Antigravity | `.agent/skills/`, `.agent/rules/` | `~/.gemini/antigravity/skills/`, `~/.gemini/antigravity/rules/` |
+## 리소스 구조
+리소스는 표준 구조를 따릅니다:
+```
+skill-name/
+├── SKILL.md           # 메인 스킬 파일 (필수)
+├── scripts/           # 실행 가능한 스크립트 (선택)
+├── references/        # 참조 문서 (선택)
+└── assets/            # 정적 자산 (선택)
+```
+이 도구는 리소스 설치 시 형제 디렉토리(`scripts/`, `references/`, `assets/`)를 자동으로 처리합니다.
+## 중복 처리
+목적지에 이미 리소스가 존재할 때 선택할 수 있는 옵션:
+| 동작 | 설명 |
+|------|------|
+| **건너뛰기** | 기존 파일을 변경하지 않고 유지 |
+| **덮어쓰기** | 새 버전으로 교체 |
+| **이름 변경** | 새 이름으로 저장 (예: `skill-2`, `skill-3`) |
+| **백업** | 교체 전 기존 파일의 `.backup` 생성 |
+| **비교** | 차이점 비교 후 결정 |
+동일한 내용은 자동으로 감지되어 건너뜁니다.
+## 예시
+```bash
+# 인기 저장소에서 모든 리소스 설치
+npx add-ai-tools vercel-labs/ai-chatbot
+# 전역 범위로 Cursor에 설치
+npx add-ai-tools owner/repo --agent cursor --scope global
+# 프롬프트 없이 설치 (모든 기본값 수락)
+npx add-ai-tools owner/repo -y
+# 대화형 모드 - 인자 필요 없음
+npx add-ai-tools
+# 공유를 위해 리소스를 ZIP으로 내보내기
+npx add-ai-tools owner/repo --zip
+# 프롬프트 없이 모든 리소스 내보내기
+npx add-ai-tools owner/repo --zip -y
+# Bitbucket에서 설치
+npx add-ai-tools https://bitbucket.org/workspace/repo
+# 하위 디렉토리에서 특정 스킬 설치
+npx add-ai-tools https://github.com/owner/repo/tree/main/skills/code-review
+```
+## 작동 방식
+1. **소스 파싱** - 입력(축약형, URL, SSH)을 파싱하여 저장소 식별
+2. **리소스 가져오기** - Git Trees API를 사용하여 저장소 구조를 효율적으로 가져오기
+3. **메타데이터 파싱** - 리소스 파일에서 YAML frontmatter 추출 (이름, 설명 등)
+4. **중복 처리** - 기존 리소스 확인 및 필요시 동작 프롬프트
+5. **설치** - 올바른 에이전트별 위치에 파일을 원자적으로 쓰기
+## 요구 사항
+- Node.js 18.0.0 이상
+- npm 또는 pnpm
+## 기여
+기여를 환영합니다! 이슈와 풀 리퀘스트를 자유롭게 제출해 주세요.
+## 라이선스
+MIT

package/README.md CHANGED Viewed

@@ -1,11 +1,30 @@
 # add-ai-tools
-Install AI agent resources (Skills, Rules, Agents) from various sources with a single command.
+A universal CLI tool for installing AI agent resources (Skills, Rules, Agents) from various sources with a single command.
+**[한국어](./README.ko.md)** | **[中文](./README.zh-CN.md)** | **[日本語](./README.ja.md)**
+## Overview
+`add-ai-tools` simplifies the process of managing AI coding assistant resources. It fetches resources from GitHub or Bitbucket repositories and installs them to the appropriate location for your preferred AI agent.
+### Key Features
+- **Multi-Source Support** - Install from GitHub, Bitbucket, or Git SSH URLs
+- **Multi-Agent Support** - Works with Claude Code, Cursor, GitHub Copilot, and Antigravity
+- **Interactive Mode** - Guided prompts for easy resource selection
+- **ZIP Export** - Export resources as portable ZIP archives
+- **Smart Duplicate Handling** - Skip, overwrite, rename, backup, or compare duplicates
+- **Batch Installation** - Install multiple resources at once
 ## Installation
 ```bash
+# Install globally
 npm install -g add-ai-tools
+# Or use directly with npx
+npx add-ai-tools
 ```
 ## Quick Start
@@ -16,10 +35,10 @@ npm install -g add-ai-tools
 # Using GitHub shorthand
 npx add-ai-tools owner/repo
-# Using GitHub URL
+# Using full GitHub URL
 npx add-ai-tools https://github.com/owner/repo
-# Install specific resource
+# Install specific resource from a path
 npx add-ai-tools https://github.com/owner/repo/tree/main/skills/my-skill
 ```
@@ -29,41 +48,55 @@ npx add-ai-tools https://github.com/owner/repo/tree/main/skills/my-skill
 npx add-ai-tools
 ```
-Follow the prompts to select agent, resource type, and resources to install.
+The interactive mode guides you through:
+1. Selecting your AI agent (Claude Code, Cursor, etc.)
+2. Entering the source repository
+3. Choosing resource types (Skills, Rules, Agents)
+4. Selecting specific resources to install
+5. Choosing installation scope (project or global)
 ### Export as ZIP
 ```bash
-# Export from GitHub source (with prompts)
+# Export with interactive prompts
 npx add-ai-tools owner/repo --zip
-# Interactive source input
-npx add-ai-tools --zip
 # Export all resources without prompts
 npx add-ai-tools owner/repo --zip -y
 ```
 ## Supported Sources
-| Format | Example |
-|--------|---------|
-| GitHub shorthand | `owner/repo` |
-| GitHub URL | `https://github.com/owner/repo` |
-| GitHub URL with path | `https://github.com/owner/repo/tree/main/skills/my-skill` |
-| GitLab URL | `https://gitlab.com/owner/repo` |
-| Git SSH | `git@github.com:owner/repo.git` |
+| Format | Example | Status |
+|--------|---------|:------:|
+| GitHub shorthand | `owner/repo` | ✓ |
+| GitHub URL | `https://github.com/owner/repo` | ✓ |
+| GitHub URL with path | `https://github.com/owner/repo/tree/main/skills/my-skill` | ✓ |
+| Bitbucket URL | `https://bitbucket.org/workspace/repo` | ✓ |
+| Git SSH (GitHub) | `git@github.com:owner/repo.git` | ✓ |
+| Git SSH (Bitbucket) | `git@bitbucket.org:owner/repo.git` | ✓ |
+| GitLab URL | `https://gitlab.com/owner/repo` | Coming Soon |
-## Options
+## Command Line Options
 | Option | Description | Default |
 |--------|-------------|---------|
-| `--agent <agent>` | Target agent (`claude-code`, `cursor`, `github-copilot`, `antigravity`) | `claude-code` |
-| `--scope <scope>` | Installation scope (`project`, `global`) | `project` |
-| `-y, --yes` | Skip confirmation prompts | `false` |
-| `--zip` | Export resources as ZIP | `false` |
+| `[source]` | Repository URL or shorthand (optional) | - |
+| `--agent <agent>` | Target agent | `claude-code` |
+| `--scope <scope>` | Installation scope (`project` or `global`) | `project` |
+| `-y, --yes` | Skip all confirmation prompts | `false` |
+| `--zip` | Export resources as ZIP instead of installing | `false` |
+| `-h, --help` | Display help information | - |
+| `-V, --version` | Display version number | - |
+### Available Agents
-## Supported Agents
+- `claude-code` - Claude Code (Anthropic)
+- `cursor` - Cursor IDE
+- `github-copilot` - GitHub Copilot
+- `antigravity` - Antigravity
+## Supported Agents & Resources
 | Agent | Skills | Rules | Agents |
 |-------|:------:|:-----:|:------:|
@@ -74,49 +107,88 @@ npx add-ai-tools owner/repo --zip -y
 ## Installation Paths
-Resources are installed to the appropriate location for each agent:
+Resources are installed to agent-specific locations:
 | Agent | Project Scope | Global Scope |
 |-------|---------------|--------------|
-| Claude Code | `.claude/` | `~/.claude/` |
-| Cursor | `.cursor/` | `~/.cursor/` |
-| GitHub Copilot | `.github/` | `~/.copilot/` |
-| Antigravity | `.agent/` | `~/.gemini/antigravity/` |
+| Claude Code | `.claude/skills/`, `.claude/rules/`, `.claude/agents/` | `~/.claude/skills/`, `~/.claude/rules/`, `~/.claude/agents/` |
+| Cursor | `.cursor/skills/`, `.cursor/rules/` | `~/.cursor/skills/`, `~/.cursor/rules/` |
+| GitHub Copilot | `.github/skills/`, `.github/instructions/` | `~/.copilot/skills/`, `~/.copilot/instructions/` |
+| Antigravity | `.agent/skills/`, `.agent/rules/` | `~/.gemini/antigravity/skills/`, `~/.gemini/antigravity/rules/` |
+## Resource Structure
+Resources follow a standard structure:
+```
+skill-name/
+├── SKILL.md           # Main skill file (required)
+├── scripts/           # Executable scripts (optional)
+├── references/        # Reference documentation (optional)
+└── assets/            # Static assets (optional)
+```
+The tool automatically handles sibling directories (`scripts/`, `references/`, `assets/`) when installing resources.
 ## Duplicate Handling
-When a resource already exists, you can choose to:
+When a resource already exists at the destination, you can choose:
-- **Skip** - Keep existing file
-- **Overwrite** - Replace with new version
-- **Rename** - Save as new name (e.g., `skill-2`)
-- **Backup** - Backup existing file before replacing
-- **Compare** - View diff and decide
+| Action | Description |
+|--------|-------------|
+| **Skip** | Keep the existing file unchanged |
+| **Overwrite** | Replace with the new version |
+| **Rename** | Save with a new name (e.g., `skill-2`, `skill-3`) |
+| **Backup** | Create a `.backup` of existing file before replacing |
+| **Compare** | View a diff comparison and decide |
-Identical content is automatically skipped.
+Identical content is automatically detected and skipped.
 ## Examples
 ```bash
-# Install all resources from a repo to Claude Code
+# Install all resources from a popular repo
 npx add-ai-tools vercel-labs/ai-chatbot
 # Install to Cursor with global scope
 npx add-ai-tools owner/repo --agent cursor --scope global
-# Install without prompts
+# Install without any prompts (accept all defaults)
 npx add-ai-tools owner/repo -y
-# Interactive mode
+# Interactive mode - no arguments needed
 npx add-ai-tools
-# Export resources as ZIP from GitHub
+# Export resources as ZIP for sharing
 npx add-ai-tools owner/repo --zip
 # Export all resources without prompts
 npx add-ai-tools owner/repo --zip -y
+# Install from Bitbucket
+npx add-ai-tools https://bitbucket.org/workspace/repo
+# Install specific skill from a subdirectory
+npx add-ai-tools https://github.com/owner/repo/tree/main/skills/code-review
 ```
+## How It Works
+1. **Parse Source** - The tool parses your input (shorthand, URL, or SSH) to identify the repository
+2. **Fetch Resources** - Uses the Git Trees API for efficient fetching of repository structure
+3. **Parse Metadata** - Extracts YAML frontmatter from resource files (name, description, etc.)
+4. **Handle Duplicates** - Checks for existing resources and prompts for action if needed
+5. **Install** - Writes files atomically to the correct agent-specific location
+## Requirements
+- Node.js 18.0.0 or higher
+- npm or pnpm
+## Contributing
+Contributions are welcome! Please feel free to submit issues and pull requests.
 ## License
 MIT

package/README.zh-CN.md ADDED Viewed

@@ -0,0 +1,194 @@
+# add-ai-tools
+一个通用的 CLI 工具，可以从各种来源一键安装 AI 代理资源（Skills、Rules、Agents）。
+**[English](./README.md)** | **[한국어](./README.ko.md)** | **[日本語](./README.ja.md)**
+## 概述
+`add-ai-tools` 简化了 AI 编码助手资源的管理流程。它可以从 GitHub 或 Bitbucket 仓库获取资源，并安装到您首选的 AI 代理对应的位置。
+### 主要特性
+- **多来源支持** - 支持从 GitHub、Bitbucket 或 Git SSH URL 安装
+- **多代理支持** - 兼容 Claude Code、Cursor、GitHub Copilot 和 Antigravity
+- **交互模式** - 引导式提示，轻松选择资源
+- **ZIP 导出** - 将资源导出为便携的 ZIP 归档
+- **智能重复处理** - 支持跳过、覆盖、重命名、备份或比较重复文件
+- **批量安装** - 一次安装多个资源
+## 安装
+```bash
+# 全局安装
+npm install -g add-ai-tools
+# 或使用 npx 直接运行
+npx add-ai-tools
+```
+## 快速开始
+### 从 GitHub 安装
+```bash
+# 使用 GitHub 简写
+npx add-ai-tools owner/repo
+# 使用完整 GitHub URL
+npx add-ai-tools https://github.com/owner/repo
+# 从特定路径安装资源
+npx add-ai-tools https://github.com/owner/repo/tree/main/skills/my-skill
+```
+### 交互模式
+```bash
+npx add-ai-tools
+```
+交互模式将引导您完成以下步骤：
+1. 选择您的 AI 代理（Claude Code、Cursor 等）
+2. 输入源仓库地址
+3. 选择资源类型（Skills、Rules、Agents）
+4. 选择要安装的具体资源
+5. 选择安装范围（项目级或全局）
+### 导出为 ZIP
+```bash
+# 使用交互式提示导出
+npx add-ai-tools owner/repo --zip
+# 无提示导出所有资源
+npx add-ai-tools owner/repo --zip -y
+```
+## 支持的来源
+| 格式 | 示例 | 状态 |
+|------|------|:----:|
+| GitHub 简写 | `owner/repo` | ✓ |
+| GitHub URL | `https://github.com/owner/repo` | ✓ |
+| 带路径的 GitHub URL | `https://github.com/owner/repo/tree/main/skills/my-skill` | ✓ |
+| Bitbucket URL | `https://bitbucket.org/workspace/repo` | ✓ |
+| Git SSH (GitHub) | `git@github.com:owner/repo.git` | ✓ |
+| Git SSH (Bitbucket) | `git@bitbucket.org:owner/repo.git` | ✓ |
+| GitLab URL | `https://gitlab.com/owner/repo` | 即将推出 |
+## 命令行选项
+| 选项 | 描述 | 默认值 |
+|------|------|--------|
+| `[source]` | 仓库 URL 或简写（可选） | - |
+| `--agent <agent>` | 目标代理 | `claude-code` |
+| `--scope <scope>` | 安装范围（`project` 或 `global`） | `project` |
+| `-y, --yes` | 跳过所有确认提示 | `false` |
+| `--zip` | 导出为 ZIP 而非安装 | `false` |
+| `-h, --help` | 显示帮助信息 | - |
+| `-V, --version` | 显示版本号 | - |
+### 可用代理
+- `claude-code` - Claude Code（Anthropic）
+- `cursor` - Cursor IDE
+- `github-copilot` - GitHub Copilot
+- `antigravity` - Antigravity
+## 支持的代理和资源
+| 代理 | Skills | Rules | Agents |
+|------|:------:|:-----:|:------:|
+| Claude Code | ✓ | ✓ | ✓ |
+| Cursor | ✓ | ✓ | - |
+| GitHub Copilot | ✓ | ✓ | - |
+| Antigravity | ✓ | ✓ | - |
+## 安装路径
+资源将安装到代理特定的位置：
+| 代理 | 项目范围 | 全局范围 |
+|------|----------|----------|
+| Claude Code | `.claude/skills/`、`.claude/rules/`、`.claude/agents/` | `~/.claude/skills/`、`~/.claude/rules/`、`~/.claude/agents/` |
+| Cursor | `.cursor/skills/`、`.cursor/rules/` | `~/.cursor/skills/`、`~/.cursor/rules/` |
+| GitHub Copilot | `.github/skills/`、`.github/instructions/` | `~/.copilot/skills/`、`~/.copilot/instructions/` |
+| Antigravity | `.agent/skills/`、`.agent/rules/` | `~/.gemini/antigravity/skills/`、`~/.gemini/antigravity/rules/` |
+## 资源结构
+资源遵循标准结构：
+```
+skill-name/
+├── SKILL.md           # 主要技能文件（必需）
+├── scripts/           # 可执行脚本（可选）
+├── references/        # 参考文档（可选）
+└── assets/            # 静态资源（可选）
+```
+该工具在安装资源时会自动处理同级目录（`scripts/`、`references/`、`assets/`）。
+## 重复处理
+当目标位置已存在资源时，您可以选择：
+| 操作 | 描述 |
+|------|------|
+| **跳过** | 保持现有文件不变 |
+| **覆盖** | 用新版本替换 |
+| **重命名** | 以新名称保存（如 `skill-2`、`skill-3`） |
+| **备份** | 替换前创建现有文件的 `.backup` |
+| **比较** | 查看差异对比后决定 |
+相同内容会自动检测并跳过。
+## 示例
+```bash
+# 从热门仓库安装所有资源
+npx add-ai-tools vercel-labs/ai-chatbot
+# 以全局范围安装到 Cursor
+npx add-ai-tools owner/repo --agent cursor --scope global
+# 无提示安装（接受所有默认值）
+npx add-ai-tools owner/repo -y
+# 交互模式 - 无需参数
+npx add-ai-tools
+# 导出资源为 ZIP 以便分享
+npx add-ai-tools owner/repo --zip
+# 无提示导出所有资源
+npx add-ai-tools owner/repo --zip -y
+# 从 Bitbucket 安装
+npx add-ai-tools https://bitbucket.org/workspace/repo
+# 从子目录安装特定技能
+npx add-ai-tools https://github.com/owner/repo/tree/main/skills/code-review
+```
+## 工作原理
+1. **解析来源** - 解析您的输入（简写、URL 或 SSH）以识别仓库
+2. **获取资源** - 使用 Git Trees API 高效获取仓库结构
+3. **解析元数据** - 从资源文件中提取 YAML frontmatter（名称、描述等）
+4. **处理重复** - 检查现有资源，必要时提示操作
+5. **安装** - 原子性地将文件写入正确的代理特定位置
+## 系统要求
+- Node.js 18.0.0 或更高版本
+- npm 或 pnpm
+## 贡献
+欢迎贡献！请随时提交 Issue 和 Pull Request。
+## 许可证
+MIT

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "add-ai-tools",
-  "version": "1.1.1",
+  "version": "1.1.2",
   "description": "Universal AI agent resource installer CLI",
   "type": "module",
   "bin": {