mcpField
A
alpha-forge-preship

alpha-forge-preship

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

alpha-forge-preship について

alpha-forge-preshipは、Alpha ForgeのPRレビュー向け品質チェックを行うスキルです。RNGの決定性、URL、パラメーター、マニフェスト同期を4つのゲートで検証します。

主な機能

  1. 01RNGの分離と決定性の検査
  2. 02Fork URLの検証
  3. 03パラメーター範囲の検査
  4. 04デコレーターとYAMLマニフェストの同期確認

活用シーン

  1. 01コミット前のRNGとURLの確認
  2. 02実行時またはCIでのパラメーター検証
  3. 03CIでのマニフェスト整合性確認

インストール

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

$npx skills add https://github.com/terrylica/cc-skills --skill alpha-forge-preship

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

同梱ファイル

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

README.md
gates/
__init__.py
g1_documentation_scope.py
g10_performance_red_flags.py
g12_manifest_sync.py
g2_documentation_clarity.py
g3_documentation_completeness.py
g4_url_validation.py
g5_rng_determinism.py
g6_warmup_alignment.py
g7_parameter_documentation.py
g8_parameter_validation.py
references/
evolution-log.md
reference.md
tests/
__init__.py
test_g1_documentation_scope.py
test_g10_performance_red_flags.py
test_g12_manifest_sync.py
test_g2_documentation_clarity.py
test_g3_documentation_completeness.py
test_g4_url_validation.py
test_g5_rng_determinism.py
test_g6_warmup_alignment.py
test_g7_parameter_documentation.py
test_g8_parameter_validation.py
test_gates.py

詳細

Alpha Forge 出荷前品質ゲート - フェーズ 1

Alpha Forge の PR レビューワークフロー向け品質保証プラグインです。

自己進化型スキル：このスキルは使用を通じて改善されます。指示に誤りがある、パラメーターにずれが生じている、または回避策が必要だった場合は、先延ばしにせず、このファイルをすぐに修正してください。実際に再現可能な問題がある場合にのみ更新してください。

概要

5 件の PR #154 の問題を検出するため、堅牢な品質ゲートを 4 つ実装します。

  • G5：RNG の決定性（コミット前）
  • G4：URL フォーク検証（コミット前）
  • G8：パラメーター検証（ランタイム／CI）
  • G12：マニフェスト同期検証（CI）

効果

  • 問題の防止率：PR の問題の 42%
  • 誤検知率：1% 未満
  • 実装時間：約 4 時間
  • 効果が出るまでの期間：2～3 件の PR
  • レビューワークフローの短縮率：30～50%

主なファイル

  • gates/g5_rng_determinism.py - RNG 分離バリデーター
  • gates/g4_url_validation.py - フォーク URL 検出器
  • gates/g8_parameter_validation.py - パラメーター範囲バリデーター
  • gates/g12_manifest_sync.py - デコレーターと YAML の同期バリデーター
  • orchestrator.py - マスターバリデーターのコーディネーター
  • reference.md - フレームワークの完全なドキュメント

アーキテクチャ

すべてのゲートは、デコレーターを唯一の信頼できる情報源とする原則を適用します。

  • パラメーターの制約はデコレーターで定義します
  • エントリーポイントで設定を検証します
  • マニフェストの整合性を自動的に確保します
  • ドキュメントの要件を体系的に適用します

統合

コミット前フック
from gates.g4_url_validation import validate_org_urls
from gates.g5_rng_determinism import validate_rng_isolation
ランタイムのパラメーター検証
from gates.g8_parameter_validation import ParameterValidator
validator = ParameterValidator()
validator.validate_numeric_range(value, min_val, max_val)
マニフェスト検証
from gates.g12_manifest_sync import validate_manifest
issues = validate_manifest("manifest.yaml")

参考資料

  • メインハンドブック：/tmp/CANONICAL_PRESHOP_AUDIT_HANDBOOK.md（523 行）
  • 実装計画：/tmp/PHASE_1_IMPLEMENTATION_PLAN.md（367 行）
  • プロジェクト概要：/tmp/PROJECT_COMPLETION_SUMMARY.md

ステータス

✅ フェーズ 1 完了 - cc-skills へのマージおよび alpha-forge との統合準備が完了しています

実行後の振り返り

このスキルの実行後、終了する前に次の点を確認してください。

  1. コマンドは成功しましたか？ — 成功しなかった場合は、失敗の原因となった指示またはエラーテーブルを修正してください。
  2. パラメーターや出力に変更はありましたか？ — 基盤となるツールのインターフェースにずれが生じていた場合は、使用例とパラメーターテーブルを最新の内容に合わせて更新してください。
  3. 回避策が必要でしたか？ — 別のフラグや追加手順などの工夫が必要だった場合は、次回同じ回避策が不要になるよう、この SKILL.md を更新してください。

実際に再現可能な問題がある場合にのみ更新してください。推測に基づく問題は対象外です。

コメント

Markdown 対応