本skill帮助你从对话上下文中提取项目规划信息,生成结构化的项目文档。适用于项目规划完成后,需要整理成正式文档的场景。
当用户表达以下意图时使用本skill:
# 安装文档生成依赖
pip install python-docx python-pptx openpyxl
# 安装图表生成依赖(可选)
pip install matplotlib graphviz
# 语音识别(多模态输入)
pip install openai-whisper
# 图片OCR(多模态输入)
pip install pytesseract
# PDF解析(多模态输入)
pip install PyPDF2
询问用户需要分析的对话范围:
请确认需要分析的对话范围:
1. 当前会话的全部对话历史
2. 最近的对话(请指定消息数量或时间段)
3. 特定主题的对话(请描述关键词)
使用 sessions_history 工具获取对话记录:
# 示例:获取当前会话历史
sessions_history(sessionKey="current", limit=100)
如果需要分析其他会话,先使用 sessions_list 查找会话。
如果对话包含多媒体内容,进行预处理:
从对话中提取以下信息:
根据讨论内容推断合理的目录结构:
project-root/
├── src/
│ ├── main/
│ │ ├── java/
│ │ ├── resources/
│ │ └── webapp/
│ └── test/
├── pom.xml
└── README.md
生成标准格式的Markdown文档:
# {项目名称}
## 项目概述
{项目描述}
## 技术架构
### 技术栈
- 后端:{后端技术}
- 前端:{前端技术}
- 数据库:{数据库}
- 中间件:{中间件}
### 架构设计
{架构图或描述}
## 功能模块
### 模块1:{模块名称}
- 功能描述:{描述}
- 主要接口:{接口列表}
### 模块2:{模块名称}
- 功能描述:{描述}
- 主要接口:{接口列表}
## 数据库设计
### 表结构
{表结构描述}
## API设计
### 接口列表
{接口列表}
## 部署说明
{部署要求}
## 项目目录
{目录结构}
方案A:使用python-docx(推荐)
如果环境中已安装 python-docx:
from docx import Document
from docx.shared import Inches, Pt
from docx.enum.text import WD_ALIGN_PARAGRAPH
doc = Document()
doc.add_heading('项目文档', 0)
doc.add_paragraph('项目概述')
# ... 添加更多内容
doc.save('project_document.docx')
方案B:Markdown转Word
如果安装了pandoc:
pandoc project.md -o project.docx
方案C:生成HTML
生成HTML文件,用户可以用Word打开并另存为docx格式。
使用python-pptx(需安装)
pip install python-pptx
生成项目汇报PPT:
使用openpyxl(需安装)
pip install openpyxl
生成结构化数据表:
使用Mermaid语法
自动生成图表代码,支持:
graph TD 或 graph LRflowchart TDsequenceDiagramerDiagramganttclassDiagram示例:系统架构图
graph TD
A[用户] --> B[前端 Vue]
B --> C[API网关]
C --> D[用户服务]
C --> E[订单服务]
C --> F[支付服务]
D --> G[(用户数据库)]
E --> H[(订单数据库)]
F --> I[(支付数据库)]
生成单页HTML文档:
将生成的文档保存到工作目录:
# 保存Markdown文件
write(path="project_snapshot.md", content=markdown_content)
# 保存Word文件(如果可行)
write(path="project_snapshot.docx", content=word_content)
分析对话内容,提取项目信息。需要LLM能力,由agent直接处理。
使用python-docx生成Word文档。需要安装python-docx:
pip install python-docx
使用python-pptx生成PPT演示文稿。需要安装python-pptx:
pip install python-pptx
使用openpyxl生成Excel数据表。需要安装openpyxl:
pip install openpyxl
生成Mermaid图表代码,支持架构图、流程图等。
生成交互式HTML文档,支持响应式设计和动态内容。
项目风险评估,识别技术、架构、安全风险。
项目成本估算,包括开发、运维、第三方成本。
项目时间线生成,基于功能复杂度估算开发周期。
references/template.md - Markdown模板references/template.docx - Word模板(如果可用)用户:我们规划一个SpringBoot + Vue的后台管理系统,包含用户管理、角色管理、菜单管理...
助手:[分析对话,生成项目文档]
# 后台管理系统
## 项目概述
基于SpringBoot + Vue的后台管理系统,实现用户、角色、菜单的权限管理。
## 技术架构
- 后端:SpringBoot 2.7 + MyBatis-Plus
- 前端:Vue 3 + Element Plus
- 数据库:MySQL 8.0
- 缓存:Redis
## 功能模块
### 用户管理
- 用户CRUD
- 密码加密
- 状态管理
### 角色管理
- 角色CRUD
- 权限分配
### 菜单管理
- 菜单CRUD
- 动态路由
pip install python-docxpandoc --version共 3 个版本