開発
bash
make build # バイナリをビルド
make test # 全テストを実行
make vet # 静的解析
make lint # リンター実行(golangci-lintが必要)
make cover # カバレッジレポート(100%カバレッジを強制)
make install # $GOPATH/binにインストール
make clean # ビルド成果物を削除すべてのプルリクエストはCIを通過する必要があります。CIでは以下が強制されます:
go vet ./...で警告ゼロ- テストカバレッジ100%
コントリビューション
- リポジトリをフォーク
- フィーチャーブランチを作成(
git checkout -b feature/my-feature) - 変更を実施
- ドキュメントを更新 -- ユーザー向けの動作に影響する変更の場合(コードとドキュメントの対応表は
CLAUDE.mdを参照) - テストが通ることを確認:
make test && make vet - コミットしてプッシュ
- プルリクエストを作成
既存のコードスタイルに従ってください:サブコマンドごとに1ファイル、httptest.NewServer を使ったテーブル駆動テスト、エラーラッピングには fmt.Errorf("context: %w", err) を使用。
ドキュメント
ユーザー向けの動作に影響する変更(新しいコマンド、フラグの変更、新しいMCPツール)を行った場合は、以下を更新してください:
README.md— 該当するセクションdocs/— 対応するVitePress ページdocs/public/llms.txtとllms-full.txt— CLIコマンドやMCPツールが変更された場合
詳細なコードとドキュメントの対応表は CLAUDE.md を参照してください。
CIは、ユーザー向けコードの変更にドキュメントの変更が伴わないプルリクエストにリマインダーコメントを投稿します。