要让codebuddy的craft智能体生成开箱即用的完整项目，需明确提供【项目类型+运行载体+核心功能】三要素；或通过cli命令（如codebuddy init）调用模板/元数据文件初始化；亦可上传prd文档由craft反向推导并生成可运行的前端或后端项目结构。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
想让CodeBuddy的Craft智能体直接生成一个开箱即用、能运行起来的完整项目，而不是零散代码片段或单个文件，关键在于触发它的全链路工程构建能力——它需要明确感知“这是一个独立可执行项目”，而非局部补全。
用自然语言精准触发全项目生成
在Craft对话框中输入需求时，必须包含【项目类型+运行载体+核心功能】三要素，例如：“开发一个基于Flask的天气查询API服务，支持GET /weather?city=北京，返回JSON格式数据，带Dockerfile和requirements.txt，能本地docker run启动”。
这一步不能只说“写个天气API”，缺少运行载体（Flask/Docker）和交付形态（可执行服务），Craft会默认生成单个.py文件，不带依赖声明和容器化配置。
发送后，Craft会先输出Plan：列出将创建的文件清单（app.py、Dockerfile、requirements.txt、README.md等）及各文件职责，确认无误再执行生成。
通过CLI命令驱动结构化初始化
方法一：使用codebuddy init命令指定模板
打开终端，进入空目录，执行：codebuddy init --template fastapi-docker --name weather-api。
该命令会拉取预置的FastAPI+Docker模板，自动创建项目骨架、填充基础路由、生成Dockerfile与docker-compose.yml，并写入健康检查端点。
方法二：用元数据文件引导生成
新建一个project.yaml，写入：
CodeBuddy Code CLI 的安装、配置与使用指南。CodeBuddy Code 是腾讯推出的 AI 驱动 CLI 编程助手，支持自然语言驱动开发。 - 必备触发词：CodeBuddy, codebuddy, AI CLI, Tencent AI coding, @tencent-ai/codebuddy-code, terminal AI assistant - 适用场景：安装 CodeBuddy CLI、配置 CodeBuddy、使用 CodeBuddy 命令、排查 CodeBuddy 问题
name: weather-api<br>runtime: python:3.11<br>framework: fastapi<br>entrypoint: app:app<br>ports: [8000]<br>dependencies: [httpx, pydantic]
保存后，在同一目录运行：codebuddy init -f project.yaml。
【注意】project.yaml必须放在空目录下，否则CLI会拒绝覆盖现有文件。
用已有文档反向推导可执行结构
如果你手头有一份PRD文档或技术方案Word/PDF，Craft能从中提取出可执行项目的轮廓。
第一步：将PRD文档拖入Craft编辑区，或点击“上传文件”按钮导入。
第二步：在指令栏输入@PRD.docx 请据此生成一个可本地运行的Vue前端项目，含登录页、仪表盘页、数据列表页，使用Vite构建，输出完整src目录结构。
第三步：Craft解析文档中的页面描述、交互逻辑、数据流向后，自动生成vite.config.ts、src/main.ts、src/router/index.ts等全部必需文件，并在package.json中注入dev脚本。
生成完成后，直接在终端运行npm install && npm run dev即可启动开发服务器。
