mcpField
B
bootstrap

bootstrap

github.com/boshu2エージェントワークフロー45192 回インストール1 日前に更新
リポジトリ

bootstrap について

明示的に依頼された不足分の AgentOps ドキュメントを、既存ファイルを上書きせずに追加するスキルです。範囲を限定し、リポジトリの意図を推測しないセットアップに向いています。

主な機能

  1. 01既存の標準ファイルを確認
  2. 02依頼された不足文書のみ作成
  3. 03既存ファイルを保持
  4. 04必要時に判定保存領域を作成
  5. 05作成・スキップ・失敗パスを報告

活用シーン

  1. 01不足する PRODUCT.md と GOALS.md の追加
  2. 02既存の AGENTS.md を保ったセットアップ
  3. 03依頼された永続判定保存領域の作成

インストール

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

$npx skills add https://github.com/boshu2/agentops --skill bootstrap

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

同梱ファイルreferences/context-routing.mdreferences/examples.md

詳細

Bootstrap — 最小限のプロジェクト設定

Bootstrap は、明示的に要求された不足中の AgentOps エントリードキュメントと、要求された場合に限り、永続的な判定ディレクトリを作成します。Git の初期化、フックのインストール、トラッカーの状態作成、ランタイムの起動、デリバリーワークフローの強制は行いません。

どのリポジトリでも Bootstrap を安全に実行できるのは、既存ファイルを決して上書きしないためです。追加しか行えないセットアップ手順は、設計上、冪等です。一方、置き換えが可能な手順では、置き換える内容を理解していることを先に証明する必要があります。

名前の付いた失敗モード — スキャフォールドの乱立:「完全な」セットアップのほうが親切だと思い込み、呼び出し元が要求していないファイルを作成することです。

アンチパターン:呼び出し元に尋ねずに済むよう、ディレクトリ名や README からプロダクトの意図を推測することです。是正策:不足している内容を尋ねます。自信満々に誤った PRODUCT.md を書くより、質問するほうが適切です。

プロンプト

Bootstrap missing AgentOps docs for fleet-router (ao is installed). Create only PRODUCT.md and GOALS.md since they're missing; AGENTS.md already exists, so leave it untouched. Also create .agents/ao/verdicts/sha256/. Report created, skipped, and failed paths.

正常に動作している場合

  • レポートに、PRODUCT.md と GOALS.md は作成済み、AGENTS.md はすでに存在するためスキップと記載されています。
  • 既存ドキュメントとのパスの競合(例:AGENTS.md がすでに存在する場合)は、上書きではなくスキップとして報告されます。
  • .agents/ao/verdicts/sha256/ は、呼び出し元が永続的な判定ストレージを明示的に要求した場合にのみ作成されます。
  • レポートは作成、スキップ、失敗したパスのみで終わり、次のアクションや git コマンドは含まれません。

手順

  1. 対象ディレクトリを調べ、既存の標準ファイルを報告します。
  2. 安全に推測できない場合は、不足しているプロダクトの意図や目標の内容を呼び出し元に尋ねます。
  3. 明示的に要求された、不足中のファイルだけを作成します。既存のドキュメントは決して上書きしません。
  4. 永続的なローカル判定ストレージが要求された場合は、.agents/ao/verdicts/sha256/ を作成します。
  5. ファイルシステム上の存在を検証し、作成、スキップ、失敗したパスを報告します。
  6. 終了します。

一般的なドキュメントは、PRODUCT.md、GOALS.md、AGENTS.md、および RPI のたどり方を説明する README のセクションです。生成するプロダクト向け文言は、運用レイヤーのカテゴリーを起点とし、所有権の境界を維持します。リポジトリは、独自の Git、CI、トラッカー、リリース、デプロイのポリシーを自由に使用できます。

名称について。 「bootstrap」という語を共有する 3 つの機能がありますが、それぞれ異なります。このスキルは不足中のエントリードキュメントを作成します。ao init は、ローカルのエビデンスディレクトリと判定ディレクトリ(.agents/ao/**)を作成する CLI コマンドです。ao session bootstrap は、どのローカルのオリエンテーションファイルが存在するかを報告する読み取り専用のセッションコマンドです。このスキルは、どちらも呼び出しません。

選択された CDLC については、呼び出し元がコンテキストルーティングのリファレンスを使って既存の外部ストレージを解決します。Bootstrap が利用側プロジェクトの設定や、ナレッジ/撤回元の代替物を作成することはありません。新しい CDLC の証拠には、明示的に選択された外部エビデンスルートを使用します。上記のローカル判定ディレクトリの手順は、呼び出し元が要求した単独の証拠作成に適用されます。

対象外

  • ao、br、bd、NTM、Agent Mail、その他のランタイムのインストールや呼び出し。
  • .git、ワークツリー、ブランチ、コミット、フック、CI ワークフローの作成。
  • 作業を選択すること、または実際に調査したパスを超えてリポジトリのセットアップが完了したと主張すること。
  • RPI の自動実行。

出力

対象パス、要求されたファイル、作成したファイル、変更せずに残した既存ファイル、書き込みに失敗したもの、検証時の所見を返します。次のアクションは含めないでください。

リファレンス

コメント