---
id: blueprint-onboarding
name: 蓝图接入引导
status: done
progress: 100
---

## 概述
为无蓝图或蓝图过期的项目提供接入引导：在项目列表展示蓝图状态徽章，并根据不同状态生成对应的 Claude 提示词，由用户复制后粘贴给 Claude 执行。应用负责探测和准备上下文，Claude 负责理解和创作蓝图内容。

## 决策记录

- 提示词生成由 Rust 完成（扫描目录结构、读取 git log、拼接模板），前端只做展示
- 提示词包含完整上下文（项目信息 + 目录结构 + 现有蓝图 + CONVENTIONS 摘要），确保 Claude 无需额外询问
- 目录扫描限深度 3 层，避免输出过大
- 配置文件扫描采用「存在则读」策略：AI 文档（ARCHITECTURE.md/CLAUDE.md/AGENTS.md）自动包含，对无此类文件的简单项目零影响
- monorepo 自动感知：检测到 pnpm-workspace.yaml 等标志文件后，自动读子包配置并调整模块数建议，用户无需手动区分项目复杂度

## 任务卡

### ✅ generate_blueprint_prompt command
- status: done
- complexity: M
- files: src-tauri/src/commands/blueprint.rs
- depends: blueprint-governance
- acceptance: 接收项目路径和提示词类型（init / sync），返回对应提示词字符串；init 类型扫描目录结构 + 读取 README/package.json/Cargo.toml/ARCHITECTURE.md/CLAUDE.md/AGENTS.md/DEVELOPMENT.md（存在才读，不存在跳过）；monorepo 自动检测（pnpm-workspace.yaml/lerna.json/turbo.json），检测到则额外读 apps/ 前4个子包 + packages/ 前2个子包的 package.json，并在提示词中注入 monorepo 提示（模块数建议 10-25、以业务能力为单位划分）；sync 类型额外读取现有蓝图文件 + 近 20 条 git log

### ✅ 项目列表蓝图状态徽章
- status: done
- complexity: M
- files: src/components/dashboard/ProjectCard.tsx
- acceptance: 项目卡片显示蓝图状态徽章（🔘无蓝图 / 🟡规则待更新 / 🟠内容待同步 / 🟢已同步）；🟡状态点击直接执行同步（无需 Claude）；其余状态点击打开操作弹窗

### ✅ 蓝图操作弹窗
- status: done
- complexity: M
- files: src/components/dashboard/BlueprintPromptModal.tsx
- acceptance: 弹窗展示生成的提示词（monospace、可选中）、一键复制按钮、说明文案（"复制后粘贴给 Claude Opus 执行"）；🔘状态显示「初始化蓝图」提示词，🟠状态显示「同步描绘」提示词