fallow-codex-onboarding

Codex で Fallow をセットアップする

Fallow アプリのツールを使います。各ステップは短くしてください。一度に質問するのは1つだけです。

1. インストールを確認する

fallow_check_install を {} で呼び出します。

• バージョンが報告された場合は、次に進みます。
• fallow が見つからない場合は、このアプリは fallow CLI をローカルで実行し、コードがマシンの外に出ることはないと説明します。npm install --global fallow でグローバルにインストールすることを提案します。サイドバーのダッシュボードには PATH 上に fallow が必要です。アプリがプロジェクト内のコピーを実行するのは、スレッドの Codex サンドボックス内に限られるためです。ユーザーの同意を得てからインストールを実行します。その後、fallow_check_install をもう一度呼び出します。

2. デフォルトを選択する

fallow_settings_read を {} で呼び出します。次の質問を一度に1つずつ尋ねます。ユーザーがすでに回答している質問は省略します。

1. 「デフォルトでプロジェクト全体を分析しますか。それとも、ブランチで変更したファイルだけを分析しますか？」プロジェクト全体は scope: "full" に、変更したファイルは scope: "changed" に対応させます。
2. 「テスト、ストーリー、開発ツールを分析対象から除外しますか？」はいの場合は production: true に対応させます。

変更された値のみを含む set オブジェクトを指定して、fallow_settings_update を呼び出します。例：{"set":{"scope":"changed"}}。変更がない場合は呼び出しを省略します。ツールの結果から保存された値を報告します。呼び出しに失敗した場合は、値が保存されたと言わないでください。

3. 最初の分析を実行する

fallow_analyze を {} で呼び出します。ユーザーにはダッシュボードが表示されます。2～3文で、健全性スコア、指摘事項が最も多いカテゴリ、最初に取り組む指摘事項を1つ伝えます。

結果にプロジェクトが不明と表示される場合は、このスレッドでプロジェクトフォルダーを開くようユーザーに依頼してから、fallow_analyze をもう一度呼び出します。

4. アプリでできることを紹介する

次の内容を短いリストでユーザーに伝えます。

• サイドバーの Fallow を開くと、完全なダッシュボードが表示されます。
• Code Health を開くとスレッドの横に表示され、そのスレッドのプロジェクトを追跡します。
• コンポーザーに @Fallow と入力すると、指摘事項またはルールに該当するすべての指摘事項を添付できます。
• .fallowrc.json または .fallowrc.jsonc を開くと、ルールを編集し、保存前にその影響をプレビューできます。.sarif ファイルを開くと、指摘事項ビューアーが表示されます。
• コミットの前に、Codex にブランチの監査を依頼してください。

5. 次のステップを提案する

プロジェクトに fallow 設定ファイル（.fallowrc.json、.fallowrc.jsonc、fallow.toml、.fallow.toml）がない場合は、fallow-setup スキルを使って設定ファイルと CI ゲートを追加することを提案します。ユーザーが別のタスク中にプラグインをインストールした場合は、この会話でそのタスクを続けます。