SuperAPI AI 工具集

blueprint-derive-plans

写作与研究

查看项目

更新于 10-15 23:49

技能介绍

用途:当项目已有 git 历史但缺少 PRD/ADR/PRP 文档时,用 /blueprint:derive-plans 回溯生成 Blueprint 文档,把既有项目接入 Blueprint 开发体系。

主要能力:分析 git 历史质量(统计常规提交占比并给出评分);从提交 scope 提取功能边界;识别架构决策(迁移、重大依赖、破坏性变更);发现 TODO、跳过测试等未来工作项;从 git tag 识别发布边界;分析目录结构、框架、入口、数据层、API 层与测试结构;从 package.json、pyproject.toml、Cargo.toml、go.mod 等提取依赖;读取 README、ARCHITECTURE、DESIGN、CONTRIBUTING 等文档。

使用方式:在项目根目录运行 /blueprint:derive-plans。支持参数 --quick(仅扫描最近 50 次提交)与 --since DATE(从指定日期起分析);无参数时默认标准分析(最近 200 次提交)。流程包括校验前置条件、确定分析范围、评估 git 历史质量、提取功能与架构决策、分析代码库与文档、向用户澄清项目背景、生成文档、更新 manifest 并输出报告。生成物为 docs/prds/project-overview.md、docs/adrs/{NNNN}-{title}.md 及索引 docs/adrs/README.md、docs/prps/{feature}.md,并更新 docs/blueprint/manifest.json。写 ADR 后可运行 /blueprint:adr-relationships 与 /blueprint:adr-validate 检查冲突与取代一致性。可选为生成的 PRD/PRP 创建 GitHub 跟踪 issue。

适用场景:项目有 git 历史但无 PRD/ADR/PRP;将成熟项目接入 Blueprint;从提交历史提取功能;回溯记录架构决策。

限制:非 git 仓库或无提交历史会报错;若 Blueprint 未初始化需先初始化或仅做最小导入;项目缺少规范提交与清晰历史时效果受限;决策已完整记录时无需使用。详细模板与报告示例见 REFERENCE.md。