mcpField
S
scaffold

scaffold

github.com/boshu2開発45390 回インストール2 日前に更新
リポジトリ

scaffold について

範囲を限定したプロジェクト、コンポーネント、CI のひな形を作成し、振る舞いテストとビルド・テスト・lint を各1回実行するスキルです。利用可能な実例に倣い、許可なく既存パスを上書きしません。

主な機能

  1. 01書き込み前に正確なパスを宣言
  2. 02許可のない上書きを拒否
  3. 03実例があれば検証済み構成を採用
  4. 04振る舞いテストを含める
  5. 05ビルド・テスト・lint を各1回実行
  6. 06パスとコマンド結果を報告

活用シーン

  1. 01言語と名前を指定してプロジェクトを作成
  2. 02既存プロジェクトにコンポーネントを追加
  3. 03指定された CI 設定を作成
  4. 04既存の動作する実例を基にひな形を作成

インストール

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

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

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

同梱ファイル

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

references/
agent-facing-tool-scaffolds.md
generic-templates.md
scaffold.feature
scripts/
validate.sh

詳細

スキャフォールド

プロジェクト、コンポーネント、または CI スキャフォールドを 1 つ作成します。この専門エージェントは、RPI のスケジュール設定、作業の担当割り当て、Git の変更、次に何を行うかの決定は行いません。

プロンプト

Scaffold a new CI workflow at fleet-router/.github/workflows/lint.yml plus a matching test fixture. Declare the exact paths to create, refuse to overwrite any existing file, generate a behavioral test for the new lint step, then run the target's build, test, and lint commands once and report results.

正常に機能している条件

  • 書き込みが行われる前に、レポートで .github/workflows/lint.yml のような作成対象の正確なパスが宣言されます。
  • .github/workflows/lint.yml がすでに存在する場合など、既存ファイルとのパスの衝突は拒否され、その旨が報告されます。既存ファイルは変更されません。
  • 生成されたコードには、lint_test.go のような動作テストが少なくとも 1 つ含まれます。
  • go build ./... のようなビルド、テスト、lint の各コマンドがそれぞれ 1 回だけ実行され、その出力がレポートにそのまま引用されます。

契約

  1. 指定されたターゲットルートを特定し、作成または変更する可能性のある正確なパスを宣言します。
  2. 呼び出し元から明示的な許可がない限り、既存のパスへの上書きを拒否します。
  3. 少なくとも 1 つの動作テストを含む、慣用的で機能するファイルを生成します。
  4. ターゲットで選択したビルド、テスト、lint の各コマンドを 1 回実行します。
  5. 変更したファイルと、事実に基づくコマンドの結果を報告して終了します。

呼び出し元から別の実行環境を明示的に要求されない限り、現在のエージェントとローカルシェルを使用します。無関係な既存の変更は保持してください。

実績のある手本を複製する

構成を考案する前に、ビルド、テスト、リリースがすでに機能している手本を 1 つ探してください。このリポジトリ内、またはターゲットのエコシステムにある既存のプロジェクト、コンポーネント、CI ファイルが対象です。手本の構成を複製し、依頼に合わせて名前を変更し、不要なものを削除してください。手本がない場合に限り構成を考案し、その旨をレポートに記載してください。利用可能な実績ある手本があるにもかかわらず新しい構成を設計することは、白紙からのスキャフォールドという失敗モードです。考案した規約はすべて、ターゲットチームが新たに引き受ける未レビューの決定となります。停止条件：候補となる手本 2 つで構成上の選択が異なる場合、今日検証コマンドが通るほうを選び、その選択を記録してください。両方を混ぜてはいけません。

真実の情報源は 1 つ、同期は一方向

スキャフォールドに派生コンテンツや重複コンテンツ（生成される設定、ミラーリングされた定数、テンプレート化された CI マトリックスなど）が含まれる場合、真実の情報源を必ず 1 つだけ指定し、すべての複製をその情報源から一方向に、アトミックに生成してください。1 回の再生成手順ですべての複製が生成され、複製を手作業で編集することは誤りであると、スキャフォールド自体のドキュメントまたはチェックで定義してください。記憶を頼りに 2 つのファイルを同時に編集しなければならない状態は、二重編集の罠という失敗モードです。それを含むスキャフォールドは未完成です。依頼によって双方向同期が必要になる場合は、スキャフォールドを作成せず、矛盾を報告して終了してください。

モード

  • 言語と名前が指定された場合は、プロジェクトを作成します。
  • コンポーネントの種類と名前が指定された場合は、既存プロジェクトにコンポーネントを追加します。
  • CI プラットフォームが指定された場合は、要求された CI 設定を作成します。

依頼でターゲットまたは言語が特定されていない場合は、不足している情報だけを尋ねてください。バージョン管理、リビジョン、納品は呼び出し元の責任です。

エビデンス

以下を返してください。

  • ターゲットルートと実際に変更したパス
  • 選択したビルド、テスト、lint の各コマンド
  • 各コマンドの終了コード
  • 要求されたチェックのうち、実行しなかったもの

結果に判定、ライフサイクルの状態、再試行の指示、次のアクションを含めてはいけません。

参考資料

コメント

Markdown 対応