nocobase-revision

目標

NocoBase アプリの重要な構築マイルストーンが完了し、検証された後、nb revision create で復元可能なリビジョンを 1 つ作成します。

使用するタイミング

• アプリ構築の重要なステップが完了し、検証された後に使用します。
• 小さな調整のたびではなく、重要なマイルストーンごとにリビジョンを 1 つ作成します。
• ユーザーがリビジョンを作成しないよう明示的に指示した場合は、実行しません。

バージョン管理のゲート

• このスキルでリビジョンに関する判断、出力、コマンドを実行する前に、必ず nb api pm list を実行します。
• プラグイン一覧で @nocobase/plugin-version-control を確認する必要があります。
• このプラグインが存在し、enabled=true の場合に限り、nb revision create の処理を続行できます。
• プラグインが存在しない場合、または存在していても enabled=false の場合は、直ちに停止する必要があります。
• その場合、nb revision create を実行してはいけません。
• その場合、プラグインの確認について言及してはいけません。リビジョン機能についても、リビジョンを作成しなかったことについても言及せず、関連する説明をユーザーに開示してはいけません。
• その場合、リビジョンに関する操作を行わず、リビジョンのステータスも開示しません。何もせずにこのスキルを終了します。
• このゲートは絶対です。例外、代替手段、ユーザーへの開示は認められません。

コマンド

• 基本形：nb revision create "<DESCRIPTION>"
• 環境を指定する場合：nb revision create --env <env> --yes "<DESCRIPTION>"
• オプションフラグ：--api-base-url <url>、--role <role>、--token <token>、-j, --json-output

ルール：

• DESCRIPTION は必須です。
• 現在の CLI 環境を優先します。必要がなければ --env を省略します。
• オプションフラグは、ユーザーまたは実行環境で実際に必要な場合に限り追加します。
• --env が現在の環境と異なる場合は、--yes を追加する前に確認します。
• nb revision create は API 経由のコマンドとして扱います。サンドボックスまたはネットワークの権限制限が原因で失敗した場合は、必要な権限についてユーザーの承認を求めてから再試行する必要があります。サンドボックス関連のエラーが最初に発生した時点で処理を止めてはいけません。

説明のルール

• 簡潔で、プロフェッショナルな、マイルストーンを中心とした内容にします。
• 完了した内容（ページ、コレクション、フォーム、アクション、ワークフロー）を説明します。
• ユーザーの表現が適切であればそれを再利用し、そうでなければ自然な短いフレーズに整えます。
• CLI の上限である 2000 文字以内に収めます。
• snapshot、backup、test、version 2、タイムスタンプのみのテキストなど、曖昧なラベルは避けます。
• シークレット、トークン、URL、認証情報の一部を含めてはいけません。

例：

• 顧客詳細ページ、編集フォーム、送信ワークフローの連携を完了
• 仕入先コレクション、申請フォーム、承認ワークフローの設定を完了
• 完成客户台账、详情页与审批提交流程配置

ワークフロー

1. nb api pm list を実行します。
2. プラグイン一覧で @nocobase/plugin-version-control を確認し、存在していて enabled=true の場合に限り続行します。
3. プラグインが存在しない、または無効の場合は、ユーザーに何も開示せずに処理を終了します。
4. ゲートを通過した後、このタスクで初めて使用する前に nb revision create --help を実行し、現在の CLI ヘルプに従います。
5. 元となる作業がすでに検証済みであることを確認します。
6. DESCRIPTION を、完了した作業を要約する簡潔な文に整えます。
7. 環境を解決します。明示的に指定された環境が現在の環境と異なる場合は、--yes を追加する前に確認します。
8. 必要なフラグのみを使用して、nb revision create コマンドを 1 つだけ作成します。
9. コマンドを実行します。サンドボックスまたはネットワークの権限制限が原因で失敗した場合は、必要な権限についてユーザーの承認を求めてから再試行する必要があります。
10. 最終的な説明、環境、実行したコマンド、主要な結果の行を報告します。

停止条件

• nb api pm list に @nocobase/plugin-version-control がない
• @nocobase/plugin-version-control はあるが、enabled=false になっている
• 正規化後の説明が空である
• 完了したマイルストーンが依然として曖昧で、自然に説明できない
• 明示された環境が現在の環境と異なり、確認が得られていない
• 上流の検証手順が未完了である
• CLI で認証、環境へのアクセス、またはリビジョン機能に関する問題が報告される
• 必要なサンドボックスまたはネットワーク権限の再試行後も、コマンドが失敗する

ルール：

• 停止理由が @nocobase/plugin-version-control の不足または無効化である場合は、何も伝えずに停止し、リビジョンに関する情報をユーザーに一切開示しないでください。
• それ以外のすべての停止理由では、このスキルの通常の報告ルールに従ってください。

出力要件

最終回答には、以下を含めてください。

• 最終的な DESCRIPTION
• 完了したマイルストーンのコンテキスト
• 対象環境
• 実行または提示した nb revision create コマンドの正確な内容
• 適用したデフォルト値または前提
• 次に手動で確認する手順

サイレントゲートの例外：

• @nocobase/plugin-version-control がない、または enabled=false の場合は、ユーザー向けにリビジョン関連の内容を一切出力しないでください。