piper-plus: Skill for Claude Code

piper-plus 向けコミット

CLAUDE.md のコミット規約に従い、ステージ済みまたは指定ファイルを安全にコミットします。

現在の状態

• ブランチ: !git rev-parse --abbrev-ref HEAD
• 直近のコミット: !git log -3 --oneline
• ステージ状態: !git status --short
• 差分サマリ: !git diff --stat HEAD

手順

💡 大規模変更の場合: /sync-docs を先に呼び出してドキュメント整合性を確認することを推奨します。このスキルはステップ 2.5 でその判定を行います。

1. ブランチ確認

現在のブランチを確認し、dev の場合はユーザーに確認を取る (CLAUDE.md: 通常はフィーチャーブランチで作業)。

2. 変更内容の把握

• git status --short で変更ファイルを確認
• git diff で内容を簡単にレビュー
• .env, .env.*, credentials*, *.pem, *.key 等の秘密情報が含まれていないか 必ず チェック
• 含まれていたら 即中止 してユーザーに報告

2.5. ドキュメント同期チェック

コード変更のサイズと種類に応じて、ドキュメント更新が必要か判定します。

判定基準

以下のいずれかに該当する場合、/sync-docs skill を呼び出すことを強く推奨:

• git diff --stat の変更行数が 100 行以上
• src/python_run/piper_plus/ / src/python/g2p/ / src/rust/piper-core/ / src/cpp/ / src/csharp/ / src/go/ / src/wasm/openjtalk-web/src/ に新規ファイルが追加されている
• 公開 API (関数シグネチャ、クラス、メソッド、HTTP エンドポイント) に変更がある
• piper_train / timing / voice / phonemize / config などのコアモジュールが変更されている
• 新規テストファイル (tests/test_*.py, test/js/test-*.js, etc.) が 3 つ以上追加されている

アクション

1. 大規模/コア変更 → ユーザーに /sync-docs の実行を促す:

   このコミットには X 件のコア変更が含まれます。/sync-docs でドキュメント整合性を監査してからコミットしますか?

2. 小規模変更 (< 100 行、ドキュメントのみ、テストのみ、バグ修正) → スキップ可

3. ユーザーが「スキップ」を選択 → 警告のみ表示して続行

このステップは informational です。ユーザーが明示的にスキップを選べば、コミット自体はブロックしません。

3. ファイルのステージング

• ユーザーが既にステージしている場合はそのまま使用
• 必要なら関連ファイルだけを git add <file1> <file2> で個別追加
• git add -A / git add . は禁止 (誤って秘密情報をステージするリスク)

4. コミットメッセージ生成

$ARGUMENTS がある場合はそれを優先。なければ変更内容から自動生成:

Prefix 規約

Prefix	用途
feat(<scope>):	新機能 (scope = python/rust/cpp/cs/go/wasm/ci/docs)
fix(<scope>):	バグ修正
refactor(<scope>):	リファクタ (機能変更なし)
docs:	ドキュメントのみ
test:	テスト追加・修正
chore(<scope>):	依存/雑務
perf(<scope>):	パフォーマンス改善
ci: / ci(<scope>):	CI workflow / gate の変更
build(<scope>):	ビルド設定 (CMake / Cargo / packaging 等)
style(<scope>):	フォーマットのみ (挙動変更なし)
revert:	過去コミットの取り消し