Community - コミュニティ

概要: Autonomous-Operationsコミュニティへの参加方法、コントリビューションガイド、行動規範などをまとめたセクションです。

対象読者: コントリビューター、コミュニティメンバー 所要時間: 30分 前提知識: Getting Started を完了していること

目次

1. セクション概要
2. コミュニティの目的
3. 参加方法
4. ドキュメント一覧
5. コントリビューション方法
6. 次のステップ

セクション概要

Communityセクションでは、以下の内容をカバーしています:

主要トピック

• Discordコミュニティ: リアルタイムコミュニケーション
• コントリビューションガイド: プロジェクトへの貢献方法
• 行動規範: コミュニティの行動規範

このセクションを完了すると、コミュニティに参加し、プロジェクトに貢献できるようになります。

コミュニティの目的

Autonomous-Operationsコミュニティは、完全自律型AI開発オペレーションの未来を共に創るための場です。

ミッション

1. 知識共有: ベストプラクティスと経験の共有
2. 相互支援: 技術的課題の解決を相互にサポート
3. 協働開発: オープンソースプロジェクトへの貢献
4. イノベーション: 新しいアイデアと技術の探求

コミュニティの価値観

• オープン: すべての議論と開発はオープン
• 協調: 相互尊重と協力的な姿勢
• 品質: 高品質なコードと丁寧なレビュー
• 学習: 継続的な学習と成長

参加方法

1. GitHubでの参加

リポジトリ: github.com/ShunsukeHayashi/miyabi_doc

参加手順:

# 1. リポジトリをフォーク
# GitHubのWebUIで "Fork" をクリック

# 2. ローカルにクローン
git clone https://github.com/YOUR_USERNAME/miyabi_doc.git

# 3. ブランチ作成
git checkout -b feature/your-feature

# 4. 変更をコミット
git commit -am "Add your feature"

# 5. プッシュ
git push origin feature/your-feature

# 6. Pull Requestを作成
# GitHubのWebUIで "New Pull Request" をクリック

2. Discordコミュニティへの参加

招待リンク: Discord招待リンク

チャンネル構成:

• #general: 一般的な議論
• #help: 質問と技術サポート
• #showcase: 成果物の共有
• #ideas: アイデアと提案
• #announcements: お知らせ

詳細: discord-plan.md

3. GitHub Discussionsへの参加

URL: GitHub Discussions

カテゴリ:

• Q&A: 質問と回答
• Ideas: 機能提案
• Show & Tell: 成果共有
• Announcements: お知らせ
• General: 一般ディスカッション

ドキュメント一覧

1. discord-plan.md

内容: Discordコミュニティ計画 所要時間: 15分 こんな方におすすめ: Discordに参加したい方

主要トピック:

• チャンネル構成
• 参加方法
• コミュニケーションガイドライン
• イベント計画

チャンネル一覧:

📢 announcements     - お知らせ
💬 general           - 一般的な議論
❓ help              - 質問と技術サポート
💡 ideas             - アイデアと提案
🎨 showcase          - 成果物の共有
🤖 agents            - Agent開発ディスカッション
🔧 development       - 開発ディスカッション
📚 documentation     - ドキュメント改善

2. contributing.md

内容: コントリビューションガイド 所要時間: 20分 こんな方におすすめ: プロジェクトに貢献したい方

主要トピック:

• コントリビューションの種類
• 開発環境のセットアップ
• コード規約
• Pull Requestの作成方法
• レビュープロセス

コントリビューションの種類:

1. コード: 機能追加、バグ修正
2. ドキュメント: ドキュメント改善、翻訳
3. テスト: テストケース追加
4. レビュー: Pull Requestレビュー
5. デザイン: UI/UX改善
6. アイデア: 機能提案、改善提案

3. code-of-conduct.md

内容: 行動規範 所要時間: 5分 こんな方におすすめ: すべてのコミュニティメンバー

主要トピック:

• 期待される行動
• 許容されない行動
• 報告方法
• 執行

期待される行動:

• 相互尊重
• 建設的なフィードバック
• オープンマインド
• 協調的な姿勢

許容されない行動:

• ハラスメント
• 差別的発言
• 攻撃的な言動
• プライバシー侵害

コントリビューション方法

初めてのコントリビューション

Step 1: Issueを探す

# "good first issue" ラベルのIssueを探す
https://github.com/ShunsukeHayashi/miyabi_doc/issues?q=is%3Aissue+is%3Aopen+label%3A%22good+first+issue%22

Step 2: 開発環境をセットアップ

# リポジトリをクローン
git clone https://github.com/YOUR_USERNAME/miyabi_doc.git
cd miyabi_doc

# 依存関係をインストール
npm install

# テストを実行
npm test

# ビルドを実行
npm run build

Step 3: ブランチを作成

# 新しいブランチを作成
git checkout -b feature/issue-270-add-login-page

Step 4: 変更を実装

# コードを変更
# ...

# テストを実行
npm test

# リントを実行
npm run lint

Step 5: コミット

# 変更をステージング
git add .

# コミット (コミットメッセージは明確に)
git commit -m "Add login page feature

- Implement login form UI
- Add authentication logic
- Add unit tests

Fixes #270"

Step 6: Pull Requestを作成

# プッシュ
git push origin feature/issue-270-add-login-page

# GitHubでPull Requestを作成
# タイトル: Add login page feature (#270)
# 説明: Issue #270の内容を参照

コード規約

TypeScript

// ✅ 良い例
export class CoordinatorAgent {
  async execute(task: Task): Promise<Result> {
    // 実装
  }
}

// ❌ 悪い例
export class coordinator_agent {
  execute(task) {
    // 実装
  }
}

コミットメッセージ

# ✅ 良い例
Add login page feature

- Implement login form UI
- Add authentication logic
- Add unit tests

Fixes #270

# ❌ 悪い例
fix bug

Pull Requestタイトル

# ✅ 良い例
Add login page feature (#270)
Fix authentication bug (#271)
Update documentation for Agent system (#272)

# ❌ 悪い例
Update
fix

詳細: contributing.md

レビュープロセス

1. 自動チェック

Pull Request作成後、自動で以下がチェックされます:

• Lint (ESLint)
• Type Check (TypeScript)
• Unit Tests
• Integration Tests
• Test Coverage (目標80%+)

2. コードレビュー

Reviewerが以下を確認:

• コードの正確性
• テストカバレッジ
• ドキュメント更新
• コード規約準拠

3. 承認とマージ

• 2人以上のApprove が必要
• すべての自動チェックが合格
• コンフリクトがないこと

コミュニティイベント

定期イベント

週次ミーティング

頻度: 毎週金曜日 20:00-21:00 (JST) 場所: Discord Voice Channel 内容:

• 進捗共有
• 技術的議論
• Q&A

月次リリース

頻度: 毎月第1金曜日 内容:

• 新機能リリース
• リリースノート公開
• デモンストレーション

不定期イベント

• ハッカソン: 新機能開発イベント
• ワークショップ: 技術学習イベント
• LT (Lightning Talk): 知識共有イベント

よくある質問

Q1: 初めてのコントリビューションは何をすればいいですか?

A: "good first issue" ラベルのIssueから始めることをおすすめします。

これらのIssueは初心者向けに設計されており、サポートも充実しています。

Q2: コードを書けなくてもコントリビューションできますか?

A: はい、できます!

コントリビューションの種類:

• ドキュメント改善
• バグ報告
• 機能提案
• レビュー
• テスト作成
• 翻訳

Q3: Pull Requestのレビューにどのくらい時間がかかりますか?

A: 通常、2-3営業日以内にレビューします。

緊急の場合は、Discordの #development チャンネルでメンションしてください。

Q4: コミュニティルールに違反した人を見つけたらどうすればいいですか?

A: code-of-conduct.md の報告方法に従ってください。

すべての報告は機密に扱われます。

コミュニティの成長

現在の状況 (2025-10-10)

目標 (2025-12-31)

次のステップ

このセクション完了後の理解度チェック

以下ができれば、コミュニティに参加する準備ができています:

• コミュニティの価値観を理解している
• Discordに参加した
• GitHub Discussionsを確認した
• Contributing Guideを読んだ
• Code of Conductを理解した
• 初めてのIssueを見つけた

今すぐできること

1. Discordに参加

• discord-plan.md から招待リンクを取得
• #general チャンネルで自己紹介

2. GitHubをフォロー

• リポジトリをStar
• Watchで通知を受け取る

3. 初めてのコントリビューション

• "good first issue" を探す
• Issueにコメントして担当を宣言
• 実装開始

関連ドキュメント

基礎知識

• Getting Started

実装ガイド

• Guides
• Architecture

リファレンス

• Reference

サポート

質問・相談

• Discord: #help チャンネル
• GitHub Discussions: Q&A カテゴリ
• GitHub Issues: バグ報告、機能提案

メンテナー連絡先

• GitHub: @ShunsukeHayashi
• Discord: プロジェクト Discord サーバー
• Email: [メール相談用アドレス]

作成日: 2025-10-10 更新日: 2025-10-10 メンテナー: Autonomous-Operations Team

私たちは、あなたのコントリビューションを心よりお待ちしています!