北京智捷通云科技有限公司 | CodeBuddy平台专用技能研究与开发

本仓库是北京智捷通云科技有限公司的办公文档处理技能包专用仓库，致力于集中处理所有用于人类演示的可视化文档。项目基于CodeBuddy平台进行相关技能研究和技能包开发，提供统一的文档处理解决方案。

重要更新: 所有技能包已成功迁移为 CodeBuddy 标准技能格式！

• ✅ 6 个核心技能已迁移
• ✅ 符合 CodeBuddy 官方规范
• ✅ AI 自动识别并调用
• 📍 新技能位置: .codebuddy/skills/
• 📄 查看迁移说明

• 演示文稿: PPTX, PPT
• 文档处理: DOCX, DOC, Markdown, TXT
• 电子表格: Excel, CSV
• 便携文档: PDF
• 图像格式: SVG, PNG, JPG, WebP
• 网页文档: HTML, 网站维护
• 图表设计: 架构图、流程图、画布设计

• 基于项目: @K-Dense-AI/claude-scientific-skills/markitdown
• 功能: Markdown格式转换、语法高亮、结构化处理

• 基于项目:
  • @anthropics/skills/pdf
  • @davila7/claude-code-templates/pdf-processing
  • @daymade/claude-code-skills/pdf-creator
• 功能: PDF解析、转换、创建、内容提取

• 基于项目:
  • @anthropics/skills/canvas-design
  • @MiniMax-AI/Mini-Agent/canvas-design
• 功能: 可视化画布设计、图形绘制、UI原型

• 基于项目: @metabase/metabase/docs-write
• 功能: 技术文档撰写、模板生成、格式化

• 基于项目:
  • @Fergana-Labs/claude_agent_desktop/word
  • @K-Dense-AI/claude-scientific-skills/docx
• 功能: Word文档创建、编辑、格式化

• 基于项目: @carlvellotti/claude-code-pm-course/pptx
• 功能: 演示文稿生成、模板应用、动画效果

• 基于项目: @mhattingpete/claude-skills-marketplace/architecture-diagram-creator
• 功能: 系统架构图、流程图、网络拓扑图

• 基于项目: @mhattingpete/claude-skills-marketplace/technical-doc-creator
• 功能: API文档、技术规范、用户手册

• 基于项目: @benbrastmckie/.config/document-converter
• 功能: 跨格式转换、批量处理

• 基于项目: @sopaco/deepwiki-rs/smart-docs
• 功能: 智能文档生成、语义理解、自动化处理

• 基于项目: @yamadashy/repomix/website-maintainer
• 功能: 网站内容管理、文档更新、版本控制

办公文档处理技能包
├── CodeBuddy 技能层 (新)
│   ├── .codebuddy/skills/pdf/
│   ├── .codebuddy/skills/pptx/
│   ├── .codebuddy/skills/docx/
│   ├── .codebuddy/skills/markdown/
│   ├── .codebuddy/skills/canvas/
│   └── .codebuddy/skills/converter/
├── 核心引擎层
│   ├── Markdown处理器
│   ├── PDF引擎
│   └── 画布渲染器
├── 格式转换层
│   ├── 文档转换器
│   ├── 图像处理器
│   └── 格式适配器
├── 智能处理层
│   ├── 文档理解
│   ├── 内容生成
│   └── 智能优化
└── 应用接口层
    ├── API接口
    ├── CLI工具
    └── Web界面

所有技能已迁移为 CodeBuddy 标准格式，AI 会根据任务自动选择合适的技能：

• PDF 处理: 提取文本、合并拆分、表格解析
• PPTX 创建: 制作演示文稿、多种幻灯片类型
• Word 文档: 创建编辑文档、插入表格图片
• Markdown 处理: 格式转换、内容提取、目录生成
• 可视化画布: 绘制图形、流程图、图表
• 文档转换: 跨格式转换、批量处理

使用 /skills 命令查看已加载的技能。

原有的 Python API 仍然可用：

# PDF 处理
from skills.pdf.processor import PDFProcessor
processor = PDFProcessor()
text = processor.extract_text('document.pdf')

# PPTX 创建
from skills.pptx.creator import PPTXCreator
creator = PPTXCreator()
deck = creator.create_deck()

# 文档转换
from skills.converter.document_converter import DocumentConverter
converter = DocumentConverter()
converter.convert('input.docx', 'output.pdf')

• Python 3.8+
• Node.js 16+
• CodeBuddy 平台支持
• 依赖包详见各模块说明

本仓库可在 cnb.cool 的在线 code-server 环境中使用。为获得最佳的文档预览体验，建议安装以下 VS Code 插件：

插件名称	插件ID	功能说明	支持格式
Markdown Preview Enhanced	shd101wyy.markdown-preview-enhanced	强大的Markdown预览，支持导出、公式、图表	.md, .markdown
Markdown All in One	yzhang.markdown-all-in-one	Markdown编写辅助，快捷键、自动补全	.md, .markdown
PDF Viewer	tomoki1207.pdf	PDF文档预览	.pdf
Draw.io Integration	hediet.vscode-drawio	流程图、架构图绘制与预览	.drawio, .svg
PlantUML	jebbs.plantuml	PlantUML图表预览	.puml, .plantuml
Excel Viewer	GrapeCity.gc-excelviewer	Excel/CSV表格预览	.xlsx, .xls, .csv
Word Preview (Office Viewer)	cweijan.vscode-office	Word文档预览	.docx, .doc
PPTX Preview (Office Viewer)	cweijan.vscode-office	PowerPoint演示文稿预览	.pptx, .ppt

插件名称	插件ID	功能说明	支持格式
Image Preview	k--kato.intellij-idea-keybindings	图像文件预览	.png, .jpg, .jpeg, .gif, .svg, .webp
SVG Viewer	cssho.vscode-svgviewer	SVG矢量图预览与编辑	.svg
REST Client	humao.rest-client	API测试，可预览返回的JSON/XML	JSON, XML
XML Tools	DotJoshJohnson.xml	XML文档格式化与预览	.xml
Open in Browser	techer.open-in-browser	在浏览器中打开HTML/Markdown	.html, .md
Code Runner	formulahendry.code-runner	快速运行代码并查看结果	.py, .js 等
Python	ms-python.python	Python开发支持	.py
Pylance	ms-python.pylance	Python智能提示	.py
Jupyter	ms-toolsai.jupyter	Jupyter Notebook支持	.ipynb

1. 打开 code-server，按 Ctrl+Shift+X（Mac: Cmd+Shift+X）打开扩展面板
2. 在搜索框中输入上述插件ID或名称
3. 点击"Install"安装

# 安装核心插件
code-server --install-extension shd101wyy.markdown-preview-enhanced
code-server --install-extension yzhang.markdown-all-in-one
code-server --install-extension tomoki1207.pdf
code-server --install-extension hediet.vscode-drawio
code-server --install-extension jebbs.plantuml
code-server --install-extension GrapeCity.gc-excelviewer
code-server --install-extension cweijan.vscode-office

# 安装推荐插件
code-server --install-extension cssho.vscode-svgviewer
code-server --install-extension humao.rest-client
code-server --install-extension ms-python.python
code-server --install-extension ms-python.pylance

创建 .vscode/extensions.json 文件：

{
  "recommendations": [
    "shd101wyy.markdown-preview-enhanced",
    "yzhang.markdown-all-in-one",
    "tomoki1207.pdf",
    "hediet.vscode-drawio",
    "jebbs.plantuml",
    "GrapeCity.gc-excelviewer",
    "cweijan.vscode-office",
    "cssho.vscode-svgviewer",
    "ms-python.python",
    "ms-python.pylance"
  ]
}

• 打开 .md 文件后，右键选择 "Markdown Preview Enhanced: Open Preview"
• 支持快捷键 Ctrl+K V（Mac: Cmd+K V）
• 支持导出为 PDF、HTML、PNG 等格式

• 直接双击 .pdf 文件即可预览
• 支持缩放、搜索、页面导航

• Word (.docx) 和 PPTX (.pptx) 可通过 "Office Viewer" 插件预览
• 部分复杂格式可能不完全支持，建议使用专业软件编辑

• Drawio: 右键 .drawio 文件选择 "Open Diagram to Preview"
• PlantUML: 右键 .puml 文件选择 "Preview Current Diagram"

• 直接打开图像文件即可预览
• SVG 文件支持编辑功能

创建 .vscode/settings.json 优化开发体验：

{
  "markdown.preview.breaks": true,
  "markdown.preview.fontFamily": "-apple-system, BlinkMacSystemFont, 'Segoe WPC', 'Segoe UI', sans-serif",
  "pdf-viewer.zoom": "100",
  "files.associations": {
    "*.md": "markdown",
    "*.drawio": "xml"
  },
  "editor.formatOnSave": true,
  "python.formatting.provider": "black"
}

Q: Office 文档无法预览怎么办？ A: Office Viewer 插件对复杂格式支持有限，建议转换格式或使用专业软件。

Q: PDF 预览乱码？ A: 检查 PDF 字体是否为标准字体，尝试使用 PDF Viewer 插件替代。

Q: Markdown 图表不显示？ A: 确保安装了 Markdown Preview Enhanced 插件，并启用了相关扩展。

Q: Drawio 文件打不开？ A: 安装 Draw.io Integration 插件，并重启 code-server。

Q: CodeBuddy 技能未触发？ A: 检查技能描述是否清晰，确认任务与技能功能匹配。

直接在 CodeBuddy 中提出需求，AI 会自动选择合适的技能：

• "帮我提取这个 PDF 的内容"
• "创建一个演示文稿"
• "将 Word 转换为 Markdown"
• "生成一个柱状图"

使用 /skills 命令查看所有可用技能。

# 克隆仓库
git clone https://github.com/zhijietong-office-document-skills/repository.git

# 安装依赖
pip install -r requirements.txt
npm install

# 初始化配置
python setup.py init

# 运行技能包
python main.py --help

提取 PDF 内容:

用户: 帮我提取 document.pdf 的文本内容
AI: [自动调用 PDF 技能]
    [返回提取结果]

创建演示文稿:

用户: 创建一个包含3页的演示文稿
AI: [自动调用 PPTX 技能]
    [创建并保存 PPTX 文件]

文档格式转换:

用户: 将 report.docx 转换为 Markdown
AI: [自动调用文档转换技能]
    [执行转换并返回结果]

PDF 处理:

from skills.pdf.processor import PDFProcessor

processor = PDFProcessor()
result = processor.extract_text('document.pdf')

PPTX 生成:

from skills.pptx.creator import PPTXCreator

creator = PPTXCreator()
deck = creator.create_deck('template.pptx')
creator.save(deck, 'output.pptx')

文档转换:

from skills.converter.document_converter import DocumentConverter

converter = DocumentConverter()
converter.convert('input.docx', 'output.pdf')

技能名称	目录	主要功能	工具权限
PDF 处理	pdf/	PDF提取、合并、拆分、表格解析	Read, Write, Bash, WebFetch
PPTX 创建	pptx/	演示文稿创建、多种幻灯片	Read, Write, Bash
Word 文档	docx/	Word创建、编辑、内容提取	Read, Write, Bash
Markdown 处理	markdown/	格式转换、文件转换、内容提取	Read, Write, Bash, WebFetch
可视化画布	canvas/	图形绘制、流程图、图表	Read, Write, Bash
文档转换	converter/	跨格式转换、批量处理	Read, Write, Bash

详情请查看 技能包 README

技能名称	来源项目	主要功能
MarkItDown	K-Dense-AI/claude-scientific-skills	Markdown处理
PDF Skill	anthropics/skills	PDF解析与处理
Canvas Design	anthropics/skills	画布设计
Docs Write	metabase/metabase	文档编写
PDF Templates	davila7/claude-code-templates	PDF处理模板
Technical Doc Creator	mhattingpete/claude-skills-marketplace	技术文档
Document Converter	benbrastmckie/.config	文档转换
Architecture Diagram	mhattingpete/claude-skills-marketplace	架构图
PPTX Processing	carlvellotti/claude-code-pm-course	演示文稿
Word Processing	Fergana-Labs/claude_agent_desktop	Word处理
DOCX Processing	K-Dense-AI/claude-scientific-skills	DOCX处理
Website Maintainer	yamadashy/repomix	网站维护
Smart Docs	sopaco/deepwiki-rs	智能文档
PDF Creator	daymade/claude-code-skills	PDF创建

/workspace/
├── .codebuddy/            # CodeBuddy 配置
│   └── skills/           # CodeBuddy 标准技能
│       ├── pdf/         # PDF 处理技能
│       ├── pptx/        # PPTX 创建技能
│       ├── docx/        # Word 文档技能
│       ├── markdown/    # Markdown 处理技能
│       ├── canvas/      # 可视化画布技能
│       ├── converter/   # 文档转换技能
│       └── README.md    # 技能包说明
├── skills/                 # 技能模块（Python 实现）
│   ├── pdf/               # PDF处理
│   ├── pptx/              # PPTX处理
│   ├── docx/              # Word处理
│   ├── markdown/          # Markdown处理
│   ├── canvas/            # 画布设计
│   └── converter/         # 格式转换
├── templates/             # 模板文件
├── tests/                 # 测试用例
├── docs/                  # 文档
├── examples/              # 使用示例
├── MIGRATION.md          # 迁移说明文档
├── main.py               # CLI 入口
├── setup.py              # 安装配置
└── README.md             # 本文件

1. 在skills/目录下创建新模块
2. 遵循现有技能的接口规范
3. 编写单元测试
4. 更新文档

• 遵循PEP 8规范
• 添加完整的类型注解
• 编写docstring文档
• 确保代码可测试性

# 运行所有测试
pytest

# 运行特定技能测试
pytest skills/pdf/test_pdf_processor.py

# 生成覆盖率报告
pytest --cov=skills --cov-report=html

我们欢迎所有形式的贡献！

1. 报告Bug和问题
2. 提出新功能建议
3. 提交代码改进
4. 完善文档
5. 分享使用案例

1. Fork本仓库
2. 创建特性分支 (git checkout -b feature/AmazingFeature)
3. 提交更改 (git commit -m 'Add some AmazingFeature')
4. 推送到分支 (git push origin feature/AmazingFeature)
5. 提交Pull Request

• 尊重所有贡献者
• 建设性反馈
• 遵循开源协议
• 保持专业态度

• v1.0.0 (2026-01-20)
  • 初始版本发布
  • 集成15个文档处理技能
  • 实现核心文档处理功能

本项目采用 MIT 许可证 - 详见 LICENSE 文件

• 公司: 北京智捷通云科技有限公司
• 项目主页: GitHub Repository
• 问题反馈: Issues

感谢以下开源项目的贡献：

• Anthropic Skills
• K-Dense-AI
• Metabase
• 以及所有贡献者和维护者

---

北京智捷通云科技有限公司 © 2026