PPTAgent 协作助手

v1.0.0

Use when working in the PPTAgent or BotSlide repository to add features, fix bugs, or adjust slide generation, editing, export, prompt rules, project version...

0· 173·1 current·1 all-time
byTonye@mrguanglei

Install

OpenClaw Prompt Flow

Install with OpenClaw

Best for remote or guided setup. Copy the exact prompt, then paste it into OpenClaw for mrguanglei/ppt-collab.

Previewing Install & Setup.
Prompt PreviewInstall & Setup
Install the skill "PPTAgent 协作助手" (mrguanglei/ppt-collab) from ClawHub.
Skill page: https://clawhub.ai/mrguanglei/ppt-collab
Keep the work scoped to this skill only.
After install, inspect the skill metadata and help me finish setup.
Use only the metadata you can verify from ClawHub; do not invent missing requirements.
Ask before making any broader environment changes.

Command Line

CLI Commands

Use the direct CLI path if you want to install manually and keep every step visible.

OpenClaw CLI

Bare skill slug

openclaw skills install ppt-collab

ClawHub CLI

Package manager switcher

npx clawhub@latest install ppt-collab
Security Scan
VirusTotalVirusTotal
Benign
View report →
OpenClawOpenClaw
Benign
high confidence
Purpose & Capability
Name/description target the PPTAgent/BotSlide codebase and the SKILL.md only references repository files, validation commands, and project-specific rules relevant to slide generation, preview, export, and versioning. There are no unrelated credential or platform requirements.
Instruction Scope
Instructions direct the agent to read specific repo paths and docs, follow a debugging/validation checklist, and run repo-local verification commands (docker-compose, pnpm, pip, playwright, python smoke tests). These are reasonable for codebase collaboration, but they do imply executing build/test steps and starting services which may run arbitrary code from the repository or pull packages from registries.
Install Mechanism
No install spec is declared (instruction-only), which minimizes persistent risk. However the included reference docs recommend commands that will fetch/install packages (pnpm, pip, playwright, docker images). Those network installs are expected for repo work but are not managed by the skill metadata.
Credentials
The skill declares no required env vars, no credentials, and the instructions do not request secrets or unrelated system configuration. Access to repo files and running local verification commands is proportionate to the stated purpose.
Persistence & Privilege
Skill is instruction-only, has no install step, and always:false. It does not request persistent presence or elevated agent-wide privileges.
Assessment
This skill appears coherent for collaborating on the PPTAgent/BotSlide repository: it points to repo files and suggests reasonable validation steps. Before running recommended commands, review the repository code and CI/test scripts so you know what will execute; run build/tests in an isolated environment (CI, container, or developer machine) because pnpm/pip/playwright/docker commands will download and run third-party packages. Confirm the repo contains no secrets or unexpected scripts (startup hooks, postinstall scripts) you don't want executed. If you only want read-only analysis, avoid running the install/start commands and ask for static guidance instead.

Like a lobster shell, security has layers — review code before you run it.

latestvk97034vyyzn2gzjaj6zy0ffhxs833675
173downloads
0stars
1versions
Updated 1mo ago
v1.0.0
MIT-0

PPTAgent 协作 Skill

这个 skill 用于在 PPTAgent / BotSlide 仓库里做项目内协作,而不是泛化地“写 PPT”。

适用场景

  • 修改 PPT 生成规则、页面布局、提示词或视觉约束
  • 排查 HTML 预览和 PPTX 导出不一致
  • 调整会话生成、PPT 项目版本、单页编辑或导出链路
  • 修改前端预览、下载、分享、版本切换相关功能

触发关键词

当请求里出现下面这些方向时,应优先使用这个 skill:

  • PPTAgentBotSlide
  • 幻灯片溢出、1280x720、固定画布、页高、版式锁定
  • deeppresenterslide_design_prompt
  • html -> pptx、导出保真、样式丢失、字体丢失、分享页错位
  • 单页编辑、版本快照、当前版本、项目列表、导出接口
  • PPT 预览、下载、分享、右侧预览面板、会话生成

先判断任务落点

真相源优先级

当文档和代码不一致时,按下面优先级判断:

  1. 运行时代码和当前 prompt
    • backend/deeppresenter/prompts/slide_design_prompt.py
    • backend/services/chat_handler.py
    • backend/services/ppt_generator.py
    • backend/routers/ppt.py
    • backend/routers/export.py
    • export_tool/app/services/pptx_service.py
  2. 当前产品文档
    • README_zh.md
    • README.md
    • export_tool/README.md
  3. 历史/说明性文档
    • 系统提示词.md
    • 详细情况.md
    • API.md

历史文档只作补充背景,不要在和代码冲突时把它们当成实现依据。

工作方式

  1. 先定位用户要改的是哪一层:生成、编辑、预览、导出、版本管理,还是 UI 展示。
  2. 不要只改第一个看见的文件;先顺着入口文件往调用链上下各看一层。
  3. 只加载当前任务需要的 reference,保持上下文精简。
  4. 如果任务涉及 slide HTML,默认保留固定画布思维,不要把页面当普通响应式网页处理。
  5. 如果任务涉及导出保真,必须同时检查“生成的 HTML 假设”和“export_tool / dom-to-pptx 约束”。
  6. 如果任务涉及版本或编辑行为,至少同时检查 router、service/chat_handler、crud 或 model 的对应路径。

常见任务速查

  • 用户说“某页内容溢出、页面太长、生成页高度不对”: 先看 backend/deeppresenter/prompts/slide_design_prompt.py,再看 references/slide-rules.md
  • 用户说“预览正常,但导出 PPTX 样式错了”: 先看 backend/routers/export.pyexport_tool/app/services/pptx_service.py,再看 references/validation.md
  • 用户说“编辑某一页后版本不对、原始版本丢了”: 先看 backend/routers/ppt.pybackend/database/crud.pybackend/services/chat_handler.py
  • 用户说“首页/右侧预览/下载按钮行为有问题”: 先看 frontend/client/src/pages/Home.tsxfrontend/client/src/pages/PPTPlayer.tsxfrontend/client/src/hooks/useConversationManager.ts
  • 用户说“想改生成策略但文档互相打架”: 先按“真相源优先级”回到运行时代码,不要先信历史文档

核心协作约束

  • 这个项目的关键不是“生成漂亮 HTML”,而是“生成能被预览、编辑、分享、导出的稳定幻灯片 HTML”。
  • 任何会影响页面结构的改动,都要优先保护 1280x720 画布约束和导出稳定性。
  • 如果内容放不下,优先拆页、精简、改布局,不要通过把整页变高来解决。
  • 当前代码里存在“旧规范文档”和“当前 prompt 实现”并存的情况;优先跟随当前代码。

输出要求

  • 说明你改的是哪一层,以及为什么放在这一层改。
  • 给出最小必要验证,而不是泛泛说“建议测试一下”。
  • 如果没法完整验证,明确说明缺口,例如依赖未安装、外部服务未启动、只做了静态检查等。

Comments

Loading comments...