blueprint-promote について
blueprint-promoteは、生成されたルール1件の編集を確認し、`.claude/rules/`に保持するClaude Codeスキルです。マニフェストに上書き情報を記録し、同期時の警告を防ぎます。
主な機能
- 01生成ルール1件の編集を確認
- 02マニフェストに上書き情報を記録
- 03同期時の変更警告を防止
活用シーン
- 01手動編集した生成ルールの保持
- 02編集済みルールの同期警告を抑制
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ laurigates/ claude-plugins --skill blueprint-promoteインストール後、Claude Code で/blueprint-promoteを入力して読み込まれたか確認します。
詳細
生成されたルールをカスタムルールレイヤーにコピーして保持します。
このスキルを使うタイミング
| 次のような場合にこのスキルを使います… | 次のような場合は blueprint-sync を使います… |
|---|---|
| 生成された単一のルールへの手動編集を保持したい場合 | まず、生成されたすべてのコンテンツをスキャンして差分を確認したい場合 |
| 変更した自動生成ファイルに対する同期の警告を停止したい場合 | 多数のファイルに対して、一度に再生成または保持のオプションを適用したい場合 |
| 「提案からカスタムに昇格」または「変更を承認」と指示した場合 | PRD から再生成するには、代わりに blueprint-generate-rules を使います |
手順
目的:
.claude/rules/から生成されたコンテンツをコピーして変更を保持します- マニフェストで承認済みとしてマークし、上書き警告を防ぎます
- 生成されたルールは
.claude/rules/が標準の場所です(v3.0)
使用方法: /blueprint:promote [name]
例:
/blueprint:promote testing-strategies- ルールへの変更を承認します
-
引数を解析する:
- 引数から
nameを抽出します nameが指定されていない場合は、利用可能な生成済みルールを一覧表示して、ユーザーに選択を求めます
- 引数から
-
ルールを特定する:
# Check if it's a generated rule test -f .claude/rules/{name}.md見つからない場合:
Rule '{name}' not found in generated content. Available rules: - architecture-patterns - testing-strategies - implementation-guides - quality-standards -
すでに承認済みか確認する:
custom_overrides.rulesのマニフェストを読み込みます- すでに一覧にある場合は、「すでに承認済み」と報告します
-
承認を確認する:
question: "Acknowledge modifications to {name}?" description: | This will: 1. Mark {name} as user-modified in manifest 2. Prevent overwrite warnings during sync 3. Keep the rule in .claude/rules/ options: - label: "Yes, acknowledge" description: "Mark as user-modified and preserve changes" - label: "No, keep as generated" description: "Leave as regeneratable (may show warnings)" -
マニフェストを更新する:
custom_overrides.rulesに追加しますupdated_atのタイムスタンプを更新します
マニフェスト更新の例:
{ "generated": { "rules": { // testing-strategies still listed } }, "custom_overrides": { "rules": ["testing-strategies"] // added } } -
報告する:
Rule modifications acknowledged! testing-strategies.md: - Location: .claude/rules/testing-strategies.md - Status: User-modified (acknowledged) This rule will now: - Not show modification warnings in /blueprint:sync - Still be tracked in manifest - Be your responsibility to maintain To edit: .claude/rules/testing-strategies.md
アーキテクチャに関する注記(v3.0):
生成されたコンテンツは、独立した生成レイヤーではなく、.claude/rules/ に直接配置されるようになりました。
マニフェストでは、ユーザーが変更したルールと自動生成されたルールを追跡します。
ヒント:
- カスタマイズするルールを承認します
- 承認されていない変更済みのルールは、/blueprint:sync で警告が表示されます
custom_overridesから削除して/blueprint:generate-rulesを実行すると、再生成できます
コメント
Markdown 対応