Skip to content

yzsp-studio/mediakit-shared-suite / ppt

飞书幻灯片:创建和编辑幻灯片。创建演示文稿、读取幻灯片内容、管理幻灯片页面(创建、删除、读取、局部替换)。当用户需要创建或编辑幻灯片、读取或修改单个页面时使用。

FileKindSize
SKILL.mdskill md40.1 KB
references/cli/lark-slides-add-slide.mdmarkdown7.3 KB
references/cli/lark-slides-create.mdmarkdown10.5 KB
references/cli/lark-slides-delete-slide.mdmarkdown2.7 KB
references/cli/lark-slides-history.mdmarkdown6.9 KB
references/cli/lark-slides-media-upload.mdmarkdown5.5 KB
references/cli/lark-slides-replace-slide.mdmarkdown14.8 KB
references/cli/lark-slides-screenshot.mdmarkdown5.4 KB
references/cli/lark-slides-update-slide.mdmarkdown11.6 KB
references/cli/lark-slides-xml-presentation-slide-get.mdmarkdown3.6 KB
references/cli/lark-slides-xml-presentation-slide-replace.mdmarkdown7.3 KB
references/cli/lark-slides-xml-presentations-get.mdmarkdown9.4 KB
references/refine/academic-research.mdmarkdown7.3 KB
references/refine/brand-storytelling.mdmarkdown8.3 KB
references/refine/business-pitch.mdmarkdown8.0 KB
references/refine/business-review.mdmarkdown8.3 KB
references/refine/fallback.mdmarkdown7.8 KB
references/refine/learning-and-training.mdmarkdown8.5 KB
references/refine/strategy-and-analysis.mdmarkdown8.1 KB
references/refine/technical-presentation.mdmarkdown8.1 KB
references/style/academic-research.mdmarkdown18.5 KB
references/style/brand-storytelling.mdmarkdown34.1 KB
references/style/business-pitch.mdmarkdown12.2 KB
references/style/business-review.mdmarkdown19.6 KB
references/style/fallback.mdmarkdown8.7 KB
references/style/learning-and-training.mdmarkdown20.8 KB
references/style/slide-taxonomy.mdmarkdown13.6 KB
references/style/strategy-and-analysis.mdmarkdown8.4 KB
references/style/technical-presentation.mdmarkdown15.6 KB
references/workflow/error-handling.mdmarkdown9.6 KB
references/workflow/local-compat.mdmarkdown5.3 KB
references/workflow/slides-editing.mdmarkdown34.6 KB
references/workflow/template-editing-main.mdmarkdown36.6 KB
references/workflow/template-editing-organizer.mdmarkdown24.4 KB
references/workflow/validation-visual.mdmarkdown7.1 KB
references/workflow/validation-xml.mdmarkdown31.9 KB
references/workflow/windows-compat.mdmarkdown6.3 KB
references/xml/fonts.mdmarkdown7.6 KB
references/xml/iconpark-index.jsonconfig729.4 KB
references/xml/iconpark.mdmarkdown2.1 KB
references/xml/slides_chart_demo.xmlconfig69.2 KB
references/xml/slides_xml_schema_definition.xmlconfig228.6 KB
references/xml/xml-schema-quick-ref.mdmarkdown34.7 KB
scripts/atomize_svg_to_slide.pyscript80.2 KB
scripts/atomize_svg_to_slide_test.pyscript5.5 KB
scripts/color_contrast_check.pyscript36.4 KB
scripts/color_contrast_check_test.pyscript28.9 KB
scripts/embed_svg_validator.pyscript56.7 KB
scripts/embed_svg_validator_test.pyscript18.2 KB
scripts/gen_svg_charts.pyscript48.8 KB
scripts/gen_svg_relations.pyscript42.6 KB
scripts/iconpark_tool.pyscript12.1 KB
scripts/iconpark_tool_test.pyscript7.7 KB
scripts/lint_inspect.pyscript23.3 KB
scripts/lint_inspect_test.pyscript13.2 KB
scripts/parse_template.pyscript114.0 KB
scripts/purge_deck.pyscript11.4 KB
scripts/safe_update_slide.pyscript21.0 KB
scripts/svg_lib/_baseline.pyscript50.9 KB
scripts/svg_lib/_boxplot_skin.pyscript21.5 KB
scripts/svg_lib/_common.pyscript46.6 KB
scripts/svg_lib/charts/__init__.pyscript853 B
scripts/svg_lib/charts/_shared.pyscript8.6 KB
scripts/svg_lib/charts/boxplot.pyscript26.9 KB
scripts/svg_lib/charts/calheat.pyscript45.7 KB
scripts/svg_lib/charts/candle.pyscript39.1 KB
scripts/svg_lib/charts/event_timeline.pyscript66.6 KB
scripts/svg_lib/charts/funnel.pyscript54.6 KB
scripts/svg_lib/charts/gantt.pyscript53.6 KB
scripts/svg_lib/charts/marimekko.pyscript26.9 KB
scripts/svg_lib/charts/matrix_heat.pyscript52.3 KB
scripts/svg_lib/charts/nested_donut.pyscript61.2 KB
scripts/svg_lib/charts/percent_grid.pyscript38.6 KB
scripts/svg_lib/charts/pyramid.pyscript44.8 KB
scripts/svg_lib/charts/quadrant.pyscript76.8 KB
scripts/svg_lib/charts/ridge.pyscript28.7 KB
scripts/svg_lib/charts/sankey.pyscript48.9 KB
scripts/svg_lib/charts/violin.pyscript37.2 KB
scripts/svg_lib/charts/waterfall.pyscript52.3 KB
scripts/svg_lib/svg_palettes.pyscript52.7 KB
scripts/svg_relation_lib/__init__.pyscript2.0 KB
scripts/svg_relation_lib/_viewbox.pyscript10.5 KB
scripts/svg_relation_lib/attributes/__init__.pyscript1.4 KB
scripts/svg_relation_lib/attributes/_resolver.pyscript1.3 KB
scripts/svg_relation_lib/attributes/_test_attrs.pyscript11.8 KB
scripts/svg_relation_lib/attributes/_test_pipeline.pyscript12.5 KB
scripts/svg_relation_lib/attributes/apply.pyscript5.3 KB
scripts/svg_relation_lib/attributes/category.pyscript1.5 KB
scripts/svg_relation_lib/attributes/confidence.pyscript1.5 KB
scripts/svg_relation_lib/attributes/directional.pyscript1.4 KB
scripts/svg_relation_lib/attributes/highlight.pyscript1.6 KB
scripts/svg_relation_lib/attributes/signed.pyscript1.7 KB
scripts/svg_relation_lib/attributes/size.pyscript1.3 KB
scripts/svg_relation_lib/attributes/status.pyscript2.1 KB
scripts/svg_relation_lib/attributes/temporal.pyscript2.5 KB
scripts/svg_relation_lib/attributes/typed.pyscript1.6 KB
scripts/svg_relation_lib/attributes/weighted.pyscript1.4 KB
scripts/svg_relation_lib/chrome.pyscript9.1 KB
scripts/svg_relation_lib/engine.pyscript11.5 KB
scripts/svg_relation_lib/layouts/__init__.pyscript383 B
scripts/svg_relation_lib/layouts/bloom_v2.pyscript37.9 KB
scripts/svg_relation_lib/layouts/c4_container_v2.pyscript35.1 KB
scripts/svg_relation_lib/layouts/column_stack.pyscript5.3 KB
scripts/svg_relation_lib/layouts/fishbone_v2.pyscript38.1 KB
scripts/svg_relation_lib/layouts/hub_fanout.pyscript15.5 KB
scripts/svg_relation_lib/layouts/osi_stack_v2.pyscript32.8 KB
scripts/svg_relation_lib/layouts/vertical_chain.pyscript4.5 KB
scripts/svg_relation_lib/palettes.pyscript8.9 KB
scripts/svg_relation_lib/palettes_ext.pyscript17.2 KB
scripts/svg_relation_lib/presets/__init__.pyscript297 B
scripts/svg_relation_lib/presets/_chrome.pyscript1.6 KB
scripts/svg_relation_lib/presets/hero_embed_01_AL_fishbone_v2.pyscript21.7 KB
scripts/svg_relation_lib/presets/hero_embed_02_PY_pmf_v2.pyscript16.5 KB
scripts/svg_relation_lib/presets/hero_embed_03_BL_bloom_v2.pyscript44.0 KB
scripts/svg_relation_lib/presets/hero_embed_04_J1_osi_v2.pyscript46.2 KB
scripts/svg_relation_lib/presets/hero_embed_05_MP_mindmap_v2.pyscript28.6 KB
scripts/svg_relation_lib/presets/hero_embed_07_TX_taxonomy_v2.pyscript64.7 KB
scripts/svg_relation_lib/presets/hero_embed_08_KP_kpi_v2.pyscript79.5 KB
scripts/svg_relation_lib/presets/hero_embed_09_E2_5why_v2.pyscript39.4 KB
scripts/svg_relation_lib/presets/hero_embed_10_CS_c4_v2.pyscript173.5 KB
scripts/svg_relation_lib/presets/hero_embed_32_CU2_curriculum_v2.pyscript66.1 KB
scripts/svg_relation_lib/presets/hero_embed_49_FT_faulttree_v2.pyscript69.4 KB
scripts/svg_relation_lib/render.pyscript28.0 KB
scripts/svg_relation_lib/render/render_bl_bloom_tests.pyscript8.2 KB
scripts/svg_relation_lib/render/render_cu2_curriculum_variants.pyscript19.6 KB
scripts/svg_relation_lib/render/render_e2_5why_variants.pyscript8.9 KB
scripts/svg_relation_lib/render/render_ft_faulttree_variants.pyscript12.8 KB
scripts/svg_relation_lib/render/render_j1_osi_tests.pyscript12.0 KB
scripts/svg_relation_lib/render/render_py_pmf_variants.pyscript13.0 KB
scripts/svg_relation_lib/render/render_tx_taxonomy_variants.pyscript17.6 KB
scripts/svg_relation_lib/schemas/__init__.pyscript280 B
scripts/svg_relation_lib/schemas/graph.pyscript1.5 KB
scripts/svg_relation_lib/schemas/tree.pyscript11.2 KB
scripts/svg_relation_lib/skeletons.pyscript15.3 KB
scripts/svg_relation_lib/skins/__init__.pyscript1.3 KB
scripts/svg_relation_lib/skins/_base.pyscript10.0 KB
scripts/svg_relation_lib/skins/annual_report_ivory.pyscript9.1 KB
scripts/svg_relation_lib/skins/art_deco.pyscript27.1 KB
scripts/svg_relation_lib/skins/arxiv_clean.pyscript9.1 KB
scripts/svg_relation_lib/skins/arxiv_pastel.pyscript9.0 KB
scripts/svg_relation_lib/skins/bain_scarlet.pyscript9.0 KB
scripts/svg_relation_lib/skins/bauhaus_primary.pyscript9.2 KB
scripts/svg_relation_lib/skins/bcg_forest.pyscript9.0 KB
scripts/svg_relation_lib/skins/bloomberg_amber.pyscript9.2 KB
scripts/svg_relation_lib/skins/blueprint_grid.pyscript9.6 KB
scripts/svg_relation_lib/skins/boardroom_navy.pyscript29.9 KB
scripts/svg_relation_lib/skins/chalkboard_slate.pyscript9.0 KB
scripts/svg_relation_lib/skins/coursera_indigo.pyscript9.0 KB
scripts/svg_relation_lib/skins/couture_noir.pyscript33.0 KB
scripts/svg_relation_lib/skins/deloitte_lime.pyscript8.9 KB
scripts/svg_relation_lib/skins/duolingo_cream.pyscript20.4 KB
scripts/svg_relation_lib/skins/editorial.pyscript6.4 KB
scripts/svg_relation_lib/skins/editorial_atelier.pyscript60.7 KB
scripts/svg_relation_lib/skins/editorial_atelier_lark.pyscript19.6 KB
scripts/svg_relation_lib/skins/editorial_atelier_tokens.mdmarkdown13.6 KB
scripts/svg_relation_lib/skins/engineering_kraft.pyscript9.0 KB
scripts/svg_relation_lib/skins/goldman_slate.pyscript9.1 KB
scripts/svg_relation_lib/skins/hermes_orange.pyscript9.0 KB
scripts/svg_relation_lib/skins/ib_editorial.pyscript28.9 KB
scripts/svg_relation_lib/skins/journal_ivory.pyscript29.7 KB
scripts/svg_relation_lib/skins/khan_teal.pyscript9.0 KB
scripts/svg_relation_lib/skins/luxury_manual.pyscript20.4 KB
scripts/svg_relation_lib/skins/manuscript_sepia.pyscript9.1 KB
scripts/svg_relation_lib/skins/mbb_consulting.pyscript32.8 KB
scripts/svg_relation_lib/skins/medical_chart.pyscript22.6 KB
scripts/svg_relation_lib/skins/monocle_ecru.pyscript9.1 KB
scripts/svg_relation_lib/skins/napkin.pyscript6.3 KB
scripts/svg_relation_lib/skins/notebook_grid.pyscript9.2 KB
scripts/svg_relation_lib/skins/oxford_indigo.pyscript9.1 KB
scripts/svg_relation_lib/skins/pitch_bauhaus.pyscript9.1 KB
scripts/svg_relation_lib/skins/pitch_ivory.pyscript18.7 KB
scripts/svg_relation_lib/skins/pitch_midnight.pyscript9.1 KB
scripts/svg_relation_lib/skins/pitch_neon.pyscript32.2 KB
scripts/svg_relation_lib/skins/pitch_sunset.pyscript9.1 KB
scripts/svg_relation_lib/skins/registry.pyscript8.5 KB
scripts/svg_relation_lib/skins/riso_duotone.pyscript9.0 KB
scripts/svg_relation_lib/skins/roland_terracotta.pyscript9.0 KB
scripts/svg_relation_lib/skins/saas_product.pyscript38.6 KB
scripts/svg_relation_lib/skins/strategic_briefing.pyscript31.3 KB
scripts/svg_relation_lib/skins/swiss_grid.pyscript8.9 KB
scripts/svg_relation_lib/skins/symposium_ash.pyscript9.2 KB
scripts/svg_relation_lib/skins/technical_whitepaper.pyscript23.7 KB
scripts/svg_relation_lib/skins/terminal_matrix.pyscript9.2 KB
scripts/svg_relation_lib/skins/wabi_sabi.pyscript9.3 KB
scripts/svg_relation_lib/skins/wsj_broadsheet.pyscript9.1 KB
scripts/sxsd_validator.pyscript38.4 KB
scripts/template_lint_all.pyscript48.1 KB
scripts/xml_inspect.pyscript19.8 KB
scripts/xml_inspect_test.pyscript17.7 KB
scripts/xml_lint.pyscript226.8 KB
scripts/xml_lint_test.pyscript346.9 KB

references/style/technical-presentation.md

View on GitHub
# 技术与工程

**路由条件**:系统架构 (RFC、ADR、容量规划、技术债评审);AI 技术或者数据平台提案(LLM、RAG、Agent、特征工程、ML 平台、向量检索);生产故障复盘(Postmortem、SRE 事故报告、影响面分析、防复发审议);对外技术演讲(QCon、KubeCon、DevRel、开源发布会、技术白皮书)。

## 叙事原则

- **标题直接给结论**:读者扫一眼就知道这页在说什么。举例:写「引入 Envoy 后 P99 从 320ms 降到 85ms」,别写「性能优化情况」。
- **顺着"决策链"讲**:目标与约束 → 现状与瓶颈 → 机制 / 架构 → 关键证据 → 取舍 → 上线与回滚 → 风险与下一步。不埋伏笔,不搞"最后揭晓"。
- **文字答"为什么",图形答"怎么走"**:动机、取舍、依据交给文字;调用关系、数据流向交给图形,各司其职别互相翻译,图形要技术级的专业。
- **数据严谨可追溯**:环境、版本、样本量、负载条件一并附上;至少给到 P50 / P95 / P99 或置信区间,只贴一个均值等于什么都没说。
- **已知与推测严格分家**:现状、目标态、假设、已验证结论各占各的位置;数据没到位就写"待补齐 / 假设值",绝不用估算糊上去,需要的时候用字体大小或者颜色区别的区分。
- 术语与缩写第一次出现就解释清楚,之后全篇一个叫法。

---

## 禁止项


| 类别   | 禁止内容                                                                   |
| ---- | ---------------------------------------------------------------------- |
| 布局   | 卡片堆叠层级;均分三/四分构图;2×2 矩阵套路                                               |
| 配色   | 蓝白搭配、蓝紫渐变、青紫霓虹、彩虹光晕、玻璃拟态、发光边框                                          |
| 风格   | 辉光 / 粒子 / 光晕 / 玻璃拟态 / 发光边框 / 3D 箭头 / 透视立方体 / 齿轮 / 赛博地球                 |
| 字体   | 正文字体家族超过两种;代码、路径、字段没用等宽字体                                              |
| 技术套话 | "高可用""高并发""云原生""智能""赋能""打通""端到端""一站式"单独出现——一律换成具体 SLA / QPS / 协议 / 组件名 |
| 数据造假 | 编造基准数据、日志、失效案例、性能曲线、样本数、版本号                                            |
| 图表   | 保留软件默认的坐标轴 / 网格线 / 图例框 / 彩虹配色 / 粗黑边框 / 3D 柱形 / 渐变填充 / 投影               |
| 图形   | 连线穿越文字;交叉超过两处不重排;装饰性箭头和无意义节点                                           |
| 性能报告 | 只报均值,不给 P95 / P99 或置信区间                                                |
| 结尾   | 「谢谢」「Q&A」独立成结尾页;口号式大字无证据;巨型 logo 水印铺底                                  |


---

## 用户附件模板参考

**用户给的 pptx 是最高优先级视觉指导**。用户要求"参考"其风格或用它作模板时,不是逐页复用,先按以下步骤处理再套用本文件的设计原则:

1. **先看渲染效果,别止步于抠文字**:打开样本截图看真实视觉;只跑 xml 提出一堆文字不算看懂模板。
2. **提炼一份精简的参考要点,不逐页照搬**,分三类记录可迁移的部分:
  - **版式手法**:网格骨架、配色规则、步骤式导航、证据分区等结构性设计。
  - **风格基调**:克制、亲和、严谨,或活动现场感、公务通传感。
  - **图形语法**:并列模块、时间轴路径、嵌套层级、取景框等表达手法。
3. **不能改的东西**:主要字体、背景图(尺寸与 ppt 一致的视为背景)、模板自带品牌标识、真实人物 / 照片、原始文案、专属色值、装饰纹样——这些要保留,但可以在其基础上灵活设计。
4. **判断内容属于模板中的哪一类页面再用**,不把局部经验放大成整套通用规则。
5. 没有能直接复用的页面时,回落到下面的设计系统自行搭建。

## 视觉规则

**工程克制**:装饰只允许出现在封面、章节页、结尾页;正文页把视觉分量让给架构图、代码、数据、截图。

**字体**:中文黑体承担标题与正文;代码、路径、字段一律等宽字体(JetBrains Mono / Sarasa Mono / IBM Plex Mono);一份材料不超过两个正文字体家族。

**网格**:先锁定标题基线、图例位置、颜色语义、来源版本号的固定坐标——这套"看不见的骨架"决定材料的可信度。

**图形语法**:箭头端点、拐角、虚线节奏、圆角半径、线型编码全篇一致;同一张结构图只表达一种主要关系。

**目录**:主题色编号 + 章节标题 22pt + 一行 12pt 浅灰说明,三者左对齐;章节间加 0.5pt 细横线;超过五章可左右对称。

**排版**:靠文字、极细浅灰线段、留白、字号差异(用大数字凸显关键值)组织信息,非必要不用卡片堆叠。

## 常用 SVG 图

本设计系统偏好以下数据型 SVG chart 设计(详情跑 `chart_help('<slug>')`);需要使用到树状图(如分层结构、故障分析、容器层级)时走 `relation_help('<slug>')`,支持范围以当前 manifest 为准,正式 Slides 必须用 atomized 可编辑输出,不得用 `<embed>` 作主体:

**推荐 palette**(本场景选一个贯穿全 deck 所有图):

| palette 名 | 底色 | 适用子味道 |
|---|---|---|
| `sapphire_dev` | 白底 | 架构评审 / 研发汇报 · 宝石蓝 |
| `deep_indigo` | 浅底 | AI / 数据 / ML 论文级 · 深靛 |
| `terminal_neon` | 深底 | Terminal / DevOps / Security · 荧光绿 |
| `pine_engineering` | 白底 | 可持续工程 / 能源 / 环保基建 · 松绿 |

**样式收敛**:品牌主色 + 灰阶两级、去默认网格线与图例框、坐标轴单位与来源版本号固定、数据标签只标关键点。**QPS / 延迟 / 资源占用 / 训练曲线走原生 `<chart>`;分布对比、量级流转走 svg chart;需要使用到树状图时走 `gen_svg_relations.py` 的 atomized 可编辑输出**,不要退回文字段落或截图。

## 骨架变体推荐(skeleton variant)

传给 `make_*` 的 `variant=` 参数。不传或传 `None` / `'classic'` 走原经典设计。骨架和 palette 正交组合:骨架决定图形结构与视觉气质,palette 决定色系。
**本场景调性**:精确、密度可高、色感冷静。可读性优先。**深色底 + 荧光点缀**是 DevOps / 监控 / 安全场景的核心武器。

| chart | variant | palette 推荐 | 何时用 |
|---|---|---|---|
| `boxplot` | `beeswarm` | `charcoal_neon` / `sapphire_dev` | 响应时长每样本可见;charcoal_neon 深底 = SRE dashboard |
| `boxplot` | `variable_width_gradient` | `deep_indigo` / `sci_bluegreen` | 宽度编码样本量 |
| `violin` | `kde_only` | `sci_bluegreen` / `sapphire_dev` | 分布形状对比(极简) |
| `candle` | `candle_american_filled` | `charcoal_neon` / `terminal_neon` | 行情 K 线(技术分析)· 深底荧光 = 交易终端 |
| `candle` | `ohlc_american` | `nordic_slate` / `deep_indigo` | 美式棒图(去 body)· 印刷冷色 |
| `matrix_heat` | `circle_full` | `sci_bluegreen` / `pine_engineering` | 系统指标矩阵 · 冷绿色专业 |
| `gantt` | `gradient_bars` | `sci_bluegreen` / `sapphire_dev` | 版本节奏 |
| `sankey` | `gradient_layered` | `charcoal_neon` / `deep_indigo` | 架构数据流;charcoal_neon 深底渐变 = 系统架构最上镜 |

---

## 配色参考(共用)

**第一原则——品牌主色优先**:一旦用户提到了公司 / 机构 / 团队 / 开源项目名称,或提供了 logo,**必须先搜索确认其品牌主色**,把主色定为全篇主题色,围绕它构建整套配色;封面建议直接放品牌 logo 呼应。用户明确给出 VI 色值时直接用。**这条优先级高于下面的参考色板**——只要能确认到品牌色,就不再从下表挑。

无法确认品牌色时,从下表选一套(禁止彩虹色,全篇不超过三种颜色)。都对不上时用兜底:象牙 #F5F1E8、雾灰 #E9E7E2、墨黑 #131417。


| 方案      | 主色      | 辅色                | 背景      | 标题      | 正文      |
| ------- | ------- | ----------------- | ------- | ------- | ------- |
| 宝石蓝     | #003087 | #0070BA / #D4E5F7 | #FFFFFF | #001C54 | #475569 |
| 松绿      | #4C7A5A | —                 | #F4F6F5 | —       | #2E3238 |
| 深靛蓝     | #0D1326 | #2563EB / #BFD7FF | #F2F4F8 | #0D1326 | #536174 |
| 橄榄灰     | #64664A | #3D4246 / #8A8F94 | #F2F2F0 | #0E0E10 | #3D4246 |
| 深青绿     | #0D2825 | #7D927E / #CDBFA9 | #F9F7F3 | #0D2825 | #4F635A |
| 深底-荧光绿  | #D4E92C | #7A8B2C / #6B7280 | #1A1A1E | #FFFFFF | #B8BCC2 |
| 深底-演讲专用 | 品牌色强调   | —                 | #101418 | #F0F2EF | —       |


强调色面积:正文页 3%–8%,章节页可满铺。

---

## 分场景参考

### 系统架构

**气质**:白皮书式严谨——中性哑光底、精确直角结构图、连贯的文档轴;不追视觉冲击,追求"从头翻到尾都很稳"。

**字号**:封面标题 48–64pt,页面标题 28–36pt,正文 15–18pt,代码 11–13pt,图注与来源 9–11pt。

**布局**:十二列网格;顶部固定短标题 + 章节名 + 页码;架构图落在稳定坐标系上,多页复用同一坐标,让读者一眼看到"哪里变了"。

**图形规则**:系统区域用嵌套或并列直角块;调用与数据流用带方向的箭头链;数据流 / 控制流 / 异常路径用线型 + 颜色做冗余编码;一份材料所有架构图共用一套图例;复杂架构先给概览再放大,不要每页重画整体图;性能数据必须挂测试环境、版本、样本量。

**页面语法**:封面(方案标题 + 一句话结论 + 版本号 + 作者 / 团队 / 日期)→ TL;DR(3–5 条结论并挂上证据页码)→ 现状页(一图 + 瓶颈列表)→ 目标架构页(一图 + 用色差或线宽突出差异)→ 迁移页(阶段 / 依赖 / 关卡 / 回滚点按真实时序)。

**视觉母题**:细金属线 · 章节编号徽章 · 稳定图例条 · 关键路径粗线 · 编号锚点。

**场景禁止**:3D 架构图、透视立方体、球体、齿轮堆叠;借用 AWS / Azure / GCP 品牌色伪装通用架构;"系统架构概览""整体设计"这种空洞标题。

---

### AI / 数据平台提案

**气质**:冷静、数据驱动——强调数据链路可信度与模型效果证据;配色偏冷但不冰冷,避开"AI 未来感"套路。

**字号**:封面标题 48–64pt,页面标题 28–36pt,正文 15–18pt,指标大数字 60–96pt,代码 11–13pt。可用朱红 #C9302C 标记当前评估的组件、模型或评估集。

**布局**:可用较高密度的仪表盘布局,仍以固定网格切分;顶部固定评估集与版本号;数据流水线图占主视觉位。

**图形规则**:数据流水线必须分层——离线批式 / 近线流式 / 在线服务的边界要一眼可辨;模型效果对比必须给出评测集名称、样本量、baseline、置信区间;LLM 效果按任务维度分开呈现(推理 / 指令遵循 / 代码 / 安全),不允许用综合分掩盖差异;延迟-质量-成本三方权衡用散点图或帕累托前沿,每个方案在图上标出位置。

**页面语法**:封面(场景一句话 + 关键效果指标 + 版本 / 日期)→ 用户任务页(任务定义 + 输入 / 输出示例 + 成功判据)→ 流水线页(完整链路一图,标注延迟预算和降级路径)→ 机制页(检索 / 排序 / 对齐等核心技术,每模块单独一页)→ 评估证据页(多任务效果对比 + 消融实验 + 与 baseline 的差异)。

**视觉母题**:分层流水线条 · 指标数字 + 迷你分布图 · 帕累托前沿曲线 · 评估集徽章 · 消融矩阵。

**场景禁止**:紫粉渐变、赛博霓虹、"AI 感"发光边框;大脑图案、神经网络插画、拟人机器人;没有 baseline 或置信区间的效果对比;"智能""自适应""端到端优化"这类无实质内容的填充语。

---

### 生产故障复盘

**气质**:法庭档案式冷静——事实驱动、时间线为骨、不推诿;配色偏暗或偏纸,克制用色,避免情绪化渲染。朱红 #C9302C 用于事件节点与超阈指标警戒色,正文页警戒色面积 ≤ 5%。

**字号**:封面标题 44–56pt,页面标题 28–34pt,正文 15–17pt,时间戳与日志 11–13pt(等宽保证纵向对齐)。

**布局**:主时间轴贯穿关键页;顶部固定事故编号、影响时段、严重等级;影响曲线(QPS / 成功率 / 延迟)与事件标注必须垂直对齐。

**图形规则**:时间线横向刻度对齐真实时间;关键事件(触发 / 告警 / 介入 / 恢复)在同一时间轴上标注;根因分析用逐层追因结构,从表象追到直接原因再追到系统性因素;影响必须量化(用户数 / 请求数 / 收入损失 / SLA 违约时长),不允许"少量用户"这种模糊描述;修复动作按已完成 / 进行中 / 待启动分层,每一项挂验证方式与责任人。

**页面语法**:封面(事故编号 + 影响时段时间戳 + 严重等级 + 一句话影响描述)→ 影响概述页(全部量化)→ 时间线页(主时间轴 + 事件节点 + 指标曲线垂直对齐)→ 直接原因页(故障链 + 触发条件 + 首次可发现时点)→ 系统性因素页(从组织 / 流程 / 工具 / 监控 / 文化维度拆解)→ 行动项页(每条挂责任人、时点、验证判据)。

**视觉母题**:主时间轴刻度 · 事件节点圆点 · 严重等级标签 · 影响曲线 · 追因箭头 · 状态色点。

**场景禁止**:"未来一定加强""后续持续关注"这种没有验证判据的动作;只讲直接原因不追系统性因素;把根因归到个人而非流程 / 工具 / 文化的缺口;用装饰性红绿状态灯替代具体数字;写"我们快速响应""团队通力协作"这种自我表扬。

---

### 对外技术演讲 / 开发者布道

**气质**:允许更强的视觉张力和情绪节奏,可用暗场发布;但依然专业克制——不炫技、不上营销词、不硬拉悬念。

**字号**:封面标题 72–120pt,钩子数字 96–160pt,页面标题 32–44pt,正文 18–22pt(现场投影偏大保证后排可读),代码 14–18pt。

**布局**:允许出血视觉与非对称大主图;每页只承载一个概念;章节页可极简(一句话 + 一个数字)制造节奏停顿。

**图形规则**:概念图重于精确架构图——听众要看的是"这件事的形状",不是"每个组件的接口签名";代码片段只保留支撑论点的最小行数,并预先高亮关键行;数据钩子必须真实可复核,绝不虚构性能或用户数字;演示要截取关键帧作为静态代表。

**页面语法**:封面(主题一句话 + 演讲者 / 机构 + 场次)→ 钩子页(一个有冲击力的数字、对比图或 before/after)→ 问题页(具体的用户痛点或工程约束)→ 机制页(分层展开 3–5 步)→ 边界页(诚实说明局限)→ 采纳路径页(链接 / 代码仓 / 试用入口)。

**视觉母题**:巨大数字钩子 · 单色章节停顿页 · before/after 对照 · 关键代码高亮行 · 出血主图。

**场景禁止**:一页超过 7 行文字不拆;结尾页只写「Thank you」不给采纳路径;"下一代""革命性""重新定义""颠覆"这类营销套话;不可复核的性能夸张("快 100 倍"没有环境说明);硬拉悬念的"揭晓页"。
slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack."Stars: 198kUpdated Claude CodeCodexVerifiedInstall
ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt.Stars: 194kUpdated Claude CodeCodexVerifiedInstall