ss-resolve について
ss-resolveは、プロジェクトのデザインルールを扱うワークフロー向けのStyleSeedコンテキスト解決スキルです。レジストリ形式と旧形式に対応し、マニフェストとエビデンスの状態を保持します。
主な機能
- 01レジストリまたはロックファイルのルール解決
- 02有効ルールバンドルとマニフェストの生成
- 03コンテキストの差分検出
- 04設定とエビデンスの診断
- 05セマンティックカラーパレットの生成
活用シーン
- 01デザイン作業前のプロジェクトルール読み込み
- 02アーティファクトのエビデンス確認
- 03読み取り専用の移行評価
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ bitjaru/ styleseed --skill ss-resolveインストール後、Claude Code で/ss-resolveを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
references/artifact-index.schema.jsonartifact.schema.jsoncatalog.jsonmanifest.schema.jsonmigration.mdproject.schema.jsonspacing.mdscripts/compiler.mjsdistribution-integrity.mjslegacy-lock-analysis.mjsmigrate-project.mjspalette-generator.mjsproject-registry.mjsrecommend-spacing.mjsresolve-context.mjsruntime-contract.mjsspacing-contract.mjsspacing-measurement.mjsstyleseed-doctor.mjs詳細
このワークフローの前に、セッションごとに 1 回実行する 更新プリフライト に従ってください。
有効な StyleSeed コンテキストを解決する
バンドルされている scripts/resolve-context.mjs を使用してください。ルールスタックを手動で組み立てないでください。
- まずプロジェクト境界を解決します。
.styleseed/project.jsonまたは.styleseed/artifacts/index.jsonのいずれかが存在する場合は、完全で有効なレジストリを必須とします。レジストリエラー時にSTYLESEED.mdへフォールバックしないでください。このロックを使用するのは、レジストリが存在しない場合のみです。 - 作業ディレクトリはユーザーのプロジェクトルートのままにしてください。スクリプトはインストール済みの
パスで呼び出してください。スキルディレクトリへ
cdしないでください。 - レガシーの単一アーティファクトプロジェクトでは
--from-lock STYLESEED.mdを優先してください。レジストリプロジェクトでは.styleseed/project.jsonと.styleseed/artifacts/*.jsonを使用し、--artifactまたは--allで解決する必要があります。レジストリモードでは、選択のオーバーライドを渡すのではなく、プロジェクト所有の設定を編集してください。 - ビルドする前に、出力されたバンドルを読み取ってください。レガシーは
.styleseed/effective-rules.mdに書き込み、レジストリは.styleseed/bundles/<artifact-id>.mdに書き込みます。 - マニフェスト出力を保持してください。レガシーは
.styleseed/manifest.jsonを使用し、レジストリは.styleseed/manifests/<artifact-id>.jsonを使用します。 --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 を読み込まないでください。より大きなソースドキュメントは、
バンドルがそれを必要とする未解決の曖昧さを指定している場合にのみ読み込んでください。