用途:从 Git 提交历史中提取项目决策,并将其编码为 Claude 规则,用于建立一致的 AI 辅助开发规范。较新的提交在冲突时覆盖较旧决策。
主要能力:分析提交历史质量(提交总数、约定式提交占比);用并行代理按类型提取决策(refactor 提取代码风格、fix 提取重复问题、feat!/BREAKING CHANGE 提取架构决策、chore/build 提取工具决策);按领域、时间与频率整合;解决冲突(新覆盖旧、高频优先、破坏性变更优先);按类别生成规则文件(code-style.md、testing-standards.md、api-conventions.md、error-handling.md、dependencies.md、security-practices.md);处理与已有规则的冲突;更新任务注册表与 manifest 并生成报告。
使用方式:命令为 /blueprint:derive-rules [--since DATE] [--scope SCOPE]。输出路径读取 docs/blueprint/manifest.json 中的 structure.generated_rules_path(默认 .claude/rules/):RULES_DIR=$(jq -r '.structure.generated_rules_path // ".claude/rules/"' docs/blueprint/manifest.json)。需先初始化 Blueprint(/blueprint:init)。生成的规则应通过 paths: frontmatter 限定作用域,除非确实全局适用。
适用场景:项目有较多提交历史、希望提取隐含决策、建立编码标准时。
限制:非 Git 仓库会报错;提交少于 20 条会警告规则可能不完整;父级 .claude/rules/ 中手写文件对本技能不可见;需人工确认重大决策与冲突。