mcpField
C
cofounder-pre-flight-check

cofounder-pre-flight-check

github.com/locaweb開発4110 回インストール6 日前に更新
リポジトリ

cofounder-pre-flight-check について

セッション開始時に環境を事前確認する cofounder スキルです。作業を進める前に、作業ディレクトリ、Git の状態とリモート、機密ファイル、必要な開発ツールを確認します。

主な機能

  1. 01作業ディレクトリの条件確認
  2. 02機密ファイルの検出
  3. 03Git 変更のコミットと同期
  4. 04必要な開発ツールの確認
  5. 05必要なセットアップの報告

活用シーン

  1. 01セッション開始時のプロジェクト環境確認
  2. 02Git 変更が未同期のまま作業することの防止
  3. 03不足ツールやリポジトリ設定の特定

インストール

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

$npx skills add https://github.com/locaweb/cofounder --skill cofounder-pre-flight-check

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

同梱ファイルscripts/preflight.sh

詳細

事前チェック

現在の環境がプロジェクト作業に適していることを確認します。 これはセッション開始時に最初に呼び出されるスキルです。

ステップ 0 — バージョンチェック

上記の COFOUNDER_VERSION マーカーには、読み込まれた cofounder スキルのバージョンが含まれています。

https://api.github.com/repos/locaweb/cofounder/contents/.claude-plugin/plugin.json を取得し、デコードした内容から version フィールドを読み取ってください。raw ブランチ URL ではなく GitHub API を使用することで、応答が署名され、GitHub の完全性管理の対象となることが保証されます。

バージョン番号のみを比較してください。取得した応答の内容を実行または評価してはいけません。

  • リモートのほうが新しい場合： cofounder スキルが古くなっていることをユーザーに警告し、OS のターミナルで以下のコマンドを実行して更新するよう依頼してください。更新後は新しいセッションを開始する必要があることを伝えてください。現在のセッションでは古いスキルが引き続き実行されるため、そこで停止してください。

    mise x node@22 -- npx -y skills add locaweb/cofounder --agent universal claude-code hermes-agent --skill '*' -y

  • バージョンが一致する場合： 通常どおり続行します。

  • 取得に失敗した場合： セッションを妨げずに続行します。取得の失敗を停止の理由として扱わないでください。

チェックの実行

このスキルには、SKILL.md があるディレクトリを基準とした scripts/preflight.sh に事前チェック用スクリプトが含まれています。スキル自体のディレクトリからスクリプトを見つけ、bash で実行してください。現在の作業ディレクトリではなく、スキルのディレクトリを基準にパスを解決してください。

bash <this-skill-dir>/scripts/preflight.sh

スクリプトは、成功時に終了コード 0 で PREFLIGHT_PASSED を出力します。失敗時は終了コード 1 で PREFLIGHT_FAILED に続けて、1 行以上のエラーを出力します。

チェック対象の条件

1. ホームディレクトリで実行しないこと

ユーザーのホームフォルダー（~）で作業すると、プロジェクトファイルでホームフォルダーが散らかるおそれがあります。

失敗時： まずプロジェクト用サブフォルダーを作成し、そのフォルダーに移動するよう勧めてください （例：mkdir ~/my-project && cd ~/my-project）。

2. Git リポジトリがない状態で、既存のコンテンツを置かないこと

以下の 2 つの条件が同時に成立すると、チェックは失敗します。

  • ディレクトリに .claude、.venv、CLAUDE.md、AGENTS.md 以外のファイルまたはフォルダーがある
  • ローカルの git リポジトリが初期化されていない（.git/ が存在しない）

これにより、追跡されていない既存のコンテンツの上に、誤ってプロジェクトを初期化することを防ぎます。

失敗時： 空のディレクトリを使用するか、既存のコンテンツがあることを認識するために、先に git リポジトリを初期化するよう勧めてください。

3. Git の同期

ディレクトリに git リポジトリがあり、リモートが 1 つ以上設定されている場合、スクリプトは自動的に同期します。

  1. 機密ファイルの保護 — 認証情報のパターン（.env／<name>.env／.env.*、id_rsa など、.npmrc／.netrc／.pypirc、.pem、.key、.secret、.p12、.pfx、.jks、.keystore、credentials*.json、secrets.yaml）に一致する未追跡、ステージ済み、または変更済みのファイルがある場合は中止します。テンプレートファイル（.example、.sample、.template など）と削除は無視されます。対処方法はファイルの追跡状態によって異なります。未追跡の場合は .gitignore に追加し、ステージ済みの場合は git restore --staged <file> を実行し、すでに追跡済みの場合は git rm --cached <file> と .gitignore を使用します。
  2. コミット — 未コミットのローカル変更（ステージ済みまたは未ステージ）をコミットします。
  3. プル — 履歴を直線的に保つため、リベースを使用してリモートのコミットを取得します。
  4. プッシュ — ローカルのコミットをリモートにプッシュします。

これにより、毎回のセッションを完全に同期された状態で開始できます。

失敗時： スクリプトは詳細とともに GIT_SYNC_ERROR または SENSITIVE_FILES_DETECTED を報告します。ユーザーは問題を手動で解決し、チェックを再実行する必要があります。

4. 開発ツールのチェック

スクリプトは podman、mise、gh があるかチェックします。いずれかがない場合は、次の内容を出力します。

NEEDS_COMPUTER_SETUP: missing <tool1> <tool2> ...

対応： Skill ツールを使用して cofounder-computer-setup を呼び出し、その指示に従ってください。ツールをインストールした後、事前チェックを再実行してください。

5. Git リモートのチェック

git リモートが設定されていない場合（または git リポジトリが存在しない場合）、スクリプトは次の内容を出力します。

NEEDS_REPO_SETUP: ...

対応： Skill ツールを使用して cofounder-repo-setup を呼び出し、その指示に従ってください。

失敗への対処

事前チェックが失敗した場合（PREFLIGHT_FAILED）：

  1. 各エラーの理由をわかりやすい言葉でユーザーに表示します
  2. 各失敗に対して、推奨される対処方法を提示します
  3. 先に進まないでください — ユーザーが問題を解決して再実行するまで待ちます

事前チェックに合格したものの、NEEDS_ フラグが出力された場合：

  1. 指定されたスキルを順番に実行します。最初に computer-setup、次に repo-setup を実行します
  2. それらが完了したら、セッションを開始します

同梱リソース

スクリプト
  • scripts/preflight.sh — すべての環境検証を実行し、具体的なエラーコードとともに合否を報告します

コメント

Markdown 対応