关于 blueprint-promote
blueprint-promote 是用于 Claude Code 的 Skill,可将单条生成规则的修改标记为已确认,并保存在 .claude/rules/ 中,避免同步时出现覆盖警告。
主要功能
- 01确认单条生成规则的修改
- 02更新清单中的自定义覆盖记录
- 03减少同步时的修改警告
适用场景
- 01保留手动编辑过的生成规则
- 02避免修改后的规则在同步时被覆盖警告提示
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ laurigates/ claude-plugins --skill blueprint-promote安装后在 Claude Code 中输入/blueprint-promote确认已加载。
详细介绍
复制生成的规则到自定义规则层,以保留修改。
使用此技能的场景
| 在以下情况下使用此技能…… | 在以下情况下改用 blueprint-sync…… |
|---|---|
| 想要保留对单条生成规则的手动修改 | 想要先扫描所有生成内容,检查是否存在偏差 |
| 想要停止针对已修改自动生成文件的同步警告 | 想要一次性处理多个文件的重新生成/保留选项 |
| 你说“将规则从 proposed 提升为 custom”或“确认修改” | 改用 blueprint-generate-rules,从 PRD 重新生成规则 |
步骤
目的:
- 将生成的内容从
.claude/rules/复制出来,以保留修改 - 在清单中标记为已确认,避免覆盖警告
.claude/rules/是生成规则的标准位置(v3.0)
用法:/blueprint:promote [name]
示例:
/blueprint:promote testing-strategies- 确认某条规则的修改
-
解析参数:
- 从参数中提取
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