Gissy：AIを使ってGitワークフローを強化するコマンドラインアシスタント

Gissyは、開発者のためのパーソナルなGitアシスタントとして設計されたオープンソースのコマンドラインツールで、反復的なGitタスクを自動化することでワークフローを簡素化する。このツールの中心的な特徴は、特にOpenAI、Google Gemini、Addis AIといった様々なAIサービスプロバイダの統合による人工知能（AI）技術の利用であり、有意義で仕様に準拠したGitコミットを自動的に生成する。Gissyはインテリジェントなファイル・モニターを提供し、コード・リポジトリ内のファイルの変更を自動的に検出し、テストの実行やコード仕様のチェックなど、事前に定義された一連の品質チェック・プロセスを起動する。チェックが完了すると、ステージング、コミット、さらにはリモートリポジトリへのプッシュのプロセス全体を自動化することができる。JavaScriptで構築されたこのツールは、クロスプラットフォーム（Windows、macOS、Linux）であり、複雑な設定をすることなくすぐに使用することができる。

機能一覧

• インテリジェント・ドキュメント・モニターコード・リポジトリ内のファイル変更を自動的に監視し、後続の自動処理をトリガーします。
• マルチAIサービスプロバイダー対応OpenAI、Google Gemini、Addis AIとの統合により、ユーザーのAPIキー設定に基づき、高品質なGitコミットを自動的に選択・生成。
• 自動化されたワークフローテストの自動実行、コード仕様のチェック、ファイルのステージング、変更のコミット、そして最終的にはリモートリポジトリへのコードのプッシュ。
• SSHキーの自動設定ワンクリックでSSHキーを生成し、ユーザーのGitHubアカウントに自動的に設定するコマンドを提供し、最初のコードプッシュ前の準備を簡素化します。
• 高度なコンフィギュレーションが可能このプロジェクトは、ルート・ディレクトリから.gissyrc.jsonファイルには、ターゲットブランチの指定、テストを有効にするかどうか、プッシュとAIの機能など、詳細な設定が記述されている。
• すぐに使えるGissyは、コンフィギュレーション・ファイルがなくても、合理的なデフォルト設定で問題なく動作する。
• Git コマンドの強化のようなGitコマンドに代わる、より情報量が多く、美的にも美しいものを提供します。gissy status, gissy info歌で応えるgissy branch.
• クロスプラットフォームの互換性: Node.jsの開発に基づいており、Windows、macOS、Linuxなどの主要なオペレーティングシステムで確実に動作します。

ヘルプの使用

Gissyは、自動化とAI技術によってGitワークフローを効率化するために設計された強力なコマンドラインツールです。以下では、インストール、設定、使い方の詳細をご紹介します。

取り付け

GissyはNode.js環境に基づいているため、お使いのコンピューターにNode.jsとnpmがインストールされていることを確認してください。

1.グローバルインストール（推奨）
どんなプロジェクトでも使いやすいようにgissyコマンドを使用する場合は、グローバル・インストールを推奨する。ターミナルまたはコマンドラインツールを開き、以下のコマンドを入力する：

npm install -g gissy

インストールが完了したら、どのパスでも直接使用することができます。gissy注文した。

2.npxを使う（インストール不要）
ローカルにGissyをインストールしたくない場合はnpxを直接実行する。npxはnpmに付属するパッケージ・ランナーで、指定したパッケージを一時的にダウンロードし、システムにファイルを残さずに実行する。

# 例如，使用npx运行status命令
npx gissy status
# 使用npx启动文件监视器
npx gissy watch

基本構成

Gissyは箱から取り出してすぐに使えるが、簡単な設定により、プロジェクトのニーズにより適したものにすることができる。

プロジェクトのルート・ディレクトリに.gissyrc.jsonファイルを開き、必要に応じて以下の設定項目を追加する：

{
"branch": "main",
"runTests": true,
"runLint": true,
"useAI": false,
"autoCommit": false,
"autoPush": false,
"testCommand": "npm test",
"lintCommand": "npm run lint",
"watchIgnore": [
"*.tmp",
"build/**",
"dist/**",
"node_modules/**",
".git/**",
"*.log"
]
}

設定項目の説明：

• branchコードプッシュの対象ブランチを指定します。"main".
• runTestsコミットする前にテストを実行するかどうか。true.
• runLintコミットする前にコード仕様のチェックを実行するかどうか。true.
• useAIコミットメッセージの生成にAIを使うかどうか。false.
• autoCommit投稿前の確認セッションをスキップするかどうか。false.
• autoPushプッシュ前の確認セッションをスキップするかどうか。false.
• testCommandテストを実行する特定のコマンドを定義します。"npm test".
• lintCommandコード指定チェックを実行するコマンドを定義します。"npm run lint".
• watchIgnoreファイルモニターが無視するファイルやディレクトリのパターンを定義します。

AIサービス・プロバイダーの構成

Gissyの最も強力な機能の1つは、AIによる投稿メッセージの自動生成です。この機能を有効にするには、AIサービスプロバイダのAPIキーを設定する必要があります。

1. プロジェクトのルート・ディレクトリに.env文書の
2. 持っているAPIキーに応じて、適切な環境変数を追加する：

# OpenAI API密钥 (默认优先使用)
OPENAI_API_KEY=your_openai_api_key_here
# Google Gemini API密钥
GEMINI_API_KEY=your_gemini_api_key_here
# Addis AI API密钥 (支持本地语言)
ADDIS_AI_API_KEY=your_addis_ai_api_key_here

ジッシーが続くOpenAI > Google Gemini > Addis AI優先順位は、利用可能なAPIキーを自動的に検出し、使用する。キーが提供されない場合、標準の、非AIサブミッションメッセージモードにフォールバックする。

コア機能の使用

1.倉庫の状態を確認する (gissy status)
このコマンドは、ネイティブのgit status倉庫のステータスをより鮮明に、カラフルに表示することで、どのファイルが変更されたのか、ステージングされたのか、追跡されていないのかの概要を素早く把握することができます。

gissy status

2.倉庫情報を見るgissy info)
リモートリポジトリのURL、最近のコミット、ブランチなど、現在のリポジトリの詳細情報を表示します。

gissy info

3.管理部門gissy branch)
ブランチを一覧表示します。現在のブランチがハイライトされます。

# 列出所有本地分支
gissy branch
# 列出所有远程分支
gissy branch --remote
# 列出所有本地和远程分支
gissy branch --all

4.SSHの自動設定gissy ssh)
SSH キーの設定は、初めて GitHub にコードをプッシュする人にとってよくあるハードルです。このコマンドは、自動的に SSH 鍵を調べて生成し、それを GitHub アカウントに追加する手順を説明します。git push.

gissy ssh

5.スマート・ファイル・モニターを起動するgissy watch)
これはGissyの中核となる自動化機能です。このコマンドを実行すると、Gissyはプロジェクトのファイル変更を継続的に監視します。

gissy watch

ファイルを保存するとwatchワークフローが開始される：

• 変化の検出Gissyはファイルが変更されたことにすぐに気づく。
• 動作チェックもしrunTests歌で応えるrunLintというのもtrueそれは実行されるだろう。testCommand歌で応えるlintCommand.チェックに失敗した場合、プロセスは中断し、エラーメッセージがコンソールに出力される。
• 投稿情報の作成:: もしチェックがパスしuseAIというのもtrueGissyは、設定されたAIサービスプロバイダを使用してコードの矛盾を分析し、正規のコミットメッセージを生成します。
• ステージングと提出変更されたすべてのファイルを自動的にステージング・エリアに追加し、生成された情報を使ってコミットする。
• プッシュコード最後に、設定で指定したリモートブランチにコミットをプッシュする。

に特別な機能を追加することもできる。watchコマンドは、デフォルトのコンフィギュレーションを上書きするパラメーターを追加する：

# 启动监视器并启用AI，同时输出详细日志
gissy watch --use-ai --verbose
# 临时忽略某些文件
gissy watch --ignore "*.tmp" "dist/**"

アプリケーションシナリオ

1. 新規プロジェクトの初期化
   新しいプロジェクトを始めるとき、開発者は.gitignoreファイルを作成し、Git リポジトリを初期化して最初のコミットを行います。最初のコミットはgissy sshはGitHubへのアクセスを素早く設定できる。gissy watchその後のコミットやプッシュは、コーディングの過程で自動的に処理されるため、プロジェクトの開始プロセスが大幅に簡素化される。
2. 日々の開発とコーディング
   日々の開発において、開発者はコーディング、テスト、ステージング、コミット、プッシュを頻繁に切り替える必要があります。gissy watchこのコマンドはこの一連の作業を自動化するため、開発者はコードを書くことだけに集中し、ファイルを保存することで完全な品質チェックとバージョン管理プロセスが開始され、コンテキストの切り替えが減り、開発効率が向上する。
3. コードレビューとチームワーク
   GissyはAIを使用して、従来のコミットに準拠したコミットメッセージを生成し、チームで作業する際に明確で一貫性のあるコミット履歴を保証します。これにより、コードレビューがより効率的になり、チームメンバーが各変更の目的を理解しやすくなります。
4. リファクタリングまたは大規模機能開発
   大規模なリファクタリングや複雑な機能を開発する場合、大量のファイル修正が発生する。これらのコミットを手作業で管理するのは面倒であり、エラーが発生しやすい。gissy watchこれはバックグラウンドで継続的に実行され、開発プロセスの小さなステップをバッチで自動的にサブミットし、後のトレーサビリティとロールバックのための明確でアトミックなコミットレコードを形成する。

品質保証

1. Gissyはどのような技術で作られているのですか？
   Gissyは主にJavaScript（ESモジュール）で構築されており、以下のようないくつかの一般的なNode.jsライブラリを利用しています。Commander.jsコマンドライン・インターフェイスの構築用。Chokidarファイル監視用。Chalk端子出力を装飾するために使用される。
2. GissyのAI機能を使うにはお金を払う必要がありますか？
   Gissy自体は無料でオープンソースである。しかし、AI機能についてはOpenAIやGoogle GeminiといったサードパーティーのAIサービスプロバイダーに依存しており、これらのサービスを利用するには通常、対応するAPIキーが必要で、サービスプロバイダーの価格戦略や利用状況によっては料金が発生する場合がある。
3. AI用のAPIキーを設定していない場合でも、Gissyは機能しますか？
   できます。APIキーが設定されていなくてもGissyは動作します。この場合、コミットメッセージが必要になると、ファイル変更のリストに基づいたシンプルで標準化されたコミットメッセージにフォールバックするか、手動での入力を促します。ファイル監視、自動テスト、プッシュなど、すべての非AI関連機能は影響を受けません。
4. ギッシーは私のコードを漏らしているのか？
   AI機能が有効になっている場合、Gissyはあなたが修正したコード・スニペット(git diffGissy自体は、お客様のコードを他の場所に保存することはありません。貴社またはプロジェクトのセキュリティ・ポリシーを遵守し、適切なAIサービス・プロバイダーのデータ・プライバシー・ポリシーを認識する必要があります。