用途:在项目中首次初始化 Blueprint Development 结构,创建 docs/blueprint/manifest.json,以及 PRD、ADR、PRP 等文档目录与功能跟踪配置。若项目已存在旧格式 manifest,应改用 blueprint-upgrade;初始化后可用 blueprint-derive-plans 填充文档,用 blueprint-execute 自动检测下一步。
主要流程与能力:检查是否已有 docs/blueprint/manifest.json,存在则询问升级、重新初始化或取消;探测 monorepo 上下文(format_version 3.3.0+),可注册子工作区或根工作区;询问是否启用功能跟踪并创建 feature-tracker.json;扫描项目中的 Markdown 文档,评估跨引用密度后询问是否迁移到 docs/{prds,adrs,prps}/;询问维护任务的执行方式(提示后运行、自动运行安全任务、全自动、仅手动),并据此设置 autonomy_level(0/1/2);询问生成规则的输出路径,默认 .claude/rules/,可选用 .claude/rules/blueprint/ 子目录以避免覆盖手写规则;询问是否启用自动决策检测,启用时将 document-management-rule.md 复制为 $RULES_DIR/document-management.md。
目录与配置:创建 docs/blueprint/work-orders/completed、docs/blueprint/work-orders/archived、docs/adrs、docs/prds、docs/prps;docs/trps 由 /blueprint:derive-tests 按需创建。写入 manifest.json(v3.4.0 schema),含 project、structure、feature_tracker、generated、custom_overrides、automation、task_registry 等字段,内容如上文所列。
典型用法:在 Claude 环境中运行该技能,按交互问答完成配置。必要命令包括:find . -name '.md' -not -path '/node_modules/' -not -path '/.git/*' | grep -viE '(README|CHANGELOG|CONTRIBUTING|LICENSE|CODE_OF_CONDUCT|SECURITY).md$',以及 mkdir -p docs/blueprint/work-orders/completed 等目录创建命令;写入 manifest 后运行一次 /blueprint:workspace-scan 填充子工作区。
限制:资料未提供收费、价格、平台支持范围与效果保证等信息。迁移文档会重写路径并破坏引用,因此当候选文档在 docs/ 之外被引用时应谨慎迁移;默认生成的规则可能覆盖手写规则,建议使用隔离目录。具体行为以实际插件版本为准。