document について
Document は、機能に関するアクセシビリティの判断を構造化して残すデザインスキルです。判断の背景、トレードオフ、改善計画、WCAG の対応状況をチームで記録できます。
主な機能
- 01背景、選択、代替案、影響、根拠を記録
- 02アクセシビリティのトレードオフと改善策を分析
- 03判断を WCAG 基準に対応付け
- 04判断ログ、課題、未完了項目を整理
活用シーン
- 01チーム変更後もアクセシビリティの判断根拠を維持
- 02ユーザーニーズと制約の衝突を検討
- 03WCAG 対応状況と未解決の作業を追跡
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/インストール後、Claude Code で/documentを入力して読み込まれたか確認します。
詳細
ドキュメントのアクセシビリティに関する決定事項
チームの変更や再設計があっても引き継がれるよう、機能に関するアクセシビリティの決定事項を、構造化された単一の記録にまとめます。
プロセス
ステップ 1：決定事項を特定する
アクセシビリティに影響する設計または実装上の選択をすべて列挙します。
- 選択したインタラクションパターン
- コンテンツと言語に関する決定
- ビジュアルデザインに関する決定
- 実施したことと、先送りしたこと
- 制約下で行ったトレードオフ
ステップ 2：各決定事項を記録する
decision-documentation を使用し、各決定について以下を記録します。
- コンテキスト：決定のきっかけ
- 決定：選択した内容
- 代替案：検討したものの、採用しなかった案
- 影響：誰にメリットがあり、誰に影響が及ぶか
- 根拠：決定を裏付けたもの
ステップ 3：トレードオフを分析する
アクセシビリティを損なう決定や、ユーザーのニーズが相反する決定については、tradeoff-analysis を使用して以下を検討します。
- 各選択肢のメリットを受ける人
- 各選択肢によって不利益を受ける人
- 深刻度の非対称性（利用不可と操作上の不便）
- 利用できないユーザーへの改善計画
- レビュー日
ステップ 4：標準に対応付ける
compliance-mapping を使用して、各決定を関連する WCAG 達成基準に対応付けます。
- この決定が満たす達成基準
- この決定が影響する達成基準
- 適合性のリスクの有無
出力
機能のアクセシビリティに関する決定記録として、以下を提出します。
- 機能の概要 — 構築したものと対象ユーザー
- 決定ログ — 標準形式で記録した各決定
- トレードオフ一覧 — 改善計画を含むトレードオフ
- 適合性マップ — WCAG 達成基準の対応状況とギャップ
- 未解決事項 — 今後の解決が必要な先送り事項
コメント
Markdown 対応