engram-tui-quality について
Engram TUI の開発で画面品質のルールを示すスキルです。画面やメニューの追加、操作変更を行う開発者向けに、キー操作や状態表示、ナビゲーションの指針と、動作変更に対する決定的なテストを定めています。
主な機能
- 01画面間でキー操作を一貫させる
- 02空、読み込み、エラー状態を明示
- 03長いリストに省略やスクロールの手掛かりを表示
- 04戻る操作でコンテキストを保持
- 05操作、描画、非同期処理をテスト
活用シーン
- 01TUI の画面やメニュー項目を追加
- 02キー割り当てやナビゲーションを変更
- 03リストや詳細画面の描画を調整
- 04UI 動作変更のテスト範囲を確認
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ gentleman-programming/ engram --skill engram-tui-qualityインストール後、Claude Code で/engram-tui-qualityを入力して読み込まれたか確認します。
詳細
使用する場面
次の場合にこのスキルを使用します:
- 画面やメニュー項目を追加するとき
- キーバインドやナビゲーションの流れを変更するとき
- リストの描画や詳細ビューを更新するとき
UX ルール
- キーボード操作は画面間で一貫している必要があります。
- 空・読み込み中・エラーの状態は明示し、読みやすくする必要があります。
- 長いリストでは、切り詰めやスクロールがわかる明確な手がかりが必要です。
- 戻る操作では、予測可能な形でコンテキストを保持する必要があります。
テストルール
- 新しいキー遷移には
updateテストを追加します。 - 新しい描画分岐には
viewテストを追加します。 - 非同期コマンドやデータ読み込みの経路には
modelテストを追加します。
決定論的なテストがない TUI の動作変更をリリースしてはいけません。
コメント
Markdown 対応