umbraco-validation-checks について
Umbraco バックオフィス拡張をブラウザーで手動検証するためのリファレンススキルです。設定、ナビゲーション、API、フォーム、ワークスペースのチェックと、一般的な問題の調査手順をまとめています。
主な機能
- 015カテゴリのチェック項目
- 02症状に応じたチェックファイル選択
- 03ブラウザーと DevTools のテスト手順
- 04新しい問題の記録手順
活用シーン
- 01バックオフィスに拡張が表示されない問題の調査
- 02API リクエストやフォーム入力の不具合のデバッグ
- 03ナビゲーションツリーやメニュー表示の確認
- 04ワークスペースの読み込みと保存の検証
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ umbraco/ umbraco-cms-backoffice-skills --skill umbraco-validation-checksインストール後、Claude Code で/umbraco-validation-checksを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
api-debugging-checks.mdconfiguration-checks.mddiscovered-issues.mdform-control-checks.mdnavigation-checks.mdworkspace-checks.md詳細
Umbraco 拡張機能の検証チェック
Umbraco バックオフィス拡張機能の手動ブラウザーテスト向けの検証チェックをまとめたリファレンススキルです。検証テストを開始する前に、このスキルをロードしてください。
チェックのカテゴリ
| カテゴリ | ファイル | チェック |
|---|---|---|
| 構成 | configuration-checks.md | VC-1 から VC-2 |
| ナビゲーション | navigation-checks.md | VN-1 から VN-3 |
| API デバッグ | api-debugging-checks.md | VA-1 から VA-3 |
| フォームコントロール | form-control-checks.md | VF-1 から VF-2 |
| ワークスペース | workspace-checks.md | VW-1 から VW-3 |
クイックリファレンス
| ID | チェック | よくある症状 |
|---|---|---|
| 構成 | ||
| VC-1 | セクションの権限 | 新しいセクションが表示されない |
| VC-2 | ユーザーグループのアクセス | 拡張機能が一部のユーザーにしか表示されない |
| ナビゲーション | ||
| VN-1 | ツリーの複雑さ | ツリーがレンダリングされない、または項目が欠落している |
| VN-2 | 非表示のツリーアクション | 期待するボタンやアクションが見つからない |
| VN-3 | メニュー項目の表示 | メニュー項目が表示されない |
| API デバッグ | ||
| VA-1 | 400 エラーの調査 | API 呼び出しがサイレントに失敗する |
| VA-2 | リクエストペイロードの検証 | 誤ったデータ構造が送信されている |
| VA-3 | CORS と認証の問題 | リクエストがブロックされる、または未認証になる |
| フォームコントロール | ||
| VF-1 | Select/Combobox の動作 | Select に値が入らず、400 エラーが発生する |
| VF-2 | 入力バインディングの問題 | 値が更新または保存されない |
| ワークスペース | ||
| VW-1 | 保存ボタンの欠落 | 編集可能なワークスペースに保存ボタンがない |
| VW-2 | データが読み込まれない | ワークスペースは開くが、値が空で表示される |
| VW-3 | 送信が機能しない | 保存をクリックしても何も起こらない |
使用方法
手動ブラウザー検証を開始する前に、必ずこのスキルをロードしてください。
このスキルは何をチェックするかを扱います。Claude-in-Chrome
(mcp__claude-in-chrome ツール) でバックオフィスを操作する場合は、どのように操作するかについて
umbraco-chrome-navigation もロードしてください。バックオフィスは Lit/shadow-DOM であるため、
これらのチェックが参照する状態を実際にナビゲートし、操作し、読み取るには、shadow-DOM を貫通する
ヘルパーが必要です。
新しい拡張機能を検証するときはすべてのチェックファイルを読み、観察した症状に応じて特定のカテゴリに絞ってください。
| 症状 | ロードするファイル |
|---|---|
| 「拡張機能が表示されない」 | configuration-checks、navigation-checks |
| 「API が動作しない」 | api-debugging-checks |
| 「フォームが動作しない」 | form-control-checks |
| 「ツリーの問題」 | navigation-checks |
| 「ワークスペースの問題」 | workspace-checks |
| 「保存ボタンがない」 | workspace-checks |
検証ワークフロー
- テスト前: 拡張機能がビルドされていること、ブラウザーキャッシュがクリアされていることを確認します
- DevTools コンソールを確認: 操作する前に Chrome DevTools (F12) を開きます
- Network タブを確認:
Fetch/XHRでフィルタリングして API 呼び出しを確認します - 観察した内容に基づいて関連するチェックファイルを読みます
新しい問題の記録
既存のチェックでカバーされていない検証問題に遭遇した場合:
- すぐに記録します
discovered-issues.mdに - 症状、根本原因、解決策、推奨カテゴリを含めます
- 問題はレビューされ、正式なチェックに昇格されます
これにより知識が時間とともに蓄積されます - 検証セッションごとに将来のセッションが改善されます。
関連スキル
| パターン領域 | スキル |
|---|---|
| Claude-in-Chrome 経由でバックオフィスを操作する | umbraco-chrome-navigation |
| ツリーの実装 | umbraco-tree |
| セクションのセットアップ | umbraco-sections |
| API クライアントのセットアップ | umbraco-openapi-client |
| ワークスペースの構造 | umbraco-workspace |
コメント
Markdown 対応