audit-stories について
既存のユーザーストーリーにあるアクセシビリティの不足を確認し、別チケットを作らず元のストーリーに具体的な受け入れ条件を追加するスキルです。多様な入力方法、感覚、認知のニーズを扱い、項目別の監査レポートを作成します。
主な機能
- 01キーボードとスクリーンリーダー対応の確認
- 02視覚・運動・認知面のアクセシビリティ確認
- 03能力や状況に関する前提の特定
- 04既存ストーリーへの条件追加
- 05概要と項目別の監査結果を作成
活用シーン
- 01スプリントのユーザーストーリーを監査
- 02機能のストーリー群における対応状況を確認
- 03不足のあるストーリーに使える条件を記述
- 04複数のストーリーに共通する設計漏れを発見
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ owl-listener/ inclusive-design-skills --skill audit-storiesインストール後、Claude Code で/audit-storiesを入力して読み込まれたか確認します。
詳細
ユーザーストーリーのインクルージョン監査
既存のユーザーストーリーをレビューし、障害や多様な能力が見落とされている箇所を特定してから、アクセシビリティ専用のチケットを別途作成せずに、不足している基準を追加します。
プロセス
ステップ 1:ストーリーを集める
監査対象のユーザーストーリーを集めます。スプリントのバックログ、ある機能に関するストーリー一式、またはエピックが対象になります。
ステップ 2:各ストーリーを確認する
inclusive-user-stories を使用して、各ストーリーの受け入れ基準を次の観点でレビューします。
- キーボードでの操作性
- スクリーンリーダーへの対応
- 視覚的なアクセシビリティ(コントラスト、色への依存がないこと、ズーム)
- 運動機能に関するアクセシビリティ(ターゲットサイズ、時間制限、精度)
- 認知に関するアクセシビリティ(平易な表現、エラーからの回復、元に戻す機能)
これらのうち、1 つ以上が欠けているストーリーにフラグを付けます。
ステップ 3:思い込みによる偏りを確認する
edge-case-identification を使用して、各ストーリーについて次の点を確認します。
- どのような入力方法を前提にしていますか?
- どのような感覚能力を前提にしていますか?
- どのような認知能力を前提にしていますか?
- どのような状況を前提にしていますか?
- 一部のユーザーにとって日常的な現実であるにもかかわらず、「エッジケース」として退けられているものはありませんか?
ステップ 4:不足している基準を追加する
フラグを付けた各ストーリーについて、追加が必要な具体的な受け入れ基準を記述します。別のストーリーは作成せず、既存のストーリーに直接追加します。
出力
監査レポートを作成します。
- 概要 — レビューしたストーリーの数、ギャップがあったストーリーの数、最もよく見られたギャップの種類
- ストーリーごとの調査結果 — 不足している基準を一覧にした各ストーリー
- 追加する基準 — 各ストーリーに追加する、バックログにそのまま貼り付けられる具体的な受け入れ基準
- パターン — システム上の問題を示唆する、繰り返し見られるギャップ(例:「このスプリントのどのストーリーにもキーボードでのアクセスが記載されていない」)
コメント
Markdown 対応