<div align="center">
<sub>

[English](../../CONTRIBUTING.md) • [Català](../ca/CONTRIBUTING.md) • [Deutsch](../de/CONTRIBUTING.md) • [Español](../es/CONTRIBUTING.md) • [Français](../fr/CONTRIBUTING.md) • [हिंदी](../hi/CONTRIBUTING.md) • [Bahasa Indonesia](../id/CONTRIBUTING.md) • [Italiano](../it/CONTRIBUTING.md) • <b>日本語</b>

</sub>
<sub>

[한국어](../ko/CONTRIBUTING.md) • [Nederlands](../nl/CONTRIBUTING.md) • [Polski](../pl/CONTRIBUTING.md) • [Português (BR)](../pt-BR/CONTRIBUTING.md) • [Русский](../ru/CONTRIBUTING.md) • [Türkçe](../tr/CONTRIBUTING.md) • [Tiếng Việt](../vi/CONTRIBUTING.md) • [简体中文](../zh-CN/CONTRIBUTING.md) • [繁體中文](../zh-TW/CONTRIBUTING.md)

</sub>
</div>

# Zoo Codeへの貢献

Zoo Codeはコミュニティ主導のプロジェクトであり、すべての貢献を深く評価しています。共同作業を円滑にするため、私たちは[課題第一のアプローチ](#課題第一のアプローチ)で運営しています。つまり、すべての[プルリクエスト（PR）](#プルリクエストの提出)は、まずGitHubの課題にリンクされている必要があります。このガイドを注意深く確認してください。

## 目次

- [貢献する前に](#貢献する前に)
- [貢献内容の検索と計画](#貢献内容の検索と計画)
- [開発と提出のプロセス](#開発と提出のプロセス)
- [法務](#法務)

## 貢献する前に

### 1. 行動規範

すべての貢献者は、私たちの[行動規範](./CODE_OF_CONDUCT.md)に従う必要があります。

### 2. プロジェクトのロードマップ

私たちのロードマップは、プロジェクトの方向性を示しています。あなたの貢献をこれらの主要な目標に合わせてください。

### 信頼性第一

- 差分編集とコマンド実行が一貫して信頼できることを確認します。
- 定期的な使用を妨げる摩擦点を減らします。
- すべてのロケールとプラットフォームでスムーズな操作を保証します。
- さまざまなAIプロバイダーとモデルに対する堅牢なサポートを拡大します。

### ユーザーエクスペリエンスの向上

- 明確さと直感性のためにUI/UXを合理化します。
- 開発者が日常的に使用するツールに期待する高い期待に応えるために、ワークフローを継続的に改善します。

### エージェントパフォーマンスのリード

- 現実世界の生産性を測定するための包括的な評価ベンチマーク（evals）を確立します。
- 誰もがこれらの評価を簡単に実行および解釈できるようにします。
- 評価スコアの明確な増加を示す改善を出荷します。

PRでこれらの分野との連携について言及してください。

### 3. Zoo Code コミュニティに参加しよう

- **Discord:** 私たちの [Discord](https://discord.gg/VxfP4Vx3gX) に参加してください。
- **Reddit:** 私たちの [Reddit](https://www.reddit.com/r/ZooCode/) に参加してください。

## 貢献内容の検索と計画

### 貢献の種類

- **バグ修正：** コードの問題への対処。
- **新機能：** 機能の追加。
- **ドキュメント：** ガイドと明確さの向上。

### 課題第一のアプローチ

すべての貢献は、私たちのスキニーテンプレートを使用してGitHubの課題から始まります。

- **既存の課題を確認する**：[GitHubの課題](https://github.com/Zoo-Code-Org/Zoo-Code/issues)で検索します。
- **課題を作成する**：
    - **機能強化：** 「機能強化リクエスト」テンプレート（ユーザーの利益に焦点を当てた平易な言葉）。
    - **バグ：** 「バグレポート」テンプレート（最小限の再現+期待値と実際値+バージョン）。
- **それに取り組みたいですか？** 課題に「Claiming」とコメントし、[Discord](https://discord.gg/VxfP4Vx3gX)のコアチームに連絡して割り当てを受けてください。割り当てはスレッドで確認されます。
- **PRは課題にリンクする必要があります。** リンクされていないPRはクローズされる場合があります。

### 何に取り組むかを決める

- issue を探すには [GitHub Issues ページ](https://github.com/Zoo-Code-Org/Zoo-Code/issues) を確認してください。
- ドキュメントについては、[Zoo Codeドキュメント](https://github.com/Zoo-Code-Org/Zoo-Code-Docs)をご覧ください。

### バグの報告

- 最初に既存のレポートを確認してください。
- 次の情報を含む[「バグレポート」テンプレート](https://github.com/Zoo-Code-Org/Zoo-Code/issues/new/choose)を使用して新しいバグを作成します。
    - 明確で番号付きの再現手順
    - 期待される結果と実際の結果
    - Zoo Codeのバージョン（必須）。関連する場合はAPIプロバイダー/モデル
- **セキュリティの問題**：[セキュリティアドバイザリ](https://github.com/Zoo-Code-Org/Zoo-Code/security/advisories/new)を介して非公開で報告してください。

## 開発と提出のプロセス

### 開発のセットアップ

1. **フォークとクローン：**

```
git clone https://github.com/YOUR_USERNAME/Zoo-Code.git
```

2. **依存関係のインストール：**

```
pnpm install
```

3. **デバッグ：** VS Codeで開きます（`F5`）。

### コーディングのガイドライン

- 機能または修正ごとに1つの焦点を絞ったPR。
- ESLintとTypeScriptのベストプラクティスに従ってください。
- 課題を参照する明確で説明的なコミットを作成します（例：`Fixes #123`）。
- 徹底的なテストを提供します（`npm test`）。
- 提出前に最新の`main`ブランチにリベースします。

### プルリクエストの提出

- 早期のフィードバックを求める場合は、**ドラフトPR**として開始します。
- プルリクエストテンプレートに従って、変更内容を明確に説明します。
- PRの説明/タイトルに課題をリンクします（例：「Fixes #123」）。
- UIの変更については、スクリーンショット/ビデオを提供します。
- ドキュメントの更新が必要かどうかを示します。

### プルリクエストポリシー

- 割り当てられたGitHubの課題を参照する必要があります。割り当てを受けるには、課題に「Claiming」とコメントし、[Discord](https://discord.gg/VxfP4Vx3gX)のコアチームに連絡してください。割り当てはスレッドで確認されます。
- リンクされていないPRはクローズされる場合があります。
- PRはCIテストに合格し、ロードマップに沿っており、明確なドキュメントが必要です。

### レビュープロセス

- **毎日のトリアージ：** メンテナーによる簡単なチェック。
- **毎週の詳細なレビュー：** 包括的な評価。
- フィードバックに基づいて**迅速に反復**します。

## 法務

貢献することにより、あなたの貢献がZoo Codeのライセンスと一致するApache 2.0ライセンスの下でライセンスされることに同意したことになります。
