vibeguard

VibeGuard

Spellbook 内で日常的に使える、軽量な VibeGuard です。

このスキルは、AI を活用した作業で通常、方向性がずれやすい次の 3 つの場面を支援します。

• 実装を始める前
• レビューで見つかった問題の優先順位を決めるとき
• リグレッションや回避可能なミスが発生した後

このスキルの内容

• コーディング前に作業範囲を定めるためのタスク契約チェックリスト
• 根拠に基づいて指摘事項の優先順位を決めるためのスコアリングマトリクス
• リグレッションとガードレールを振り返るための週次レビュー用テンプレート

厳守すべき制約

このスキルは、意図的に軽量な設計になっています。

次のことを行います。

• タスク開始時の確認をガイドする
• レビュー結果を構成する
• リスクに関するトレードオフを明確にする

次のことは行いません。

• フックをインストールする
• ガードスクリプトを自動実行する
• Claude や Codex のグローバル設定を変更する
• VibeGuard の完全な適用が有効であると主張する

自動的な介入、リポジトリレベルのルール、または環境構築をユーザーが求めた場合は、完全版の VibeGuard リポジトリとツールに案内してください。

使用するタイミング

次の内容をユーザーが求めたときに、このスキルを使用します。

• ハルシネーションを防ぐためのガードレール
• タスク開始時のチェック
• レビューのスコアリングやトリアージ
• リグレッションの防止
• 振り返り用テンプレート
• 「vibeguard」という名称のもの

ワークフロー

1. タスク契約から始める

references/task-contract.yaml を開き、次の項目を確認します。

• 目標
• 正とする情報源
• 受け入れ基準
• 作業範囲

これらが具体的になるまで、実装に進まないでください。

2. 対応する前に指摘事項をスコアリングする

references/scoring-matrix.md を開き、各指摘事項について次の項目を評価します。

• 影響度
• 工数
• リスク
• 確信度

このスコアを使って、緊急の修正と根拠の弱い推測を区別します。

3. 適切な提供方法を選ぶ

• 1～2 ファイル：契約が明確になったら、直接実装します
• 3～5 ファイル：まず簡潔な仕様書または手順書を作成します
• 6 ファイル以上：設計・仕様書と段階的な実行計画を作成します

4. 症状だけでなく、失敗の原因をレビューする

リグレッションが発生した場合は、どの防御が機能しなかったかを特定します。

• 作業範囲の制御
• 正とする情報源の検証
• 検証の深さ
• レビューの優先順位付け
• ガードレールの不足

その後、references/review-template.md にフォローアップを記録します。

想定される成果物

依頼に応じて、次のいずれかを作成します。

• 記入済みのタスク契約
• 優先順位付きのスコアリング済み指摘事項テーブル
• 簡潔なリグレッションレビューまたは週次の振り返り

参照ファイル

• references/task-contract.yaml - タスク開始時のチェックリスト
• references/scoring-matrix.md - 優先順位付けのモデル
• references/review-template.md - 振り返り用テンプレート