umbraco-review-checks について
`umbraco-extension-reviewer` エージェント向けに、Umbraco 拡張機能のコード品質、アーキテクチャ、UI パターンのレビュー項目をまとめたスキルです。拡張機能の種類に応じた参照ファイルと、重要度や自動修正の可否も示します。
主な機能
- 01コード品質のレビュー項目
- 02アーキテクチャのレビュー項目
- 03UI パターンのレビュー項目
- 04拡張機能の種類別ファイル案内
- 05重要度と自動修正の一覧
活用シーン
- 01Umbraco のダッシュボードやワークスペースのレビュー
- 02プロパティエディターやエンティティ操作の確認
- 03コンテキストやリポジトリ拡張のレビュー
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ umbraco/ umbraco-cms-backoffice-skills --skill umbraco-review-checksインストール後、Claude Code で/umbraco-review-checksを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
architecture-checks.mdcode-quality-checks.mdui-pattern-checks.md詳細
Umbraco 拡張機能レビューチェック
umbraco-extension-reviewer エージェントのすべてのレビューチェックを含むリファレンススキルです。
チェックカテゴリ
| カテゴリ | ファイル | チェック |
|---|---|---|
| コード品質 | code-quality-checks.md | CQ-1 から CQ-9 |
| アーキテクチャ | architecture-checks.md | AR-1 から AR-6 |
| UI パターン | ui-pattern-checks.md | UI-1 から UI-7 |
クイックリファレンス
| ID | チェック | 重大度 | 自動修正 |
|---|---|---|---|
| コード品質 | |||
| CQ-1 | 拡張機能タイプの使用 | 重大 | はい |
| CQ-2 | マニフェスト登録 | 高 | いいえ |
| CQ-3 | 要素の実装 | 中 | 一部 |
| CQ-4 | Context API の使用 | 高 | いいえ |
| CQ-5 | 状態管理 | 中 | いいえ |
| CQ-6 | ローカライゼーション | 中 | 一部 |
| CQ-7 | 命名規則 | 低 | いいえ |
| CQ-8 | 条件 | 低 | いいえ |
| CQ-9 | プロパティエディタースキーマエイリアス | 重大 | いいえ |
| アーキテクチャ | |||
| AR-1 | API クライアントへの直接アクセス | 高 | いいえ |
| AR-2 | ワークスペースコンテキストの欠如 | 高 | いいえ |
| AR-3 | ソースパターンの検証 | 中 | いいえ |
| AR-4 | 一貫性のない永続化 | 中 | いいえ |
| AR-5 | リポジトリレイヤーの欠如 | 高 | いいえ |
| AR-6 | 循環コンテキスト依存関係 | 重大 | いいえ |
| UI パターン | |||
| UI-1 | カスタムエラー処理 | 高 | 一部 |
| UI-2 | レイアウトコンポーネントの問題 | 高 | いいえ |
| UI-3 | 非 UUI コンポーネントの使用 | 中 | 一部 |
| UI-4 | Enum/Select の処理 | 中 | 一部 |
| UI-5 | ローディング状態の欠如 | 低 | いいえ |
| UI-6 | アクセシビリティの問題 | 中 | いいえ |
| UI-7 | インラインスタイル | 低 | 一部 |
使用方法
拡張機能のタイプに基づいて、関連するカテゴリファイルを読み取ります:
| 拡張機能タイプ | 読み込むファイル |
|---|---|
| ダッシュボード | 3 つすべて |
| ワークスペース | 3 つすべて |
| プロパティエディター | code-quality、ui-pattern |
| エンティティアクション | code-quality のみ |
| Context/Repository | code-quality、architecture |
関連スキル
| パターン領域 | スキル |
|---|---|
| リポジトリパターン | umbraco-repository-pattern |
| ワークスペースコンテキスト | umbraco-workspace |
| 通知 | umbraco-notifications |
| Context API | umbraco-context-api |
| ローカライゼーション | umbraco-localization |
ソースリファレンス
UUI ライブラリ
UI パターンチェックについては、コンポーネントのベストプラクティスとして UUI (Umbraco UI) ライブラリを参照してください。
まずローカルで確認 - UUI ソースがワークスペース (例: Umbraco.UI/packages/) で利用可能な場合があります。Glob を使用して検索してください。
オンラインリソース:
- Storybook: https://uui.umbraco.com/
- GitHub: https://github.com/umbraco/Umbraco.UI
Umbraco CMS ソース
アーキテクチャとパターンのチェックについては、Umbraco CMS のソース実装と比較してください。
まずローカルで確認 - Umbraco CMS ソースがワークスペース (例: Umbraco-CMS/src/Umbraco.Web.UI.Client/) で利用可能な場合があります。Glob を使用してリファレンス実装を検索してください。
オンラインリソース:
レビュー時は、正確性と速度のために、Web からの取得よりもローカルソースを優先してください。
コメント
Markdown 対応