AgentSkillsCN

textslide

ASCII 纯文本布局 DSL + 高保真文字版 slide 规格说明。 用于快速设计 slide 版式草图,并交付可直接还原成 PPT 的完整内容规格书。 当用户请求设计 slide 布局、规划多列多行版式、或需要用文本描述 slide 结构时使用此 skill。

中文原作
SKILL.md
--- frontmatter
name: textslide
description: >
  ASCII 纯文本布局 DSL + 高保真文字版 slide 规格说明。
  用于快速设计 slide 版式草图,并交付可直接还原成 PPT 的完整内容规格书。
  当用户请求设计 slide 布局、规划多列多行版式、或需要用文本描述 slide 结构时使用此 skill。

Textslide DSL

用 ASCII 纯文本描述 slide 的版式布局,配合内容块规格,交付可直接实现的高保真文字版稿。

术语定义

术语英文说明
高保真文字版稿high-fidelity textual slide spec完整的 slide 规格说明,可直接还原成 PPT
内容块规格content block spec每个布局区域(A/B/C…)的详细定义

基本约定

  1. 一页 slide = 一个 ASCII 块(代码块包裹)
  2. 符号:- 画横线(行边界),| 画竖线(列边界)
  3. 每行字符数相同,竖线列固定,保证对齐
  4. 单元格内容:文本直接写,图片/图表用 caption: XXX
  5. 可用前缀标记区域:A: ...B: ...
  6. 相对大小:跨列数 = 相对宽度,跨行数 = 相对高度

输出要求

每个 slide 设计必须包含三部分:

  1. ASCII 布局草图 — 版式结构(textslide DSL)
  2. 内容块规格 — 每个 A/B/C… 区域的详细定义
  3. 参考链接和素材来源 — 布局灵感、设计参考、素材 URL

交付目标:拿到这个文字版规格,可以在不二次设计的情况下,还原出 80–90% 一致的 PPT。

内容块规格结构

对每个 Block(A/B/C…),写一个「内容块规格」:

字段说明
Block IDA / B / C …
Role区域在信息结构里的作用:标题 / 主视觉 / 关键要点 / 辅助说明 / 底部说明等
Content type内容类型(见下表)
Content若是文字:最终可复制的文案(包含换行和 bullet 结构)
Spec若是非文字:可据此还原的详细说明(元素、层级、逻辑关系、风格)
References参考 URL(标注是配色/构图/风格参考)
Constraints额外约束(留白、品牌色、动画等,可选)

Content type 枚举

  • text paragraph — 段落
  • bullet points — 要点列表
  • infographic — 信息图
  • chart — 图表(bar/line/pie…)
  • photography — 照片
  • icon set / pictogram — 图标集
  • logo — 标识
  • code block — 代码块

非文字内容的详细说明要求

对于图表、信息图、照片等非文字内容,Spec 应包括:

  • 图表:维度、指标、示例数据、对比关系
  • 信息图:步骤/模块数量,每个模块的标题+短描述,层级关系
  • 照片:主体(人物/场景)、构图、气氛、风格(纪实/科技感等)、避免/必须包含的元素

布局示例

单列:标题 + 正文

text
--------------------------------------------------------
|Slide title: DSL for slides                           |
--------------------------------------------------------
|- all layout in plain text                            |
|- easy to version control                             |
|- supports relative block sizes                       |
--------------------------------------------------------

标题占 1 行,正文占多行 → 正文区域更高。

两列:左宽右窄

text
----------------------------------------------------------------
|Slide title (A)                     |caption: overview (B)    |
----------------------------------------------------------------
|- point 1                           |                         |
|- point 2                           |                         |
|- point 3                           |                         |
----------------------------------------------------------------

左列宽度 ≈ 2fr,右列宽度 ≈ 1fr。

三列跨区:A/A/B + C/D/B

text
----------------------------------------------------------------
|A: summary            |A: summary (cont.) |B: big number panel |
----------------------------------------------------------------
|C: text block         |D: text block      |B: extra notes      |
----------------------------------------------------------------
  • A 跨两列(宽度 = C+D 总宽)
  • B 跨两行(高度 = A+C 或 A+D)

嵌套布局

text
------------------------------------------------------------------
|A: Hero title & overview           |B: caption: main graphic    |
------------------------------------------------------------------
|C: key points & explanation        |E: caption: detail chart    |
|C: more details / notes            |----------------------------|
|C: more details / notes (cont.)    |F: notes    |G: notes       |
------------------------------------------------------------------

右下角 E/F/G 为内部细分区域,渲染时可用嵌套 Grid 实现。

完整示例:产品概览页

1. ASCII 布局(textslide)

text
----------------------------------------------------------------
|A: slide title: 产品概览                                      |
----------------------------------------------------------------
|B: key message block             |C: caption: hero graphic    |
|                                 |(infographic / illustration)|
----------------------------------------------------------------
|D: supporting points (3 bullets) |E: logo / footer note       |
----------------------------------------------------------------

2. 内容块规格(Content Block Specs)

Block A

  • Role: 主标题
  • Content type: text
  • Content (copy-paste):
    code
    产品概览:一句话说明我们是谁、做什么
    

Block B

  • Role: 左侧关键信息说明
  • Content type: text paragraph + inline emphasis
  • Content (copy-paste):
    code
    我们提供一套面向中小团队的自动化数据分析平台,帮助非技术成员在不写代码的前提下,
    也能完成从「数据接入 → 清洗建模 → 可视化看板」的完整流程。**核心价值:减少 70% 以上重复报表工作**,
    并让业务团队对数据结果「看得懂、改得快」。
    

Block C

  • Role: 右侧主视觉 / 信息图
  • Content type: infographic
  • Spec:
    • 结构:三段式流程图,从左到右:
      1. 数据源(图标:数据库 + Excel + 第三方系统)
      2. 我们的平台(一个带 logo 的矩形模块,上下注释「自动建模」「智能推荐图表」)
      3. 输出(图标:仪表盘 / 图表 / 报告)
    • 视觉层级:
      • 平台模块要最醒目(颜色更实 / 对比更强)
      • 输入和输出用相对淡一点的图标
    • 强调文案(可放在平台模块中或下方小标注):
      • 「No code」「Auto-modeling」「One-click dashboard」
    • Style: 扁平、简洁、偏产品官网风格,不要过多渐变与拟物

Block D

  • Role: 支撑要点(3 条 bullet points)
  • Content type: bullet points
  • Content (copy-paste):
    code
    - 将报表制作时间平均缩短 70%
    - 支持主流数据源一键接入(MySQL / Postgres / CSV / SaaS)
    - 面向非技术团队设计,培训成本低,上手快
    

Block E

  • Role: 页脚 / logo + 版权信息
  • Content type: text + small logo
  • Spec:
    • 左侧放公司 logo(白底 / 透明背景)
    • 右侧文字 (copy-paste):
      code
      © 2025 Company Name. All rights reserved.
      

3. 参考链接与来源

  • Infographic 风格参考(流程图结构):
    • https://dribbble.com/...(流程型 SaaS 产品概览)
  • Dashboard 输出样式参考(仅做构图灵感,不直接照抄):
    • https://dribbble.com/...
  • Logo 使用规范:见品牌手册第 3 页(如有)

协作说明模版

向设计同事发送需求时可用:

之后我这边希望你交付的是一个高保真的文字版 slide 规格说明,我只负责实现,不再做二次设计。每一页 slide 请包含三部分:

  1. ASCII 示例(布局草图) — 使用 textslide DSL 画出本页的格子布局(A/B/C…)
  2. 内容块规格 — 对每个 A/B/C… 都写清楚 Role、Content type、最终文案或详细 Spec
  3. 参考链接和素材来源 — 每个非纯文字的 block 附 1–3 个参考 URL

目标是:我拿到这个文字版规格,就可以在不二次设计的情况下,还原出与你预期 80–90% 一致的 PPT