mcpField
B
blueprint-promote

blueprint-promote

github.com/laurigatesAgent 工作流5957 次安装1 天前更新
代码仓库

关于 blueprint-promote

blueprint-promote 是用于 Claude Code 的 Skill,可将单条生成规则的修改标记为已确认,并保存在 .claude/rules/ 中,避免同步时出现覆盖警告。

主要功能

  1. 01确认单条生成规则的修改
  2. 02更新清单中的自定义覆盖记录
  3. 03减少同步时的修改警告

适用场景

  1. 01保留手动编辑过的生成规则
  2. 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 - 确认某条规则的修改
  1. 解析参数:

    • 从参数中提取 name
    • 如果未提供名称,列出可用的生成规则并请用户选择
  2. 定位规则:

    # 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
    
  3. 检查是否已确认:

    • 读取清单中的 custom_overrides.rules
    • 如果已在列表中,报告“已确认”
  4. 确认修改:

    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)"
    
  5. 更新清单:

    • 添加到 custom_overrides.rules
    • 更新 updated_at 时间戳

    清单更新示例:

    {
      "generated": {
        "rules": {
          // testing-strategies still listed
        }
      },
      "custom_overrides": {
        "rules": ["testing-strategies"]  // added
      }
    }
    
  6. 报告:

    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