fstack-design について
fstack-design は、既存プロジェクトの UI を扱うエージェント向けのレビュー・調整スキルです。プロジェクトのデザインシステムに照らして画面を確認し、修正前に承認を求めます。
主な機能
- 01スタイル、トークン、既存コンポーネントを調査
- 02デザインシステムからの逸脱を特定
- 03よくある視覚的不整合を指摘
- 04既存トークンやパターンを提案
- 05承認済みの修正をコンポーネント単位で適用
活用シーン
- 01一貫性に欠ける新規画面のレビュー
- 02既存スタイルに合わせたコンポーネント調整
- 03エージェントによる変更後の UI 整理
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ flaviocopes/ fstack --skill fstack-designインストール後、Claude Code で/fstack-designを入力して読み込まれたか確認します。
詳細
/fstack-design
エージェントはデザインのスロップを書いてしまいます。ランダムなグラデーション、5 種類のフォントサイズ、パレットから外れた色、決して繰り返されない余白。このスキルは、UI をプロジェクトがすでに持っているスタイルに準拠させ、それ以外の部分を素朴なデザインセンスに照らして整理します。
これが強制するルールは、まず既存のものに合わせることです。新しい UI は、別のアプリから貼り付けたように見えるのではなく、そこに属しているように見えるべきです。
使用するとき
- 新規または変更された UI が、ずれている、ありきたり、または他と一貫していない。
- エージェントがちょうど画面を作成し、それがスロップのように感じられる。
- ページ、コンポーネント、または UI 全体に対して
/fstack-designを呼び出します。
手順
- 何かに触れる前に既存のデザインシステムを学びます。スタイルシート、トークン、テーマ、そしていくつかのよく作られた既存コンポーネントを読みます。実際のパレット、タイプスケール、スペーシングスケール、角丸、シャドウ、およびすでに使用されているコンポーネントパターンを書き留めます。
- 対象の UI を次の 2 つの観点でレビューします。
- 既存のシステム — 既存のものを再利用する代わりに、どこで色、サイズ、余白、またはコンポーネントをでっち上げているか?
- 素朴なデザインセンス — 階層、整列、一貫した余白、抑制。スロップの兆候にフラグを立てます。動機のないグラデーション、多すぎるフォントサイズ、一貫しないパディング、ランダムなシャドウ、アイコンとしての絵文字、パレットから外れた単発の色、冗長なラッパー div。
- 短い所見リストを作成します。各項目は、何がずれているか、そして代わりに使用すべき既存のトークンまたはパターンです。
- 停止して尋ねます。どれを適用するかを。
- 承認された項目を、一度に 1 つの画面またはコンポーネントずつ修正し、既存のトークンとクラスを再利用します。ユーザーがシステムに本当に何かが欠けていることに同意しない限り、新しいものをでっち上げてはいけません。差分を表示します。
してはいけないこと
- プロジェクトにすでに合うものがあるのに、新しい色、フォント、余白値、またはコンポーネントをでっち上げること。
- 再設計すること。これは整列と整理を行うのであり、製品を再構想するのではありません。
- 「修正」のために UI フレームワークやコンポーネントライブラリを追加すること。
- 承認なしに変更を適用すること。
例
ユーザー:
/fstack-design新しい設定ページがずれて見えるエージェント: 「まずデザインシステムを読みます。設定ページに関する所見:
- 保存ボタンに
#3b82f6を使用している — アプリのプライマリは--color-accentです。トークンを使用してください。- ここには 3 つの見出しサイズがあるが、アプリの残りは 2 つ(
--text-lg、--text-base)を使用しています。真ん中のものを削除してください。- カードのパディングが
18px— 他のすべてのカードは--space-4(16px)を使用しています。合わせてください。- グラデーションのヘッダー背景 — アプリの他のどこもグラデーションを使用していません。フラットなサーフェス色を使用してください。
- タブに絵文字アイコン。アプリは
src/iconsのアイコンセットを使用しています。差し替えてください。すべて修正しますか、それとも選びますか? 一度に 1 セクションずつ行い、差分を表示します。」
コメント
Markdown 対応