コントリビューション

Project N.E.K.O. は、範囲を絞ったコード、ドキュメント、翻訳、テスト、コンテンツツールの貢献を受け付けています。

ワークフロー

リポジトリを fork し、現在の main から一つの課題に集中したブランチを作成します。
.agent/rules/neko-guide.md と、タスクに対応する .agent/skills/*/SKILL.md を読みます。
Python 3.11 と uv sync で環境を準備し、リポジトリのスクリプトでフロントエンドをビルドします。
所有モジュール内で、最小かつ対称な変更を行います。
対象テストを先に実行し、その後に関連する lint／ビルドを実行します。
振る舞い、リスク、検証結果を説明する PR を作成します。

Python コマンドはすべて uv run で実行します。ユーザー向け i18n の変更は 8 個の locale ファイルを同時に更新します。

PR ゲート

app/、main_logic/、memory/ 配下の Python を変更する場合、scripts/check_pr_report.py が要求する回帰レポート欄が PR 本文に必要です。
カウント対象が 20 ファイルを超える PR には、空でない「分割しない理由」が必要です。新規ファイル、認識されたテストファイル、同期された i18n locale グループは、ゲートの規則に従って除外されます。
静的解析とプラグインテストは、古いチェックリストではなく現在の workflow を基準にします。

該当領域を変更する前に、テスト、コードスタイル、ドキュメント保守、Nuitka パッケージングを読んでください。

報告とコミュニティ

再現可能な不具合や範囲の明確な提案には GitHub Issues を使用してください。環境、正確な revision／artifact、期待値と実際の結果、秘匿化したログ、最小再現を含めます。

貢献にはリポジトリの現在の LICENSE が適用されます。この文書から追加の配布保証を推測しないでください。