ss-reference について
提示されたデザイン参考資料を、プロジェクト内のルールや成果物にまとめるワークフロー用スキルです。根拠の収集、参考資料間の矛盾の解決、代表画面での文法の検証を支援します。
主な機能
- 01参考資料への根拠ID付与
- 0212軸での観察
- 03参考資料間の矛盾解決
- 04プロジェクト内ルールのコンパイル
- 05代表画面での検証
活用シーン
- 01提示された画面からデザインルールを抽出
- 02異なる製品画面ごとに参考資料をコンパイル
- 03抽出したデザイン文法が別画面にも適用できるか確認
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ bitjaru/ styleseed --skill ss-referenceインストール後、Claude Code で/ss-referenceを入力して読み込まれたか確認します。
詳細
このワークフローを開始する前に、セッションごとに一度だけ実行する更新の事前確認に従ってください。
参考資料をデザイングラマーにまとめる
レジストリ優先の成果物境界
.styleseed/project.json と .styleseed/artifacts/index.json が存在する場合は、まず要求された成果物 ID を解決してから、.styleseed/bundles/<artifact-id>.md と .styleseed/manifests/<artifact-id>.json のみを読み取ります。レジストリを使用するプロジェクトでは、グローバルなレガシーバンドルにフォールバックしてはいけません。レガシープロジェクトでは、レジストリが存在しない場合に限り、.styleseed/effective-rules.md を使用できます。
提供された画面を単に模倣するだけではいけません。PRODUCT-PRINCIPLES.md、RULESETS.md、
ADAPTERS.md、REFERENCE-COMPILER.md を読み、コンパイラのパイプラインを最後まで実行してください。
ワークフロー
- 提供されたすべての参考資料を取り込み、エビデンス ID(
R1、R2、...)を割り当てます。URL をレンダリングできる場合は、キャプチャしてください。画像を確認できない場合、その画像について視覚的な分析を行ったと主張するのはやめてください。 - 参考資料をサーフェスアダプターと用途ごとに分けます。ユーザーが両者を結び付けることを明示的に求めていない限り、マーケティング用ホームページとアプリのダッシュボードを混在させてはいけません。
- 12 の軸を観察し、測定します。各ルールにエビデンス ID と信頼度を記載します。
- 矛盾は平均化せず、解決します。重要な判断については、簡潔に説明します。
- 最も近い組み込みのフォールバックグラマーとアダプターを選び、
REFERENCE-COMPILER.mdに従って、.styleseed/rulesets/<slug>/配下に必要なプロジェクト成果物をコンパイルします。 - レジストリを使用するプロジェクトでは、選択した成果物のプロジェクト所有の設定で
reference:<slug>を選択します。レジストリ関連ファイルがどちらも存在しない場合に限り、レガシーのSTYLESEED.mdを更新します。部分的または無効なレジストリはエラーであり、フォールバックしてはいけません。制約されたブランド上の選択を維持します。 - 文法をソースセットに含まれない代表的な画面に適用して転用性を検証し、
/ss-scoreを実行します。レンダリング可能な場合は、その後/ss-verifyを実行します。許可された検証範囲内で、合格するまで、または各ゲートにつき修正を3回行うまで、修正して再実行します。委任したパスも回数に含めます。スキルを切り替えて予算をリセットしてはいけません。実際のスコアと未解決の失敗を報告します。 - 判明したこと、信頼度がまだ低い点、成果物の保存場所、検証結果を報告します。
ルール
- 形容詞よりも、目に見えるエビデンスを優先します。「落ち着いた印象」はルールではありません。落ち着いた印象を生み出す余白、書体、色、階層、モーションの選択がルールです。
- 保護対象のアセット、ブランドマーク、文章をコピーしてはいけません。
- 参考資料が1つの場合、生成される文法は暫定版です。必要に応じて、その旨を伝え、信頼度を低く保ちます。
- 生成される文法はプロジェクト内に限定されます。
RULESETS.mdを編集したり、組み込みとして公開したりしてはいけません。 - コアとなる不変条件とアクセシビリティは、譲れない要件です。
コメント
Markdown 対応