本文へ移動
cccskills
無料GitHub で公開

blazor-ui-conventions

Load for Blazor/MudBlazor component or page changes involving render modes, dialogs, parameters/events, HAL-gated actions, generated API clients or generated record consumption, theming, or component tests; add accessibility or CSS-isolation only when touched.

islamu-ngo/Event
インストール方法を見る

含まれるファイル（10）

  • SKILL.md3.7 KB
  • resources/bem-methodology.md473 B
  • resources/blazouter-routing.md936 B
  • resources/common-patterns.md5.7 KB
  • resources/component-design.md3.9 KB
  • resources/mudblazor-usage.md5.1 KB
  • resources/render-modes.md895 B
  • resources/state-management.md1.3 KB
  • resources/theming.md5.8 KB
  • resources/v9-migration.md2.9 KB

SKILL.md（原文）

インストールする前に、エージェントに与えられる指示の中身を確認できます。

<!-- ABOUTME: Blazor UI conventions for Razor components, MudBlazor v9 usage, render modes, HAL-driven affordances, and shared design-system wrappers. --> <!-- ABOUTME: Keeps Explore.Blazor and Explore.Blazor.Client aligned with InteractiveAuto, wrapper components, immutable state flows, and BFF-safe UI behavior. -->

Resources

  • Blazor architecture — load for hosting, service, generated-client, and component boundaries.
  • Record contracts — load for generated record eligibility, initialization, with, AOT extension data, and diagnostic privacy.
  • Design system — load for tokens or shared wrappers.
  • Accessibility — load only when forms, dialogs, focus, keyboard, landmarks, ARIA, or contrast are touched.

Rules

  • InteractiveAuto is the default. Client-capable paths do not use HttpContext, raw access tokens, or direct component-to-API calls; they use generated clients through the established BFF/service boundary.
  • HAL _links is the sole authority for resource action affordances. Do not infer Edit/Delete or other resource actions from roles, claims, source type, or local state.
  • Generated response/value records use object initializers and with copies. Do not add mutable compatibility setters or hand-edit EventApiClient.g.cs.
  • Protocol inputs, HAL resources, inherited shapes, PATCH/update DTOs, files, exceptions, and the exact mutable UI/service manifest remain classes. Adding or removing a mutable-manifest entry requires a consuming behavior test.
  • [JsonExtensionData] AdditionalProperties remains settable for System.Text.Json AOT. Unknown HAL extension data must round-trip through AppJsonSerializerContext.
  • Generated record diagnostics are value-free, but whole DTO/record logging remains forbidden; log bounded approved scalars.
  • Child-to-parent communication uses [Parameter] and EventCallback; immutable ranges, dates, and generated records are replaced rather than mutated.
  • Use MudBlazor v9 APIs and the shared three-tier token/wrapper system instead of removed APIs or ad hoc styling.

Workflow

  1. Subscribe to the exact component/service behavior before triggering it; do not use timing waits.
  2. When a generated contract changes, regenerate through MSBuild, migrate consumers to initialization/with, and preserve HAL/PATCH/AOT behavior.
  3. Run the component/service slice, generated serialization tests when applicable, then visual QA for rendered changes.

Verification

  • dotnet test --project tests/Event.Architecture.Tests/Event.Architecture.Tests.csproj --configuration Release --verbosity quiet -- --treenode-filter "/*/*/BlazorClientArchitectureTests/*" --minimum-expected-tests 1 --no-progress --maximum-parallel-tests 1
  • dotnet test --project tests/Explore.Blazor.Client.Tests/Explore.Blazor.Client.Tests.csproj --configuration Release --verbosity quiet
  • dotnet test --project tests/Explore.Blazor.IntegrationTests/Explore.Blazor.IntegrationTests.csproj --configuration Release --verbosity quiet

Related

レビュー

まだレビューはありません。使ってみた感想をお寄せください。

ログインしてレビューを書く

同じリポジトリのスキル

概要と使いどころ

accessibility

無料

Load for Blazor/MudBlazor UI changes involving forms, dialogs, focus, keyboard navigation, landmarks, ARIA, color contrast, RTL-safe styling, or WCAG 2.2 AA tests; not for backend-only changes.

日本語の概要は準備中です。原文の説明を表示しています。

islamu-ngo/Event82026年10月8日 更新

agentic-research

無料

Load when a task asks to research, verify, compare, or look up framework/package behavior, release notes, standards, RFCs, CVEs, or unfamiliar APIs; use repository evidence first, then official docs, and not for codebase navigation alone.

日本語の概要は準備中です。原文の説明を表示しています。

islamu-ngo/Event82026年10月8日 更新

aspire

無料

Load for Aspire AppHost work: start/stop/wait resources, inspect dashboard/logs/traces, add integrations/resources, rebuild a service, run isolated worktrees, or diagnose Aspire orchestration; not for plain dotnet apps, container-only deployments, or cloud deployment.

日本語の概要は準備中です。原文の説明を表示しています。

islamu-ngo/Event82026年10月8日 更新

auth-patterns

無料

Load for authentication or authorization changes involving BFF cookies/tokens, JWT validation, claims/user ID extraction, policies, handler access checks, impersonation, or 401/403 bugs; not for UI affordance gating alone.

日本語の概要は準備中です。原文の説明を表示しています。

islamu-ngo/Event82026年10月8日 更新

blazor-bff-patterns

無料

Load for Blazor BFF server work involving YARP proxy routes, cookie sessions, access-token forwarding/refresh, downstream API calls, BFF handlers, or browser-to-API auth failures; not for client component rendering or API JWT validation alone.

日本語の概要は準備中です。原文の説明を表示しています。

islamu-ngo/Event82026年10月8日 更新

blazor-css-isolation

無料

Load when editing Blazor `.razor.css`, scoped selectors, `::deep`, BEM class names, RTL/logical CSS properties, or styling nested MudBlazor components; not for global design tokens or non-Blazor CSS.

日本語の概要は準備中です。原文の説明を表示しています。

islamu-ngo/Event82026年10月8日 更新

islamu-ngo のスキルをすべて見る

このスキルの問題を報告する