mcpField
A
audit-stories

audit-stories

github.com/owl-listenerテスト・品質10873 回インストール20 週間前に更新
リポジトリ

audit-stories について

既存のユーザーストーリーにあるアクセシビリティの不足を確認し、別チケットを作らず元のストーリーに具体的な受け入れ条件を追加するスキルです。多様な入力方法、感覚、認知のニーズを扱い、項目別の監査レポートを作成します。

主な機能

  1. 01キーボードとスクリーンリーダー対応の確認
  2. 02視覚・運動・認知面のアクセシビリティ確認
  3. 03能力や状況に関する前提の特定
  4. 04既存ストーリーへの条件追加
  5. 05概要と項目別の監査結果を作成

活用シーン

  1. 01スプリントのユーザーストーリーを監査
  2. 02機能のストーリー群における対応状況を確認
  3. 03不足のあるストーリーに使える条件を記述
  4. 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:不足している基準を追加する

フラグを付けた各ストーリーについて、追加が必要な具体的な受け入れ基準を記述します。別のストーリーは作成せず、既存のストーリーに直接追加します。

出力

監査レポートを作成します。

  1. 概要 — レビューしたストーリーの数、ギャップがあったストーリーの数、最もよく見られたギャップの種類
  2. ストーリーごとの調査結果 — 不足している基準を一覧にした各ストーリー
  3. 追加する基準 — 各ストーリーに追加する、バックログにそのまま貼り付けられる具体的な受け入れ基準
  4. パターン — システム上の問題を示唆する、繰り返し見られるギャップ(例:「このスプリントのどのストーリーにもキーボードでのアクセスが記載されていない」)

コメント