菜单
piper-plus のコミットルール (CLAUDE.md 準拠) でステージ済みファイルをコミットします。--no-verify 禁止、HEREDOC、適切な prefix を強制。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
| name | commit |
| description | piper-plus のコミットルール (CLAUDE.md 準拠) でステージ済みファイルをコミットします。--no-verify 禁止、HEREDOC、適切な prefix を強制。 |
| argument-hint | [optional commit message] |
| disable-model-invocation | true |
| allowed-tools | Bash(git status *) Bash(git diff *) Bash(git log *) Bash(git add *) Bash(git commit *) Bash(git rev-parse *) |
CLAUDE.md のコミット規約に従い、ステージ済みまたは指定ファイルを安全にコミットします。
git rev-parse --abbrev-ref HEADgit log -3 --onelinegit status --shortgit diff --stat HEAD💡 大規模変更の場合:
/sync-docsを先に呼び出してドキュメント整合性を確認することを推奨します。このスキルはステップ 2.5 でその判定を行います。
現在のブランチを確認し、dev の場合はユーザーに確認を取る (CLAUDE.md: 通常はフィーチャーブランチで作業)。
git status --short で変更ファイルを確認git diff で内容を簡単にレビュー.env, .env.*, credentials*, *.pem, *.key 等の秘密情報が含まれていないか 必ず チェックコード変更のサイズと種類に応じて、ドキュメント更新が必要か判定します。
以下のいずれかに該当する場合、/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/ に新規ファイルが追加されているpiper_train / timing / voice / phonemize / config などのコアモジュールが変更されているtests/test_*.py, test/js/test-*.js, etc.) が 3 つ以上追加されている大規模/コア変更 → ユーザーに /sync-docs の実行を促す:
このコミットには X 件のコア変更が含まれます。
/sync-docsでドキュメント整合性を監査してからコミットしますか?
小規模変更 (< 100 行、ドキュメントのみ、テストのみ、バグ修正) → スキップ可
ユーザーが「スキップ」を選択 → 警告のみ表示して続行
このステップは informational です。ユーザーが明示的にスキップを選べば、コミット自体はブロックしません。
git add <file1> <file2> で個別追加git add -A / git add . は禁止 (誤って秘密情報をステージするリスク)$ARGUMENTS がある場合はそれを優先。なければ変更内容から自動生成:
| Prefix | 用途 |
|---|---|
feat(<scope>): | 新機能 (scope = python/rust/cpp/cs/go/wasm/ci/docs) |
fix(<scope>): | バグ修正 |
refactor(<scope>): | リファクタ (機能変更なし) |
docs: | ドキュメントのみ |
test: | テスト追加・修正 |
chore(<scope>): | ビルド/依存/雑務 |
perf(<scope>): | パフォーマンス改善 |
必須形式: HEREDOC
git commit -m "$(cat <<'EOF'
<prefix>(<scope>): <summary>
- <detail 1>
- <detail 2>
EOF
)"
--no-verify (pre-commit hook を skip しない)--no-gpg-sign (署名を skip しない)--amend は明示要求がない限り使用しない (新コミットを作る)git config の変更pre-commit hook (例: ruff format hook) が失敗したら:
git add で再ステージ✅ コミット成功
- ハッシュ: abc1234
- メッセージ: feat(python): ...
- ファイル: 5 changed (+120 -30)
- ドキュメント同期: ✅ (完了) / ⚠️ (未実行・推奨) / - (小規模のためスキップ)
push する場合:
git push origin <branch-name>
PR 作成する場合:
/check-pr-ready で最終チェック
Python canonical (`src/python_run/piper_plus/`, `src/python/piper_train/`, `src/python/g2p/piper_plus_g2p/`) を変更した PR で、 ONNX I/O 以外の追随漏れ (phonemizer / config schema / CLI flag / data 形式 / API 変更) を 7 ランタイム + 2 docker image 範囲で fail-fast 検出する。PR
ZH-EN code-switching loanword の同期と forward-compat を 1 コマンドで検査。zh_en_loanword.json を編集したり 5 ランタイムのいずれかに新規エントリを追加する前後に呼ぶ。Python source を canonical とし、Rust×2 / Go / C# / WASM / C++ の 6 mirror + Python runtime mirror = 計 7 copy + 6 fixture mirror が byte-for-byte 一致しているかを確認。
PR 作成前の最終チェックリスト (lint/test/docs/CHANGELOG/未コミット確認)。/precheck の拡張版で、ドキュメント整合性も検証します。
推論パスの canonical Python (`export_onnx.py` / `vits/models.py:VitsModel.infer`) を変更した PR で、6 ランタイム (Python runtime / Rust / Go / C# / C++ / WASM) の inference path が追随しているかを git diff で確認。PR
コミット前にエージェントチームで全ドキュメント (CLAUDE.md / README / CHANGELOG / docs/) を監査し、コード変更に応じて自動更新します。大規模変更時の documentation drift を予防。
9 パッケージ × 5 レジストリの version bump と関連ファイル更新 (Cargo.lock / package-lock.json / Swift checksum / CHANGELOG 昇格) を 1 コマンドで適用案にする read-mostly skill。`release-prep` (確認用) の続きに呼び、 実 bump 差分の markdown 提案 + 順序付き publish ガイドを生成する。