mcpField
C
caveman-manage

caveman-manage

github.com/juliusbrusseeクラウド・DevOps115.8k107.0k 回インストール3 日前に更新
リポジトリ

caveman-manage について

Caveman の評価ゲート付き実験を確認し、根拠のある対応を1つ提案するスキルです。状態は読み取り専用で確認し、証拠と安全条件を評価して、変更の実行を阻止します。

主な機能

  1. 01実験の状態と結果の読み取り
  2. 02品質と安全性の証拠評価
  3. 03対応案を1つ提示
  4. 04ライフサイクル変更の阻止
  5. 05証拠不足時のフェイルクローズ

活用シーン

  1. 01昇格前の実験レビュー
  2. 02ガードレールや証拠の不足確認
  3. 03オペレーター操作後の状態確認

MCP 対応

Caveman MCP ツールでプロジェクトのコンテキスト、実験の詳細、結果を読み取ります。MCP とコマンドラインによるライフサイクル変更は禁止されています。

インストール

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

$npx skills add https://github.com/juliusbrussee/caveman --skill caveman-manage

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

詳細

評価ゲート付き実験を管理する

すべてのライフサイクル変更を、本番環境の制御操作として扱ってください。現在の状態と結果を読み取り、サポートされている推奨事項を1つ提示するか、実行をブロックしてください。 現在のエージェント MCP は意図的に読み取り専用です。control-api では、ライフサイクル遷移テーブル全体と証拠ゲートがまだアトミックに適用されていません。

必須ゲート

  1. レビュー、調査、説明、または推奨の依頼で許可されるのは読み取りのみです。
  2. 結果が保留中である場合、必須のガードレールがない場合、または証拠で違反が報告されている場合は、実験を承認してはいけません。
  3. 実験のリフトを verified_savings に変換してはいけません。それが可能なのは、実際のトラフィックがアクティブで、プロバイダー起因かつプロバイダー完備の台帳証拠がある場合のみです。
  4. 組織 ID を指定してはいけません。プロジェクトとテナントのスコープは、ログイン済みの Caveman ID とサーバーの RBAC によって決まります。
  5. ユーザーの承認後であっても、ライフサイクルの変更を実行してはいけません。正確な <action>:<experiment_id> 文字列はエージェントが生成できるため、人間の意図を示す証拠にはなりません。
  6. 不明な状態とサーバーエラーは安全側に倒して処理します。正確な cave_snake_code を報告してください。

ステップ1 — プロジェクトと実験を読み込む

MCP を優先してください。

caveman_context {}
caveman_experiment_get {"action":"get","experiment_id":"<id>"}
caveman_experiment_get {"action":"results","experiment_id":"<id>"}

ユーザーが ID を指定していない場合は、{"action":"list"} を使用してください。

CLI によるフォールバック：

caveman cloud experiments list
caveman cloud experiments show <id>
caveman cloud experiments results <id>

ログイン、プロジェクト、実験、または結果を取得できない場合は中止してください。

ステップ2 — 証拠を評価する

次の情報を報告してください。

  • 現在のライフサイクル状態と安全性クラス。
  • 対照群と候補群のサンプルサイズ。
  • 品質または評価結果。
  • 該当する場合は、レイテンシ、エラー、コスト、リトライ、ドロップ、エスカレーションの各ガードレール。
  • 証拠のコスト。
  • ロールバックまたは保留の理由。
  • 結果が保留中、失敗、昇格可能、またはアクティブのいずれであるか。

項目がないことは合格を意味しません。必須フィールドがない場合は evidence incomplete と明記し、承認を提案しないでください。

ステップ3 — アクションを1つ提案する

許可されるアクション：

  • start — グレーダーが設定済みの、開始可能なドラフト状態またはキュー状態からのみ実行できます。
  • approve — 証拠が完全で合格しており、安全性クラスが現在のロールで承認可能な場合のみ実行できます。
  • cancel — ユーザーが不要と判断した、非アクティブな実験を停止します。
  • rollback — サーバーに紐づくポリシーパスを通じて、アクティブな変更または有害な変更を元に戻します。現在のデプロイでは cave_not_implemented が正当に返される場合があります。その応答をロールバックとして説明してはいけません。

推奨事項と ID を示してください。

Proposed action: approve experiment 7f...
Reason: candidate passed quality and every configured guardrail.
Execution: blocked until server-authoritative lifecycle and evidence gates ship.

「管理して」や「最善の対応をして」など、以前の一般的な発言を変更の承認として扱わないでください。

ステップ4 — 安全でない実行をブロックする

実行可能なライフサイクルコマンドを出力または実行してはいけません。現在のサーバーでは、すべての証拠と状態の遷移がまだアトミックに適用されないことを説明してください。そのため、CLI と MCP のエージェント用インターフェースで利用できるのは、実験の読み取りのみです。

ステップ5 — 外部オペレーターによる操作後に再読み込みする

オペレーターがコマンドを実行したと述べた場合は、詳細と結果を再度読み込んでください。サーバーで確認された実行後の状態、監査または結果の応答、および返されたポリシー配信の状態を報告してください。オペレーターの意図だけから成功を推測してはいけません。

次の文で締めくくってください。

Action: <action> <experiment-id>
Before: <state>
Server response: <status and cave_snake_code if any>
After: <re-read state>
Basis: experiment evidence only. Verified savings unchanged unless the signed
ledger independently records active, provider-causal real-traffic savings.

コメント

Markdown 対応