c598c9b05b
- Implemented BlueprintPromptModal component to handle blueprint prompt generation and rule synchronization. - Added BlueprintStatusBadge to display the current status of blueprints in ProjectCard. - Integrated blueprint status fetching and synchronization in ProjectCard. - Enhanced SettingsPage with a new section for MCP service configuration and batch sync for blueprint rules. - Updated commands to include new blueprint-related functionalities and types. - Changed application name from "Dev Manager" to "炼境" in various components.
39 lines
2.4 KiB
Markdown
39 lines
2.4 KiB
Markdown
---
|
||
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 执行"）；🔘状态显示「初始化蓝图」提示词，🟠状态显示「同步描绘」提示词
|