mcpField
S
ss-resolve

ss-resolve

github.com/bitjaruデザイン・UI993571 回インストール1 日前に更新
リポジトリ

ss-resolve について

ss-resolveは、プロジェクトのデザインルールを扱うワークフロー向けのStyleSeedコンテキスト解決スキルです。レジストリ形式と旧形式に対応し、マニフェストとエビデンスの状態を保持します。

主な機能

  1. 01レジストリまたはロックファイルのルール解決
  2. 02有効ルールバンドルとマニフェストの生成
  3. 03コンテキストの差分検出
  4. 04設定とエビデンスの診断
  5. 05セマンティックカラーパレットの生成

活用シーン

  1. 01デザイン作業前のプロジェクトルール読み込み
  2. 02アーティファクトのエビデンス確認
  3. 03読み取り専用の移行評価

インストール

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

$npx skills add https://github.com/bitjaru/styleseed --skill ss-resolve

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

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

references/
artifact-index.schema.json
artifact.schema.json
catalog.json
manifest.schema.json
migration.md
project.schema.json
spacing.md
scripts/
compiler.mjs
distribution-integrity.mjs
legacy-lock-analysis.mjs
migrate-project.mjs
palette-generator.mjs
project-registry.mjs
recommend-spacing.mjs
resolve-context.mjs
runtime-contract.mjs
spacing-contract.mjs
spacing-measurement.mjs
styleseed-doctor.mjs

詳細

このワークフローの前に、セッションごとに 1 回実行する 更新プリフライト に従ってください。

有効な StyleSeed コンテキストを解決する

バンドルされている scripts/resolve-context.mjs を使用してください。ルールスタックを手動で組み立てないでください。

  1. まずプロジェクト境界を解決します。.styleseed/project.json または .styleseed/artifacts/index.json のいずれかが存在する場合は、完全で有効なレジストリを必須とします。レジストリエラー時に STYLESEED.md へフォールバックしないでください。このロックを使用するのは、レジストリが存在しない場合のみです。
  2. 作業ディレクトリはユーザーのプロジェクトルートのままにしてください。スクリプトはインストール済みの パスで呼び出してください。スキルディレクトリへ cd しないでください。
  3. レガシーの単一アーティファクトプロジェクトでは --from-lock STYLESEED.md を優先してください。レジストリプロジェクトでは .styleseed/project.json と .styleseed/artifacts/*.json を使用し、--artifact または --all で解決する必要があります。レジストリモードでは、選択のオーバーライドを渡すのではなく、プロジェクト所有の設定を編集してください。
  4. ビルドする前に、出力されたバンドルを読み取ってください。レガシーは .styleseed/effective-rules.md に書き込み、レジストリは .styleseed/bundles/<artifact-id>.md に書き込みます。
  5. マニフェスト出力を保持してください。レガシーは .styleseed/manifest.json を使用し、レジストリは .styleseed/manifests/<artifact-id>.json を使用します。
  6. --check を使用すると、ファイルを書き換えずにコンテキストのドリフトを検出できます。

スペーシングの推奨事項とスコープ付き制御については、スペーシャルロールガイドを参照してください。 オプションのプロジェクト/アーティファクト spacing は、バンドル内のロールテーブルとアーティファクトスコープの CSS にコンパイルされます。 recommend-spacing.mjs --project-root . --artifact <id> は読み取り専用の開始提案を出力します。実装トークンを検査または書き換えたり、 設計上の承認を確立したりするものではありません。オプションの --measurement <project-relative-report.json> は、ソースに紐づくレンダリング診断を追加します。古いまたは 矛盾するレポートは拒否され、開始値は明示的にヒューリスティックなままです。

インストールやプロジェクトの健全性に関する質問については、まず読み取り専用の診断を実行してください。

レガシーからレジストリへの移行が要求された場合は、まず migrate-project.mjs --dry-run を検査してください。 計画の形式と適用順序については、レビュー済み移行ガイドに従ってください。 素の --write パスは、レビューされていないデフォルトを意図的に拒否します。移行の適用には、 完全な人手によるレビュー済みの計画、現在のロックハッシュ、セクションとアーティファクトの 1 対 1 のマッピング、 およびその計画の正確なハッシュに一致する --confirm-plan が必要です。有効なスキーマやドライランは、 設計上の判断が保持された証拠にはなりません。承認を推測したり、診断リクエストから書き込みを実行したりしないでください。

node <installed-ss-resolve>/scripts/styleseed-doctor.mjs --project-root . --json

これは、ローカルのディストリビューションインベントリ、プロジェクト設定、コンパイル済みルール、および保存された エビデンスを現在の入力と照合してチェックします。--artifact <id> を使用して、レジストリチェックを絞り込めます。これは プロジェクトのセットアップ、移行、再コンパイル、レンダリング、更新を一切行いません。その next アクションには、 ユーザーの承認の範囲内でのみ従ってください。終了コード 0 は、選択されたすべてのアーティファクトについてエビデンスが最新であることを意味し、 独立した視覚的判断を意味するものではありません。終了コード 1 は注意が必要であることを意味し、終了コード 2 は無効な呼び出しを意味します。 レガシープロジェクトでは、ルールが最新であってもエビデンスが unsupported のままである場合があります。インストールの 完全性は、ホストによる検出、発行元の真正性、または最新の上流リビジョンを証明するものではありません。

node <installed-ss-resolve>/scripts/resolve-context.mjs \
  --from-lock STYLESEED.md \
  --agent codex

レジストリプロジェクト:

node <installed-ss-resolve>/scripts/resolve-context.mjs \
  --project-root . \
  --artifact app-dashboard \
  --agent codex

ロックがない場合:

node <installed-ss-resolve>/scripts/resolve-context.mjs \
  --agent claude \
  --grammar operations-console \
  --adapter product-ui \
  --domain saas \
  --page dashboard \
  --recipe enterprise-workbench \
  --palette cobalt-instrument \
  --key-color "#175CD3" \
  --palette-character balanced \
  --palette-mode light \
  --palette-harmony auto \
  --surface-temperature cool \
  --profile swiss

--list を使用して、サポートされている ID を出力します。--recipe auto は選択されたグラマーを保守された デフォルトにマッピングし、--palette auto はそのレシピをコントラスト検証済みのセマンティックパレットにマッピングします。製品が異なる モーフォロジーやカラーの姿勢を必要とする場合は、明示的な値を渡してください。デフォルトの 出力ディレクトリは、プロジェクトルートの .styleseed/ です。プロジェクトローカルの参照グラマーには、reference:<slug> を渡し、 .styleseed/rulesets/<slug>/RULESET.md が存在することを確認してください。レジストリプロジェクトでは、完全な 6 ファイルの 参照コントラクト(RULESET.md、tokens.json、evidence.json、checks.md、 reference-board.html、adapter.json)が必要です。 フラグまたはロックにキーカラーが存在する場合、リゾルバーは共有の OKLCH ジェネレーターを使用し、 .styleseed/palette.json と .styleseed/palette.css を書き出します。マニフェストには生成の 入力が記録されます。維持されているレシピは引き続きプロダクトの姿勢と意味的な制約を提供しますが、その固定された 16 進値は生成されたシステムを上書きするのではなく、フォールバックとなります。

バンドルが正常に解決された後に llms-full.txt を読み込まないでください。より大きなソースドキュメントは、 バンドルがそれを必要とする未解決の曖昧さを指定している場合にのみ読み込んでください。

コメント