AgentSkillsCN

commit-prep-helper

在提交 Git 提交前自动执行质量检查。适用于“请提交这次修改”、“请先进行代码评审再提交”等需求，自动运行 ESLint/Black 代码风格检查、测试执行以及代码评审，并在完成上述步骤后，以符合 Conventional Commits 规范的提交信息完成提交。不执行推送或 PR 创建操作，仅在本地完成提交。

SKILL.md
--- frontmatter
name: commit-prep-helper
description: >
  Gitコミット前に自動で品質チェックを実行するスキル。
  「この修正をコミットして」「コードレビューしてからコミットして」などの依頼に対応し、
  ESLint/BlackによるLint、テスト実行、コードレビューを自動実行後、
  Conventional Commits準拠のコミットメッセージでコミットを作成する。
  プッシュやPR作成は行わず、ローカルコミットまでを実行する。

Commit Prep Helper

Overview

このスキルはGitコミット前に自動品質チェックを実行し、高品質なコードコミットを支援します。Lint、テスト、コードレビューを自動実行し、Conventional Commits準拠のコミットメッセージを生成します。

Quick Start

基本的な使用フロー：

bash
# 1. 変更をステージング
git add .

# 2. スキル実行
/skill: commit-prep-helper

# 3. 自動実行されるチェック：
#    - Lintチェック (ESLint/Black/Prettier)
#    - テスト実行 (Jest/Vitest/pytest)
#    - コードレビュー (セキュリティ・品質チェック)
#    - コミットメッセージ生成
#    - Gitコミット実行

品質チェックフロー

Step 1: ステージングファイル検出

scripts/check_staged_files.pyを実行し、コミット対象の変更を分析：

bash
python .claude/skills/commit-prep-helper/scripts/check_staged_files.py

検出内容：

  • •変更ファイル一覧
  • •ファイルタイプ分析
  • •変更行数統計
  • •テストファイルの有無

Step 2: Lintチェック実行

プロジェクトタイプを自動検出し、適切なLintツールを実行：

bash
python .claude/skills/commit-prep-helper/scripts/run_linting.py

対応ツール：

  • •Node.js: ESLint + Prettier
  • •Python: Black + (Flake8/pylint)
  • •Rust: cargo-clippy + rustfmt
  • •Go: gofmt + golint

Step 3: テスト実行

プロジェクトのテストフレームワークを自動検出して実行：

bash
python .claude/skills/commit-prep-helper/scripts/run_tests.py

対応フレームワーク：

  • •Node.js: Jest, Vitest, Mocha
  • •Python: pytest, unittest
  • •Rust: cargo test
  • •Go: go test

Step 4: コードレビュー実行

静的解析でセキュリティと品質問題を検出：

bash
python .claude/skills/commit-prep-helper/scripts/code_review.py

チェック項目：

  • •セキュリティ脆弱性 (ハードコード、eval、XSS等)
  • •コード品質 (console.log、TODO、長すぎる行等)
  • •複雑度 (関数の長さ、ネスト深さ)

Step 5: コミットメッセージ生成とコミット実行

references/conventional_commits.mdのルールに従い、コミットメッセージを生成：

bash
python .claude/skills/commit-prep-helper/scripts/create_commit.py

生成ルール：

  • •コミットタイプの自動判定 (feat/fix/docs/test/chore)
  • •スコープの自動付与 (機能単位)
  • •品質チェック結果をBodyに記載

品質基準

Lintチェック基準

  • •Errorレベル: 0件必須 (ブロック要因)
  • •Warningレベル: 5件以内推奨
  • •フォーマット: Prettier/Blackエラー0件

詳細: references/quality_thresholds.md

テスト品質基準

  • •テスト成功率: 100%必須
  • •カバレッジ: 70%以上推奨、80%以上理想
  • •タイムアウト: 5分

コードレビュー基準

  • •セキュリティ: 高危険度問題0件必須
  • •品質スコア: 80点以上で合格
  • •複雑度: 関数50行以内、ネスト4階層以内

対応プロジェクトタイプ

Node.js/TypeScript

code
package.json          -> 検出
├── jest.config.js    -> Jest使用
├── vite.config.js    -> Vitest使用
└── .eslintrc.js      -> ESLint使用

Python

code
requirements.txt      -> 検出
pyproject.toml       -> 検出
├── pytest.ini      -> pytest使用
└── setup.cfg        -> 設定読み取り

Rust/Go

code
Cargo.toml           -> Rust検出
go.mod              -> Go検出

カスタマイズ設定

プロジェクト固有設定

プロジェクトルートに .commit-prep-config.json を配置：

json
{
  "project_type": "custom",
  "lint_tools": ["custom-linter"],
  "test_framework": {
    "name": "custom-test",
    "command": "custom-test --coverage"
  },
  "thresholds": {
    "test_coverage_min": 80,
    "max_lint_warnings": 3
  }
}

レビュー設定のカスタマイズ

assets/review_config.json でチェック項目を調整：

  • •セキュリティパターンの追加/削除
  • •品質チェックのしきい値調整
  • •無視するファイル/ディレクトリ設定

エラーハンドリング

Lintエラー時

bash
# ESLintエラー例
❌ Lint Check Failed
ESLint: 3 errors found
→ Fix lint errors before committing

テスト失敗時

bash
# テスト失敗例
❌ Test Execution Failed
Jest: 2 tests failed, 15 passed
→ Fix failing tests before committing

セキュリティ問題時

bash
# セキュリティ警告
⚠️ Security Issues Found
- Hardcoded API key in src/config.js:42
→ Remove sensitive data before committing

使用例

典型的なユースケース

1. 機能追加後のコミット

code
ユーザ: 「ユーザー認証機能を実装したのでコミットして」
スキル:
- 検出: auth.ts, user.service.ts, auth.test.ts
- Lint: ESLint✅ Prettier✅
- テスト: Jest✅ 95% coverage
- レビュー: セキュリティ問題✅ 品質問題1件(console.log)
- 生成コミット: "feat(auth): add JWT authentication implementation"

2. バグ修正時のコミット

code
ユーザ: 「APIのnullハンドリングを修正したのでコミットして」
スキル:
- 検出: api.service.ts
- Lint: ✅
- テスト: ✅ 新規テスト3件追加
- レビュー: ✅
- 生成コミット: "fix(api): handle null response in user endpoint"

3. ドキュメント更新時のコミット

code
ユーザ: 「READMEとAPIドキュメントを更新したのでコミットして」
スキル:
- 検出: README.md, docs/api.md
- Lint: スキップ (ドキュメントファイル)
- テスト: スキップ
- レビュー: ✅
- 生成コミット: "docs: update installation guide and API documentation"

Resources

scripts/

実行可能なPythonスクリプト群で、各種品質チェックを自動実行します。

  • •check_staged_files.py - Gitステージングファイルの検出と分析
  • •run_linting.py - プロジェクトタイプ自動検出とLint実行
  • •run_tests.py - テストフレームワーク自動検出とテスト実行
  • •code_review.py - 静的解析によるコードレビュー実行
  • •create_commit.py - Conventional Commits準拠のコミットメッセージ生成

references/

スキルの動作に関する詳細ドキュメントで、Claudeが参照する情報源です。

  • •conventional_commits.md - コミットメッセージのルールとテンプレート
  • •quality_thresholds.md - 品質チェックのしきい値と設定基準
  • •tool_mapping.md - プロジェクトタイプ別ツール設定のマッピング

assets/

スキル実行時に使用される設定ファイルとテンプレートです。

  • •review_config.json - コードレビューのチェック項目としきい値設定
  • •commit_templates/ - コミットメッセージのテンプレートファイル
    • •feat.template - 新機能追加用のテンプレート
    • •fix.template - バグ修正用のテンプレート

重要: このスキルはpushやPR作成は行いません。ローカルでの品質チェックとコミット作成に特化しています。