Skip to content

Commit 8dc5506

Browse files
author
HongjingLi
committed
docs: correct WorkBuddy team agent positioning
1 parent f482892 commit 8dc5506

8 files changed

Lines changed: 489 additions & 676 deletions

README.en.md

Lines changed: 25 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -2,23 +2,23 @@
22

33
# Humanize PPT
44

5-
## AST-based outline director for human-centered AI presentation workflows
5+
## AST-based outline director Skill for human-centered AI presentation workflows
66

7-
**Turn raw material into an audience-aware deck brief before rendering slides.**
7+
**Turn raw material into an audience-aware deck brief before handing it to compatible PPT / HTML PPT skills.**
88

99
[![GitHub Pages](https://img.shields.io/badge/GitHub%20Pages-Live-green?style=flat-square)](https://learnprompt.github.io/humanize-ppt/)
1010
[![Release](https://img.shields.io/github/v/release/LearnPrompt/humanize-ppt?style=flat-square)](https://github.com/LearnPrompt/humanize-ppt/releases)
1111
[![License](https://img.shields.io/badge/license-MIT-green.svg?style=flat-square)](LICENSE)
1212

13-
[Live Demo](https://learnprompt.github.io/humanize-ppt/) · [中文](README.md) · [AST Theory](docs/AST-theory.md) · [OPC Workflow](docs/OPC-workflow.md) · [Agent Teams](docs/agent-teams.md)
13+
[Live Demo](https://learnprompt.github.io/humanize-ppt/) · [中文](README.md) · [AST Theory](docs/AST-theory.md) · [OPC Workflow](docs/OPC-workflow.md) · [WorkBuddy Team Agent](docs/workbuddy-team-agent.md)
1414

1515
</div>
1616

1717
---
1818

1919
## What is this?
2020

21-
Humanize PPT is an **outline director** for presentation workflows. It is not another slide template and not a normal text humanizer.
21+
Humanize PPT is an **outline director Skill** for presentation workflows. It is not another slide template, not a normal text humanizer, and not an Agent hard-wired to four downstream skills.
2222

2323
It uses AST theory to turn raw material into a structured production brief:
2424

@@ -29,7 +29,7 @@ It uses AST theory to turn raw material into a structured production brief:
2929
- how each slide moves the audience forward;
3030
- which downstream renderer or adapter should finish the job.
3131

32-
The clean brief can then be passed to downstream tools such as guizang, Zara-style HTML deck exploration, HyperFrames, presenter shells, or deployment adapters.
32+
The clean brief can then be passed to compatible downstream tools. Guizang, Zara / frontend-slides, HyperFrames, and presenter-mode skills are recommended examples, not hard dependencies.
3333

3434
## Core idea
3535

@@ -39,15 +39,30 @@ When AI generates slides directly from raw material, the problem is often not vi
3939

4040
Humanize PPT cleans and reorganizes the material into a presentation path before slide rendering starts.
4141

42+
## WorkBuddy Team Agent packaging
43+
44+
In this repository, Humanize PPT remains a Skill. For Tencent WorkBuddy, the right package shape is a Team Agent that includes this Skill and wraps it with role-specific agents:
45+
46+
```text
47+
WorkBuddy Team Agent
48+
├── Lead Agent: creates the team, dispatches members, and assembles delivery
49+
├── Outline Director Agent: loads the humanize-ppt Skill and produces AST contracts
50+
├── Renderer Agent: loads a selected or recommended PPT / HTML PPT Skill
51+
├── Presenter Agent: adds presenter mode and speaker notes after the deck is finalized
52+
└── QA Agent: verifies narrative, human feel, assets, paths, and delivery readiness
53+
```
54+
55+
See: [WorkBuddy Team Agent packaging](docs/workbuddy-team-agent.md)
56+
4257
## V0.1 public preview
4358

4459
V0.1 validates a minimal loop:
4560

4661
```text
4762
Raw material
48-
→ Humanize PPT / AST Outline Director
49-
Style exploration HTML deck
50-
Shell-style Presenter Adapter
63+
→ Humanize PPT / AST Outline Director Skill
64+
Compatible PPT / HTML PPT skill for style exploration and rendering
65+
→ Presenter Adapter or presenter-mode skill
5166
→ Static deploy package
5267
```
5368

@@ -56,6 +71,7 @@ It includes:
5671
- `SKILL.md` — agent skill entrypoint;
5772
- `docs/AST-theory.md` — AST theory;
5873
- `docs/OPC-workflow.md` — Outline / Produce / Complete workflow;
74+
- `docs/workbuddy-team-agent.md` — Tencent WorkBuddy Team Agent packaging plan;
5975
- `contracts/` — output contract templates;
6076
- `scripts/humanize_ppt_v1.py` — deterministic local demo runner;
6177
- `examples/` — safe sample inputs.
@@ -90,7 +106,7 @@ python3 scripts/humanize_ppt_v1.py --source examples/02-hermes-install-guide/s
90106

91107
- Not a generic PPT generator.
92108
- Not a fixed bundle of several HTML PPT skills.
93-
- Not a normal text humanizer.
109+
- Not a WorkBuddy Agent by itself; the Team Agent is a packaging layer around this Skill.
94110
- Not a guizang/Zara template converter.
95111

96112
## License

README.md

Lines changed: 26 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -4,21 +4,21 @@
44

55
## 基于 AST 理论的人感 PPT 大纲导演 Skill
66

7-
**先把资料变成人愿意听的大纲,再交给HTML PPT Skill做风格探索,生成页面,做演讲模式和部署上线**
7+
**先把资料变成人愿意听的大纲,再交给合适的PPT/HTML PPT Skill做风格探索、页面生成、演讲模式和部署上线**
88

99
[![GitHub Pages](https://img.shields.io/badge/GitHub%20Pages-Live-green?style=flat-square)](https://learnprompt.github.io/humanize-ppt/)
1010
[![Release](https://img.shields.io/github/v/release/LearnPrompt/humanize-ppt?style=flat-square)](https://github.com/LearnPrompt/humanize-ppt/releases)
1111
[![License](https://img.shields.io/badge/license-MIT-green.svg?style=flat-square)](LICENSE)
1212

13-
[在线 Demo](https://learnprompt.github.io/humanize-ppt/) · [English](README.en.md) · [AST 理论](docs/AST-theory.md) · [OPC 工作流](docs/OPC-workflow.md) · [Agent Teams](docs/agent-teams.md)
13+
[在线 Demo](https://learnprompt.github.io/humanize-ppt/) · [English](README.en.md) · [AST 理论](docs/AST-theory.md) · [OPC 工作流](docs/OPC-workflow.md) · [WorkBuddy Team Agent](docs/workbuddy-team-agent.md)
1414

1515
</div>
1616

1717
---
1818

1919
## 这是什么
2020

21-
Humanize PPT 是一个 **PPT 大纲导演**,不是又一个HTML PPT模板库,也不是普通的文本润色工具。
21+
Humanize PPT 是一个 **PPT 大纲导演 Skill**,不是又一个HTML PPT模板库,也不是普通的文本润色工具,更不是固定绑定4个下游Skill的Agent
2222

2323
用 AST 理论把原始资料拆成:
2424

@@ -28,7 +28,7 @@ Humanize PPT 是一个 **PPT 大纲导演**,不是又一个HTML PPT模板库
2828
- 中间最大的认知张力是什么;
2929
- 每一页如何推动状态转移;
3030

31-
然后再把这份干净的生产说明书交给下游Skill生成HTML PPT和视频,比如op7418/guizang-ppt-skill、zarazhangrui/frontend-slides、heygen-com/hyperframes和lewislulu/html-ppt-skill
31+
然后再把这份干净的生产说明书交给合适的下游Skill生成HTML PPT、视频、演讲模式或部署包。我们会推荐op7418/guizang-ppt-skill、zarazhangrui/frontend-slides、heygen-com/hyperframes、lewislulu/html-ppt-skill这类HTML PPT相关Skill,但Humanize PPT本身不局限于这几个Skill。
3232

3333
## 核心判断
3434

@@ -38,23 +38,41 @@ AI 直接生成 PPT 时,容易出问题的地方已经不是页面不够漂亮
3838

3939
Humanize PPT 的作用是先把资料“洗干净”,重组成一条适合讲解、适合演示、适合下游生成的观众路径。
4040

41+
## WorkBuddy Team Agent 打包方向
42+
43+
Humanize PPT 在本仓库里仍然是Skill。面向腾讯 WorkBuddy 时,正确形态是:
44+
45+
```text
46+
WorkBuddy Team Agent 专家团
47+
├── 主理人 Agent:接收任务、建队、调度成员、汇总交付
48+
├── 大纲导演 Agent:加载 humanize-ppt Skill,产出 AST 大纲和生产契约
49+
├── 页面生成 Agent:加载用户选择或团队推荐的 PPT/HTML PPT Skill
50+
├── 演讲增强 Agent:在定稿后补 presenter mode / speaker notes
51+
└── QA Agent:检查内容、人感、路径、素材和交付可用性
52+
```
53+
54+
也就是说:**把能力做成WorkBuddy里的Team Agent,但Humanize PPT本身还是一个可复用Skill。**
55+
56+
详见:[WorkBuddy Team Agent 打包方案](docs/workbuddy-team-agent.md)
57+
4158
## V0.1 能做什么
4259

4360
V0.1 先验证一个最小闭环:
4461

4562
```text
4663
原始资料
47-
→ 生成大纲:Humanize PPT / AST Outline Director
48-
→ 风格探索:frontend-slides和guizang-ppt-skill
49-
→ 演讲模式:lewislulu/html-ppt-skill
50-
→ 静态上线:frontend-slides
64+
→ 生成大纲:Humanize PPT / AST Outline Director Skill
65+
→ 风格探索:frontend-slides和guizang-ppt-skill等下游Skill
66+
→ 演讲模式:lewislulu/html-ppt-skill或Presenter Adapter
67+
→ 静态上线:frontend-slides或其他部署适配器
5168
```
5269

5370
当前包含:
5471

5572
- `SKILL.md`:Agent Skill 入口;
5673
- `docs/AST-theory.md`:AST 理论;
5774
- `docs/OPC-workflow.md`:Outline / Produce / Complete 工作流;
75+
- `docs/workbuddy-team-agent.md`:腾讯 WorkBuddy Team Agent 打包方案;
5876
- `contracts/`:输出契约模板;
5977
- `scripts/humanize_ppt_v1.py`:本地最小 Demo Runner;
6078
- `examples/`:脱敏测试素材。

SKILL.md

Lines changed: 15 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -14,17 +14,17 @@ Use this skill when a user wants to turn raw material, notes, voice transcripts,
1414

1515
## Positioning
1616

17-
Humanize PPT is an **Outline Director** and **Agent Teams Orchestrator**, not a slide renderer.
17+
Humanize PPT is an **Outline Director Skill**, not a slide renderer, not a fixed bundle of HTML PPT skills, and not itself a WorkBuddy Agent.
1818

19-
It should run before downstream PPT / HTML slide skills. Its job is to produce a clean AST-based production brief so renderers do not ingest raw noisy material directly.
19+
Its job is to run before downstream PPT / HTML slide skills and produce a clean AST-based production brief, so renderers do not ingest raw noisy material directly.
2020

21-
In Agent Teams mode, the main Humanize PPT Agent loads this skill and controls specialist agents:
21+
In a Tencent WorkBuddy **Team Agent** package, this skill should be installed under `skills/humanize-ppt/` and loaded by one or more agents. The agents can then call or hand off to different downstream skills according to the user's goal. The recommended HTML PPT skills below are examples, not hard dependencies:
2222

23-
- Guizang Agent for Chinese stable rendering.
24-
- Zara Agent for style exploration, HTML production, and deploy.
25-
- HyperFrames Agent for video slots.
26-
- Presenter Agent for presenter mode after the deck is finalized.
27-
- QA Agent for content, visual, path, and delivery checks.
23+
- Guizang path for stable Chinese HTML PPT rendering.
24+
- Zara / frontend-slides path for style exploration, HTML production, and deploy.
25+
- HyperFrames path for video slots and motion assets.
26+
- Presenter / html-ppt path for presenter mode after the deck is finalized.
27+
- QA path for content, visual, path, and delivery checks.
2828

2929
## AST theory
3030

@@ -53,11 +53,11 @@ For every Humanize PPT run, produce:
5353

5454
```text
5555
O — Outline Director
56-
Humanize PPT: raw material → AST outline + production brief
56+
Humanize PPT Skill: raw material → AST outline + production brief
5757
5858
P — Presentation Production
59-
guizang path: Chinese stable HTML PPT
60-
Zara path: style exploration and HTML production
59+
Any compatible PPT / HTML PPT skill
60+
Recommended paths: guizang, Zara / frontend-slides, other renderer skills
6161
6262
C — Complete / Control
6363
HyperFrames video adapter
@@ -72,15 +72,14 @@ C — Complete / Control
7272
2. Keep presenter mode as a post-processing adapter, not a style.
7373
3. Separate deployment from presenter mode.
7474
4. Absorb AI-writing cleanup principles from humanizer tools, but do not reduce Humanize PPT to text polishing.
75-
5. Prefer a small verified workflow over a broad unverified promise.
75+
5. Treat downstream PPT skills as pluggable renderers: recommend good defaults, but do not hard-code the workflow to four fixed skills.
76+
6. In WorkBuddy packaging, keep Humanize PPT as a Skill and put orchestration in the Team Agent's lead/member agent prompts.
77+
7. Prefer a small verified workflow over a broad unverified promise.
7678

7779
## Local demo
7880

7981
If this repository is installed locally, run:
8082

8183
```bash
82-
python3 scripts/humanize_ppt_v1.py \
83-
--source examples/01-ai-tool-update/source.md \
84-
--out .humanize-ppt-runs/ai-tool-update \
85-
--title "AI 工具更新,不只是功能清单"
84+
python3 scripts/humanize_ppt_v1.py --source examples/01-ai-tool-update/source.md --out .humanize-ppt-runs/ai-tool-update --title "AI 工具更新,不只是功能清单"
8685
```

0 commit comments

Comments
 (0)