mirror of
https://github.com/ningzimu/codex-ppt-skill.git
synced 2026-09-14 20:06:52 +08:00
feat: add party-government red and teaching styles
Summary: - add Party-and-Government Red and Teaching Courseware style references - add matching README previews - update bilingual style listings and changelog Verification: - changelog-check passed - pr-title passed - embedded style JSON validated - preview dimensions and README references verified
This commit is contained in:
ningzimu
@@ -4,6 +4,11 @@ Release notes are generated from this file. Keep changelog entries in English.
|
||||
|
||||
## Unreleased
|
||||
|
||||
### Features
|
||||
|
||||
- Add a reusable Party-and-Government Red style reference and preview for formal public-sector presentations. (#79)
|
||||
- Add a reusable Teaching Courseware style reference and preview for academic and technical learning presentations. (#79)
|
||||
|
||||
## 0.5.3
|
||||
|
||||
### Improvements
|
||||
|
||||
@@ -40,7 +40,7 @@
|
||||
- 稳定的阶段化流程：先确认大纲、页数、视觉风格、生图后端和样张，再进入整套生成，降低一次生成完整 PPT 时的返工和偏航。
|
||||
- 不是无脑生成：会先引导你确认 `outline.md`、每页要点、风格方向和样张效果，再按确认后的方案继续。
|
||||
- 低门槛输入：文章、报告、论文、课程笔记、Markdown、大纲、PDF、Word 等材料都可以作为起点。
|
||||
- 内置 10 种 PPT 风格参考：包括清爽专业、科研答辩、电子墨水杂志、手绘技术解释、仪表盘、麦肯锡等；不会写提示词也可以先从内置风格开始，尤其推荐手绘技术解释风。
|
||||
- 内置 12 种 PPT 风格参考：包括清爽专业、科研答辩、党政红、教学课件、电子墨水杂志、手绘技术解释、仪表盘、麦肯锡等；不会写提示词也可以先从内置风格开始，尤其推荐手绘技术解释风。
|
||||
- 支持自定义风格复刻：可以上传喜欢的图片、PDF 或 PPT/PPTX，让 agent 先分析配色、版式、字体和视觉元素，再按该风格生成新 PPT。
|
||||
- 可沉淀个人风格库：生成满意后，可以把当前风格保存到 skill 的 `references/` 目录，下次直接复用，让这个 skill 越用越贴合你的偏好。
|
||||
- 多 agent 并发生成：样张确认后，支持一个子 agent 负责一页，并对文字清晰度、风格一致性和内容完整性做自检，发现问题及时返修。
|
||||
@@ -72,6 +72,8 @@
|
||||
|  |  |
|
||||
| 科研答辩风 | 麦肯锡风格 |
|
||||
|  |  |
|
||||
| 党政红风格 | 教学课件风 |
|
||||
|  |  |
|
||||
|
||||
## 输出结构
|
||||
|
||||
|
||||
+3
-1
@@ -40,7 +40,7 @@ For a basic introduction to skill design and usage, see [good-skill-design.pptx]
|
||||
- Stable staged workflow: confirms the outline, slide count, visual style, image backend, and sample slide before full-deck generation, reducing drift and rework when generating a complete PPT.
|
||||
- Guided instead of one-shot: the skill asks you to confirm `outline.md`, per-slide key points, style direction, and sample-slide quality before continuing.
|
||||
- Low setup effort: articles, reports, papers, course notes, Markdown files, outlines, PDFs, and Word documents can all be used as starting material.
|
||||
- 10 built-in PPT style references: includes clean professional, scientific defense, e-ink magazine, hand-drawn technical explainer, dashboard, McKinsey style, and more. The hand-drawn technical explainer style is a strong starting point if you do not want to write prompts.
|
||||
- 12 built-in PPT style references: includes clean professional, scientific defense, Party-and-Government Red, Teaching Courseware, e-ink magazine, hand-drawn technical explainer, dashboard, McKinsey style, and more. The hand-drawn technical explainer style is a strong starting point if you do not want to write prompts.
|
||||
- Supports custom style replication: provide a favorite image, PDF, or PPT/PPTX, and the agent can analyze its color, layout, typography, and visual system before generating a new deck in that style.
|
||||
- Builds a reusable personal style library: once you like a deck style, ask the agent to save it into this skill's `references/` directory so future decks can reuse it directly.
|
||||
- Supports parallel subagent generation: after the sample slide is approved, one subagent can handle one slide and self-check readability, style consistency, and content completeness before reporting issues for repair.
|
||||
@@ -72,6 +72,8 @@ The following preview images were generated with `gpt-image-2` to help users cho
|
||||
|  |  |
|
||||
| Scientific Defense | McKinsey Style |
|
||||
|  |  |
|
||||
| Party-and-Government Red | Teaching Courseware |
|
||||
|  |  |
|
||||
|
||||
## Output Structure
|
||||
|
||||
|
||||
Binary file not shown.
|
After Width: | Height: | Size: 1.5 MiB |
Binary file not shown.
|
After Width: | Height: | Size: 1.4 MiB |
@@ -86,6 +86,8 @@ Available references:
|
||||
- `references/手绘白板风.md`
|
||||
- `references/温暖手工风.md`
|
||||
- `references/麦肯锡风格.md`
|
||||
- `references/党政红风格.md`
|
||||
- `references/教学课件风.md`
|
||||
|
||||
When adding a reusable style to the library, also add its `references/{style_name}.md` file to this list.
|
||||
|
||||
|
||||
@@ -0,0 +1,98 @@
|
||||
# 党政红风格
|
||||
|
||||
**适用场景:**
|
||||
- 党政机关工作汇报、专题学习与会议材料
|
||||
- 政策宣讲、党建活动、年度总结与重点工作部署
|
||||
- 国企、事业单位和公共服务机构的正式汇报
|
||||
|
||||
**GPT-Image-2 风格 Brief:**
|
||||
```json
|
||||
{
|
||||
"type": "16:9 full-slide PowerPoint image",
|
||||
"style_name": "党政红风格",
|
||||
"best_for": "党政机关、国企和事业单位的工作汇报、政策宣讲、党建学习、年度总结与重点工作部署",
|
||||
"visual_direction": "solemn and dignified Chinese government-report presentation, confident Chinese-red and gold visual identity, strong title hierarchy, restrained ceremonial details, and clear policy communication",
|
||||
"canvas": {
|
||||
"aspect_ratio": "16:9",
|
||||
"background": "choose deep red, warm ivory, or a restrained combination according to page role and content density; where appropriate, use a low-contrast pale-gold landscape or Great Wall motif near the lower area as a subtle unifying background element that never competes with the content",
|
||||
"composition": "formal, balanced, and strongly aligned composition with a prominent title area and disciplined content hierarchy",
|
||||
"density": "medium information density with generous margins, clear reading order, and concise conclusions"
|
||||
},
|
||||
"color_palette": {
|
||||
"primary": "Chinese red #C41E3A for main titles, structural emphasis, and key labels",
|
||||
"secondary": "deep red #9E1530 for contrast and warm ivory #FFF9F2 for the main canvas",
|
||||
"accent": "restrained matte gold #D6A84B and warm amber #E9A11B for icons, connectors, and small title ornaments",
|
||||
"neutral": "ink black #262626, dark gray #4A4A4A, pale warm gray #F3EEE7",
|
||||
"rule": "use Chinese red to establish authority and gold as a restrained accent. Balance red, warm ivory, and neutral space according to page role; avoid glitter, glossy gradients, and festive red-and-gold decoration"
|
||||
},
|
||||
"typography": {
|
||||
"title": "large bold Microsoft YaHei or Source Han Sans style Chinese sans-serif, visually strong, dignified, and immediately noticeable",
|
||||
"body": "Microsoft YaHei or Source Han Sans style Chinese sans-serif, concise, highly readable, and aligned to a strict grid",
|
||||
"labels": "bold white or dark-red text on restrained red or pale-gold blocks",
|
||||
"text_quality": "all Chinese text must be exact, fully legible, non-garbled, and suitable for formal government reporting"
|
||||
},
|
||||
"title_system": {
|
||||
"consistency_rule": "Keep the title hierarchy, typeface, weight, color logic, and spacing consistent across slides of the same page type.",
|
||||
"cover": "May use a more ceremonial and prominent title treatment suited to an opening page.",
|
||||
"section_divider": "May use a concise title treatment with stronger whitespace and a clear section cue.",
|
||||
"content_slide": "Prefer an optional restrained section-navigation cue, a prominent centered main title, and a small gold separator. Keep the hierarchy recognizable across content slides while adapting its exact form, scale, and spacing to the page content.",
|
||||
"flexibility": "Treat this as a visual consistency guide, not a fixed template. Title position and decoration may adapt when the slide role or composition requires it."
|
||||
},
|
||||
"layout_patterns": [
|
||||
"ceremonial cover with a large prominent title and restrained red-and-gold visual framing",
|
||||
"section divider with a concise statement, clear section cue, and generous negative space",
|
||||
"policy overview with one core statement and three to five aligned content modules",
|
||||
"key work deployment with clear priorities, concise explanations, and a strong bottom conclusion",
|
||||
"timeline or process page using a restrained red-and-gold hierarchy",
|
||||
"achievement summary with large key figures, restrained charts, and evidence-based captions"
|
||||
],
|
||||
"layout_usage_rule": "Keep the red-and-gold identity consistent while varying covers, dividers, content grids, timelines, and data pages by purpose. Use light backgrounds for dense content instead of forcing every slide onto solid red.",
|
||||
"layout_blueprints": [
|
||||
{
|
||||
"name": "封面 / 章节页",
|
||||
"sections": [
|
||||
{"position": "center", "count": 1, "labels": ["large formal title"]},
|
||||
{"position": "below title", "count": 1, "labels": ["subtitle or reporting unit and date"]},
|
||||
{"position": "bottom", "count": 1, "labels": ["subtle ribbon, Great Wall, or abstract architectural horizon"]}
|
||||
]
|
||||
},
|
||||
{
|
||||
"name": "重点工作部署",
|
||||
"sections": [
|
||||
{"position": "top", "count": 1, "labels": ["page title and one-sentence guiding statement"]},
|
||||
{"position": "middle", "count": 4, "labels": ["重点一", "重点二", "重点三", "重点四"]},
|
||||
{"position": "bottom", "count": 1, "labels": ["summary or action requirement"]}
|
||||
]
|
||||
},
|
||||
{
|
||||
"name": "成果与数据",
|
||||
"sections": [
|
||||
{"position": "top", "count": 1, "labels": ["page title"]},
|
||||
{"position": "upper middle", "count": 3, "labels": ["key figure 1", "key figure 2", "key figure 3"]},
|
||||
{"position": "lower middle", "count": 1, "labels": ["restrained chart, comparison, or timeline"]},
|
||||
{"position": "bottom", "count": 1, "labels": ["evidence-based conclusion"]}
|
||||
]
|
||||
}
|
||||
],
|
||||
"visual_elements": {
|
||||
"allowed": "restrained red-and-gold geometric accents, formal information modules, timelines, process arrows, simple line icons, clean charts, subtle Chinese cultural or architectural motifs, and light decorative texture",
|
||||
"avoid": "invented government or party logos, national emblems, seals, flags, hammer-and-sickle symbols, excessive ceremonial decoration, thick shadows, glossy 3D text, glitter, lanterns, fireworks, wedding motifs, Lunar New Year decoration, cartoon characters, and unrelated stock imagery"
|
||||
},
|
||||
"image_treatment": {
|
||||
"photos": "use only relevant user-provided documentary or institutional photos; apply consistent red-toned framing rather than heavy color filters",
|
||||
"screenshots": "place inside clean warm-white frames with short source labels and no ornamental clutter",
|
||||
"charts": "use red as the primary series, gold for one key highlight, and neutral gray for comparison; keep labels direct and readable",
|
||||
"illustrations": "prefer flat architectural silhouettes, abstract ribbons, restrained line art, or policy-related diagrams instead of decorative scenes"
|
||||
},
|
||||
"rendering_constraints": [
|
||||
"The slide must look like a formal Chinese government or public-sector report, not a festival poster or commercial advertisement.",
|
||||
"Use large, dignified Chinese sans-serif typography resembling Microsoft YaHei or Source Han Sans.",
|
||||
"Follow a consistent title system across slides of the same page type, while allowing cover, section-divider, and content-slide variants.",
|
||||
"Use Chinese red #C41E3A as the main red and gold as a restrained supporting accent.",
|
||||
"Keep gold restrained and matte; do not use glossy metallic or embossed 3D text.",
|
||||
"Use exact readable Chinese text and a clear top-to-bottom or left-to-right hierarchy.",
|
||||
"Do not invent official marks, government logos, party emblems, national emblems, seals, flags, or institutional names.",
|
||||
"No watermark and no unrelated logo."
|
||||
]
|
||||
}
|
||||
```
|
||||
@@ -0,0 +1,105 @@
|
||||
# 教学课件风
|
||||
|
||||
**适用场景:**
|
||||
- 高校课程、专题讲座与课堂教学
|
||||
- 技术培训、知识科普与专业能力建设
|
||||
- 概念讲解、体系梳理、案例分析与研究进展介绍
|
||||
- 需要同时呈现文字、图解、图片和数据的教学型演示
|
||||
|
||||
**GPT-Image-2 风格 Brief:**
|
||||
```json
|
||||
{
|
||||
"type": "16:9 full-slide PowerPoint image",
|
||||
"style_name": "教学课件风",
|
||||
"best_for": "高校课程、专题讲座、技术培训、知识科普、概念讲解、体系梳理、案例分析和研究进展介绍",
|
||||
"visual_direction": "clear and credible academic courseware, structured knowledge communication, modular information design, evidence-supported explanation, and a professional classroom tone",
|
||||
"canvas": {
|
||||
"aspect_ratio": "16:9",
|
||||
"background": "white or very light cool gray with restrained pale-blue structural accents",
|
||||
"composition": "structured teaching slide with a clear title area, modular knowledge blocks, diagrams, evidence images, or comparisons selected according to the lesson objective",
|
||||
"density": "balanced teaching density: substantial enough to support explanation, but never sparse, paragraph-heavy, or crowded; use strong grouping, alignment, and readable whitespace"
|
||||
},
|
||||
"color_palette": {
|
||||
"primary": "deep academic navy #0B2E6D and clear blue #1769AA",
|
||||
"secondary": "light blue #EAF3FB and cool gray #F3F6F9",
|
||||
"accent": "choose a small set of restrained auxiliary colors according to the subject matter, source material, and semantic categories",
|
||||
"neutral": "ink black #1F2937, body gray #4B5563, border gray #D7E0EA",
|
||||
"rule": "use the blue system to establish the teaching structure; select auxiliary colors only when the content needs semantic distinction, then apply them consistently rather than decoratively"
|
||||
},
|
||||
"typography": {
|
||||
"title": "large bold Chinese sans-serif resembling Microsoft YaHei or Source Han Sans, usually dark navy, concise and immediately readable",
|
||||
"body": "compact but readable Chinese sans-serif with clear indentation and short explanatory phrases",
|
||||
"labels": "bold short labels with strong contrast inside restrained color-coded blocks",
|
||||
"text_quality": "all Chinese text, Latin terms, formulas, units, and data labels must be exact, readable, and non-garbled"
|
||||
},
|
||||
"title_system": {
|
||||
"consistency_rule": "Keep title typeface, weight, color logic, alignment, and spacing consistent across slides of the same page type.",
|
||||
"cover": "May combine a large course title with one strong topic image and concise presenter or course information.",
|
||||
"section_divider": "May use a concise section title with stronger whitespace and a restrained academic cue.",
|
||||
"content_slide": "Prefer a stable, prominent title area with a subtle blue rule or structural accent, while allowing the exact alignment and composition to adapt to the teaching content.",
|
||||
"closing": "Use a concise acknowledgement or closing statement together with a topic-relevant visual echo; keep the page informative and visually complete rather than leaving a nearly empty text-only slide.",
|
||||
"flexibility": "Treat the title system as a consistency guide rather than a fixed template. Do not force every slide into the same header composition."
|
||||
},
|
||||
"layout_patterns": [
|
||||
"course cover combining a clear title hierarchy with a topic-relevant main visual and concise course information",
|
||||
"concept explanation using a central model and surrounding factors",
|
||||
"development stages or maturity levels using a clear progression",
|
||||
"process or workflow explanation combining steps, diagrams, and evidence",
|
||||
"comparison or relationship page using aligned modules and semantic colors",
|
||||
"case study combining a key image with maps, metrics, observations, and conclusions",
|
||||
"application overview using a structured gallery of examples",
|
||||
"knowledge summary using a concise framework and one clear takeaway",
|
||||
"closing or acknowledgement page combining a short closing statement with a restrained topic-relevant visual"
|
||||
],
|
||||
"layout_usage_rule": "Choose the layout that best supports the teaching objective and viewing sequence. Every slide should combine meaningful visual explanation with readable text; use one strong image or several complementary images, diagrams, screenshots, or charts according to the content. Keep the visual language coherent without repeating one composition on every slide.",
|
||||
"layout_blueprints": [
|
||||
{
|
||||
"name": "概念与体系",
|
||||
"sections": [
|
||||
{"position": "title area", "count": 1, "labels": ["lesson question or core concept"]},
|
||||
{"position": "main area", "count": 1, "labels": ["system diagram or concept model"]},
|
||||
{"position": "supporting area", "count": 2, "labels": ["definition or explanation", "key takeaway or implication"]}
|
||||
]
|
||||
},
|
||||
{
|
||||
"name": "流程与阶段",
|
||||
"sections": [
|
||||
{"position": "title area", "count": 1, "labels": ["process or progression topic"]},
|
||||
{"position": "main area", "count": 1, "labels": ["ordered stages, workflow, or maturity progression"]},
|
||||
{"position": "supporting area", "count": 1, "labels": ["conditions, risks, or summary"]}
|
||||
]
|
||||
},
|
||||
{
|
||||
"name": "案例与证据",
|
||||
"sections": [
|
||||
{"position": "title area", "count": 1, "labels": ["case or application topic"]},
|
||||
{"position": "evidence area", "count": 2, "labels": ["primary image or map", "data, facts, or observations"]},
|
||||
{"position": "conclusion area", "count": 1, "labels": ["lesson learned or teaching conclusion"]}
|
||||
]
|
||||
}
|
||||
],
|
||||
"visual_elements": {
|
||||
"allowed": "relevant photographs, multi-image evidence groups, clean line icons, modular cards, process arrows, relationship diagrams, level progressions, maps, timelines, annotated technical images, comparison grids, data charts, and subtle academic or technical background texture",
|
||||
"avoid": "text-only pages, purely decorative illustration, generic AI-looking imagery, fake futuristic interfaces, random 3D icons, playful stickers, excessive gradients, heavy shadows, glossy elements, inconsistent icon styles, dense ungrouped text, unrelated stock imagery, and ornamental layouts that weaken the teaching sequence"
|
||||
},
|
||||
"image_treatment": {
|
||||
"photos": "use relevant course or case images as evidence, crop them consistently, and pair them with concise explanatory labels; one page may use a single main image or several complementary images when they explain different aspects of the topic",
|
||||
"screenshots": "place inside clean frames and preserve important interface details, annotations, and labels",
|
||||
"charts": "use the palette semantically, retain accurate axes and values, and emphasize the comparison or trend being taught",
|
||||
"illustrations": "prefer flat technical diagrams, simplified system models, and explanatory line art over decorative scenes"
|
||||
},
|
||||
"rendering_constraints": [
|
||||
"The slide must look like professional academic courseware, not a marketing pitch deck.",
|
||||
"Prioritize teaching sequence, conceptual clarity, and readable evidence over visual decoration.",
|
||||
"Every slide must contain both meaningful visual content and readable text; visuals should explain, demonstrate, compare, or provide evidence rather than merely decorate.",
|
||||
"Avoid both underfilled slides and long blocks of prose. Convert dense explanations into diagrams, image groups, structured labels, or concise teaching points.",
|
||||
"Keep related information visibly grouped and maintain a clear viewing order.",
|
||||
"Avoid tiny text; split or simplify content when it cannot remain readable at presentation distance.",
|
||||
"Use semantic accent colors consistently across the deck.",
|
||||
"Avoid an obvious AI-generated look: no fabricated text inside images, implausible photo details, generic glowing technology effects, random decorative objects, or repetitive template-like compositions.",
|
||||
"Do not invent university, school, laboratory, company, or course logos; use only user-provided identity assets.",
|
||||
"Do not introduce vehicles, autonomous-driving imagery, or other subject matter from the style reference unless required by the source content.",
|
||||
"No watermark and no unrelated logo."
|
||||
]
|
||||
}
|
||||
```
|
||||
Reference in New Issue
Block a user