mcpField
E
engram-tui-quality

engram-tui-quality

github.com/gentleman-programmingデザイン・UI7.7k78 回インストール今日更新
リポジトリ

engram-tui-quality について

Engram TUI の開発で画面品質のルールを示すスキルです。画面やメニューの追加、操作変更を行う開発者向けに、キー操作や状態表示、ナビゲーションの指針と、動作変更に対する決定的なテストを定めています。

主な機能

  1. 01画面間でキー操作を一貫させる
  2. 02空、読み込み、エラー状態を明示
  3. 03長いリストに省略やスクロールの手掛かりを表示
  4. 04戻る操作でコンテキストを保持
  5. 05操作、描画、非同期処理をテスト

活用シーン

  1. 01TUI の画面やメニュー項目を追加
  2. 02キー割り当てやナビゲーションを変更
  3. 03リストや詳細画面の描画を調整
  4. 04UI 動作変更のテスト範囲を確認

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/gentleman-programming/engram --skill engram-tui-quality

インストール後、Claude Code で/engram-tui-qualityを入力して読み込まれたか確認します。

詳細

使用する場面

次の場合にこのスキルを使用します:

  • 画面やメニュー項目を追加するとき
  • キーバインドやナビゲーションの流れを変更するとき
  • リストの描画や詳細ビューを更新するとき

UX ルール

  1. キーボード操作は画面間で一貫している必要があります。
  2. 空・読み込み中・エラーの状態は明示し、読みやすくする必要があります。
  3. 長いリストでは、切り詰めやスクロールがわかる明確な手がかりが必要です。
  4. 戻る操作では、予測可能な形でコンテキストを保持する必要があります。

テストルール

  • 新しいキー遷移には update テストを追加します。
  • 新しい描画分岐には view テストを追加します。
  • 非同期コマンドやデータ読み込みの経路には model テストを追加します。

決定論的なテストがない TUI の動作変更をリリースしてはいけません。

コメント