Skip to content

docs(skill): generate --scope による単一バンドルランタイム切替の案内を追加#288

Merged
touyou merged 1 commit into
mainfrom
worktree-design-issue-229-scope-skill
Jul 10, 2026
Merged

docs(skill): generate --scope による単一バンドルランタイム切替の案内を追加#288
touyou merged 1 commit into
mainfrom
worktree-design-issue-229-scope-skill

Conversation

@touyou

@touyou touyou commented Jul 10, 2026

Copy link
Copy Markdown
Member

Summary

  • goodpatch/sparkle-design-internal#229 対応として sparkle-design-cli に generate --scope オプションが追加された(sparkle-design-cli#68, 現在ドラフト・未マージ・未リリース)
  • change-sparkle-config / setup-sparkle-design の複数テーマ案内を、「ケース A: config分割(画面ごとに固定)」「ケース B: generate --scope(単一バンドルでランタイム切替)」の2択に更新。change-sparkle-config はユーザーの要望を1回だけ短く聞き分けて適切な方に誘導する

⚠️ マージ順序の注意

このPRは sparkle-design-cli#68 がマージ・npm公開(2.4.0)されるまでマージしないこと。 npx --yes sparkle-design-cli は常に最新版を取得するため、cli側が未公開のままこのPRをマージすると、AIエージェントが「まだ存在しない --scope オプション」を案内してしまう事故に繋がる(workspace CLAUDE.md のリリース手順に記載のパターン)。

Test plan

  • npx prettier --config ./.prettierrc --check 対象2ファイル — clean
  • sparkle-design-cli#68 のマージ・2.4.0 npm公開を確認してからマージする
  • マージ後、経路A(sparkle-design-internal / sparkle-design-docs / prj-template / sparkle-guide への同期)と経路B(gh workflow run "Publish Skills")の両方を実行する

🤖 Generated with Claude Code

https://claude.ai/code/session_01Rt4q3UhBbZZ4XwAHsJKgyH

sparkle-design-internal#229 対応(sparkle-design-cli#68)で generate --scope
オプションが追加されたことを受け、change-sparkle-config / setup-sparkle-design
の複数テーマ案内を「ケース A: config分割」「ケース B: generate --scope」の
2択に更新。単一バンドル内でランタイムに切り替えたいケースを、これまでの
「config分割一択」の案内から適切な方に振り分けられるようにする。

NOTE: このPRは sparkle-design-cli#68 がマージ・npm公開(2.4.0)されるまで
マージしないこと(npx --yes は常に最新を取得するため、未公開の挙動を
案内してしまう事故を防ぐ)。

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Rt4q3UhBbZZ4XwAHsJKgyH
@vercel

vercel Bot commented Jul 10, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
sparkle-design Ready Ready Preview, Comment Jul 10, 2026 3:04am

Request Review

@coderabbitai

coderabbitai Bot commented Jul 10, 2026

Copy link
Copy Markdown

Review Change Stack

Caution

Review failed

The pull request is closed.

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: 6d5831d0-4d9c-4e0a-9311-a4408347c95e

📥 Commits

Reviewing files that changed from the base of the PR and between 52767b7 and 9cebb80.

📒 Files selected for processing (2)
  • .claude/skills/change-sparkle-config/SKILL.md
  • .claude/skills/setup-sparkle-design/references/config-reference.md

Disabled knowledge base sources:

  • Jira integration is disabled

You can enable these sources in your CodeRabbit configuration.


Walkthrough

複数の固定配色バリアントを切り替える要望に対し、切替方式を確認してケースA/Bを案内する手順を追加しました。非推奨方式とスキル中断条件も明記しています。

Changes

複数配色バリアント案内

Layer / File(s) Summary
ケースA/B案内と中断ガード
.claude/skills/change-sparkle-config/SKILL.md, .claude/skills/setup-sparkle-design/references/config-reference.md
切替方式の確認後、ケースAとしてconfig分割・複数回generate、ケースBとしてgenerate --scope(2.4.0以降)を案内する手順へ更新しました。単一CSSでのTailwindクラス上書きを非推奨とし、いずれの場合もスキルを中断する条件を追加しました。

Estimated code review effort: 2 (Simple) | ~10 minutes

Possibly related PRs

Poem

ぴょんと跳ねて、ケースA、
しっぽを振って、ケースB。
色を切り替え、案内を添え、
非推奨道は避けていく。
ここで止まるよ、にんじん一休み!

✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch worktree-design-issue-229-scope-skill

Comment @coderabbitai help to get the list of available commands.

@touyou touyou marked this pull request as ready for review July 10, 2026 04:44
Copilot AI review requested due to automatic review settings July 10, 2026 04:44
@touyou touyou merged commit 0b7d233 into main Jul 10, 2026
3 of 4 checks passed
@touyou touyou deleted the worktree-design-issue-229-scope-skill branch July 10, 2026 04:44

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

sparkle-design-cli に追加予定の generate --scope(単一バンドルでのランタイム切替)を、Claude skills の案内・参照ドキュメントに反映し、複数テーマ運用の導線を「ケース A/B」に整理するPRです。

Changes:

  • setup-sparkle-design の config リファレンスに、複数テーマ運用の「ケース A/B」(config 分割 vs generate --scope)の案内を追記
  • change-sparkle-config で、複数バリアント要望時に 1 回だけ短くケース判定して適切な README 案内へ誘導する方針に更新

Reviewed changes

Copilot reviewed 2 out of 2 changed files in this pull request and generated 1 comment.

File Description
.claude/skills/setup-sparkle-design/references/config-reference.md 複数テーマ運用の選択肢(ケース A/B)と generate --scope の位置づけを追記
.claude/skills/change-sparkle-config/SKILL.md 複数バリアント要望をケース分岐で案内し、本スキル範囲外として中断する指示を更新

- **画面(ビルド)ごとにバリアントが固定される**(レイアウト単位で読み込む CSS を出し分けられる)→ sparkle-design-cli README の「複数のテーマ配色を 1 デプロイでサポートしたい場合」の **ケース A**(config を分割して複数回 `generate`。生成した複数 CSS を同時 import してはいけない)を案内する
- **単一バンドル内でランタイムに切り替えたい**(`data-*` 属性の付け外しだけで切り替え、ページ遷移や再ビルドを伴わない)→ 同 README の **ケース B**(`generate --scope` で、ベースの通常 `generate` 出力とセマンティックトークンだけをスコープしたリテラル値の差分 CSS を同時 import する。sparkle-design-cli `2.4.0` 以降が必要)を案内する
- 単一 CSS + 属性スコープでの Tailwind クラス上書きは(どちらのケースでも)非推奨
いずれの場合も本スキルはここで中断する(実際の config 分割・`--scope` 実行はユーザー自身か別の作業に委ねる)。
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants