git-commit-suggest

Git Commit Suggest

Git の変更内容に基づくコミットメッセージの提案をユーザーが求めた場合に、このスキルを使用します。

設定

初回の必須設定

diff を分析する前に、node <pasta-da-skill>/scripts/configure.mjs --print を実行し、同じディレクトリにあるこの SKILL.md の config.json で setupCompleted を確認してください。

• setupCompleted が true の場合は、設定済みのオプションを読み込んで続行します。
• ファイルが存在しない場合、または setupCompleted が true でない場合は、node <pasta-da-skill>/scripts/configure.mjs を実行します。設定ページを開いたことをユーザーの言語で伝え、ブラウザーが開かなかった場合は、表示された URL を記載してください。ここで停止します。ユーザーが設定を保存するまで、diff を読んだりメッセージを提案したりしないでください。
• 設定ページを開くためのシェルがない場合は、設定が必須であり、このスキルは使用しないことを説明してください。インストール先のフォルダーでスクリプトを実行し、設定を保存してから再試行するようユーザーに依頼してください。

設定ページをキャンセルしても、設定は完了しません。デフォルトに戻した場合も、［保存］をクリックして初めて設定が完了します。

再設定

ユーザーが言語の変更やスキルの調整を求めた場合は、node <pasta-da-skill>/scripts/configure.mjs を実行してインターフェースを開きます。簡単な変更には、たとえば --set language=pt-BR のように --set を使用します。

エージェントが config.json を手動で編集することはありません。ファイルの検証と保存には、必ずスクリプトを使用してください。

ワークフロー

1. git status --short と git ls-files --others --exclude-standard を実行して、変更と新規ファイルを確認します。
2. git diff --cached を優先し、空の場合は git diff を使用します。
3. 関連する新規ファイルの冒頭を読みます。diff が大きい場合は、まず git diff --stat を実行し、要約する際はロックファイル、dist/、build/、*.min.* を除外します。
4. 変更を分類し、明確な場合に限って scope を選びます。feat、fix、refactor、perf、docs、style、test、build、ci、chore、revert などのタイプは英語のままにします。
5. config.json の maxSubjectLength、detailCount、bodySeparator、scope、imperativeMood に従い、設定された言語で件名と詳細を書きます。
6. シークレットの兆候がないか確認し、メッセージを提案する前に警告します。

git add、git commit、git push は実行しないでください。設定された箇条書きの数で、そのまま貼り付けられるメッセージを提示します。例については references/examples.md を参照してください。