mcpField
P
pre-merge-gate

pre-merge-gate

github.com/heyeddi-comテスト・品質086 回インストール1 日前に更新
リポジトリ

pre-merge-gate について

pre-merge-gate は、マージ前に複数のチェックを実行し、PASS/FAIL/SKIP レポートを作成するスキルです。承認やマージの前に必須チェックを確認する QA やエージェント向けです。

主な機能

  1. 01設定されたプロジェクトチェックの実行
  2. 02PASS/FAIL/SKIP レポートの作成
  3. 03チェック失敗時の非ゼロ終了
  4. 04任意監査のスキップ指定

活用シーン

  1. 01main または dev へのマージ前確認
  2. 02レビュー指摘への対応後の検証
  3. 03PR向けQAゲートレポートの作成

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/heyeddi-com/heyeddi-skills --skill pre-merge-gate

インストール後、Claude Code で/pre-merge-gateを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

manifest.json
context/
ANTI_PATTERNS.md
EXAMPLES.md
PROSE_ANTI_SLOP.md
VOCABULARY.md
reference/
subagents.md
scripts/
_skill_cli.py
pre_merge_gate.py

詳細

マージ前ゲート

サブエージェント（デフォルト）

Task shell サブエージェントでゲートを実行します：pre_merge_gate.py。メインチャットで FAIL の行をトリアージし、修正を再委任します。reference/subagents.md を参照してください。

使用するタイミング

  • QA が PR の承認前に、緑／赤の単一レポートを求めている場合
  • main ／ dev へのマージ前
  • レビューのフィードバックへの対応後：すべてのゲートに合格したことを確認します

強制停止

いずれかのチェックが FAIL の場合、スクリプトは 終了コード 1 で終了します。終了コード 0 で BLOCKED と報告された Markdown レポートを、マージ可能と見なさないでください。このバグは修正済みです。プロセスが終了コード 0 で終了しない限り、エージェントはマージしたり、マージ可能と伝えたりしてはいけません。

手順

  1. python .agents/skills/pre-merge-gate/scripts/pre_merge_gate.py --project-root <root> を実行します。
  2. Markdown レポートを読みます：各チェックに PASS／FAIL／SKIP が表示されます。
  3. 失敗したチェックを修正し、終了コードが 0 になるまで再実行します。

Eval／ハーネスのターン： Eval ハーネスが Playwright の証跡を別途取得する場合は、ゲートがコントラスト監査を実行しないように --skip-visual-audit を付けて実行します（エージェントのターンでは Playwright を使用しません）。

チェック

ツリーが存在する場合は必須

  • セットアップ監査（@heyeddi-setup verify_setup --check：設定が未完了の場合は失敗）
  • npm test と本番ビルド（package.json）
  • node_modules がある場合は vue-tsc --noEmit（フロントエンドが存在するのにツールチェーンがない場合は FAIL）
  • backend の pytest（backend/tests。backend/.venv を優先）
  • backend/app に対する ruff F821（未定義の名前／削除されたインポート）
  • エンジニアリング監査（@engineering-excellence audit_engineering --check：エラーは失敗、警告は参考情報）

任意（スキル／ツールがない場合は SKIP 可。FAIL は引き続き強制停止）

  • UI 重複スキャン（no-duplicate-ui）
  • 文章監査（heyeddi-design verify_prose.py） — コピー文言には常に適用し、緊急時のみスキップします
  • プロダクトのルートに対するコントラスト監査（visual-auditor。Playwright がない場合は SKIP）

フラグ：--skip-duplicate-ui、--skip-prose-audit、--skip-engineering-audit、--skip-setup-audit、--skip-visual-audit。--skip-backend、--skip-engineering-audit、--skip-setup-audit は緊急時のみ使用し、マージ承認のためには使用してはいけません。

タスク完了時：次に使うスキルを提案する

このスキルに対するユーザーのリクエストを完了したとき（ツール呼び出しやサブエージェントのフェーズごとではありません）に、次に実行する内容を提案します：

  1. 次を実行します：

    python .agents/skills/heyeddi/scripts/suggest_next_skill.py --current-skill pre-merge-gate --project-root .

    特定のルートで作業した場合は、--route /path を追加します。

  2. スクリプトの ### Next step ブロックを最終返信に含めます。ユーザーは Prompt の行をチャットにコピーします（例：@heyeddi-design craft /settings）。

直前に完了したサブコマンドが分かっている場合は、--mode shape（または craft、audit など）を渡します。

@heyeddi → reference/next-skill-handoff.md を参照してください。

コメント

Markdown 対応