# Textslide > ASCII 纯文本布局 DSL + 高保真文字版 slide 规格说明。 用于快速设计 slide 版式草图，并交付可直接还原成 PPT 的完整内容规格书。 当用户请求设计 slide 布局、规划多列多行版式、或需要用文本描述 slide 结构时使用此 skill。 - Skill: `majiayu000/textslide` (Agent Skill, multi-file: 2 files) - Install (CLI): `npx skillmds@latest add majiayu000/textslide` - Raw SKILL.md: https://api.skillmd.com/api/skills/majiayu000/textslide/raw - Safety review: pending (external: skill-scanner PASS, skillspector PASS) - Works with: Claude Code, Claude.ai, OpenAI Codex - Category: Docs & Writing - Author: majiayu000 (https://skillmd.com/u/majiayu000) - Updated: 2026-09-09 - Page: https://skillmd.com/skills/majiayu000/textslide --- # 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 ID** | A / 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): ``` 产品概览：一句话说明我们是谁、做什么 ``` #### Block B - **Role**: 左侧关键信息说明 - **Content type**: text paragraph + inline emphasis - **Content** (copy-paste): ``` 我们提供一套面向中小团队的自动化数据分析平台，帮助非技术成员在不写代码的前提下， 也能完成从「数据接入 → 清洗建模 → 可视化看板」的完整流程。**核心价值：减少 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): ``` - 将报表制作时间平均缩短 70% - 支持主流数据源一键接入（MySQL / Postgres / CSV / SaaS） - 面向非技术团队设计，培训成本低，上手快 ``` #### Block E - **Role**: 页脚 / logo + 版权信息 - **Content type**: text + small logo - **Spec**: - 左侧放公司 logo（白底 / 透明背景） - 右侧文字 (copy-paste): ``` © 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**。