Back to Details

ascii-cli-logo-banner

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

When to use this skill

何时使用此Skill

CRITICAL TRIGGER RULE
  • Use this skill ONLY when the user explicitly mentions the exact skill name: 
    ascii-cli-logo-banner
    .
Use this skill when the user says they want:
  • A startup banner / logo / welcome screen for a CLI or service
Trigger phrases include:
  • "ascii-cli-logo-banner"
  • "use ascii-cli-logo-banner"
  • "用 ascii-cli-logo-banner"
  • "使用 ascii-cli-logo-banner 生成启动 Banner"
  • "用 ascii-cli-logo-banner 做一个 ASCII Logo"
核心触发规则
  • 仅当用户明确提及确切的Skill名称：
    ascii-cli-logo-banner
    时，才可使用此Skill。
在用户提出以下需求时使用此Skill：
  • 为CLI或服务生成启动横幅/Logo/欢迎界面
触发语句包括：
  • "ascii-cli-logo-banner"
  • "use ascii-cli-logo-banner"
  • "用 ascii-cli-logo-banner"
  • "使用 ascii-cli-logo-banner 生成启动 Banner"
  • "用 ascii-cli-logo-banner 做一个 ASCII Logo"

Boundary

边界说明

  • This skill is a routing/selection entry point. It does not provide its own generator implementation.
  • For built-in (no external font engine): use 
    ascii-cli-logo-banner-python
    .
  • For TAAG/FIGlet style (FIGfont spec, smushing layouts): use 
    ascii-cli-logo-banner-figletjs
    .
  • 此Skill是一个路由/选择入口，不提供自身的生成器实现。
  • 若使用内置（无需外部字体引擎）：请使用
    ascii-cli-logo-banner-python
    。
  • 若使用TAAG/FIGlet风格（遵循FIGfont规范，支持压缩布局）：请使用
    ascii-cli-logo-banner-figletjs
    。

How to use this skill

如何使用此Skill

Inputs (recommended)

推荐输入参数

  • brandName (required)
  • version (optional)
  • author (optional)
  • repoUrl / docsUrl (optional)
  • width (default 80)
  • slogan (optional, centered line under the logo)
  • hint (optional, centered line under the slogan)
  • glyph (ascii | block, default ascii)
  • center (default true)
  • rule (default true; set false for logo-only hero output)
  • style (block | outline | thin, default block)
  • colorMode (none | ansi256, default none; logo only in scripts)
  • includeCta (default true)
  • brandName（必填）
  • version（可选）
  • author（可选）
  • repoUrl / docsUrl（可选）
  • width（默认值80）
  • slogan（可选，位于Logo下方的居中行）
  • hint（可选，位于标语下方的居中行）
  • glyph（可选值：ascii | block，默认ascii）
  • center（默认true）
  • rule（默认true；若仅输出Logo主体，可设为false）
  • style（可选值：block | outline | thin，默认block）
  • colorMode（可选值：none | ansi256，默认none；仅在脚本中支持Logo上色）
  • includeCta（默认true）

Outputs (required)

要求输出

  • bannerPlain: ASCII-only full banner (logo area + info block + horizontal rule)
  • compactPlain: compact banner for 
    width < 60
    (single-line title + rule + 1-2 info lines)
  • plainTextFallback: no-color fallback when ANSI is enabled (same structure as bannerPlain)
  • embedNotes: 3-5 embedding notes (CLI start / service start / README / tickets)
  • bannerPlain：纯ASCII格式的完整横幅（Logo区域 + 信息块 + 水平分隔线）
  • compactPlain：适用于
    width < 60
    的紧凑横幅（单行标题 + 分隔线 + 1-2行信息）
  • plainTextFallback：当启用ANSI上色时的无色回退版本（结构与bannerPlain一致）
  • embedNotes：3-5条嵌入说明（适用于CLI启动/服务启动/README/工单场景）

Steps

步骤

  1. Decide width and fallback:
    • Default 
      width=80
    • If 
      width < 60
      , output 
      compactPlain
      and skip the big-letter logo
  2. Generate an ASCII-only logo:
    • Avoid full-width characters and ambiguous-width Unicode
    • Ensure each line is 
      <= width
  3. Compose the banner structure (recommended order):
    • Logo area (or a single-line title in compact mode)
    • Horizontal rule: exactly 
      width
      characters (
      -
      or 
      =
      )
    • Info block: Name / Version / Repo / Docs / Author (only include fields provided)
    • Optional CTA: e.g. 
      Run: <command>
      or 
      Docs: <url>
  4. Optional ANSI coloring (must not break alignment):
    • Colorize visible characters only; do not colorize spaces
    • Always provide 
      plainTextFallback
  1. 确定宽度与回退方案：
    • 默认
      width=80
    • 若
      width < 60
      ，输出
      compactPlain
      并跳过大字Logo
  2. 生成纯ASCII格式的Logo：
    • 避免全角字符和宽度模糊的Unicode字符
    • 确保每行长度
      <= width
  3. 组合横幅结构（推荐顺序）：
    • Logo区域（紧凑模式下为单行标题）
    • 水平分隔线：长度恰好为
      width
      的字符（
      -
      或
      =
      ）
    • 信息块：名称/版本/仓库/文档/作者（仅包含提供的字段）
    • 可选的CTA：例如
      Run: <command>
      或
      Docs: <url>
  4. 可选的ANSI上色（不得破坏对齐）：
    • 仅为可见字符上色；不得为空格上色
    • 必须提供
      plainTextFallback
      版本

Script (optional)

脚本（可选）

  • Use 
    ascii-cli-logo-banner-python
    for the Python implementation.
  • Use 
    ascii-cli-logo-banner-figletjs
    for the figlet.js/FIGfont implementation.
  • 若使用Python实现，请使用
    ascii-cli-logo-banner-python
    。
  • 若使用figlet.js/FIGfont实现，请使用
    ascii-cli-logo-banner-figletjs
    。

Examples

示例

  • See examples in the two implementation skills: 
    • ascii-cli-logo-banner-python/examples/*
    • ascii-cli-logo-banner-figletjs/examples/*
  • 请查看两个实现Skill中的示例： 
    • ascii-cli-logo-banner-python/examples/*
    • ascii-cli-logo-banner-figletjs/examples/*

Quality checklist

质量检查清单

  1. Does not wrap or misalign at 80 columns; no trailing spaces
  2. Copy-pastes cleanly into logs/email/tickets
  3. Never prints secrets (tokens, internal URLs, personal data)
  1. 在80列宽度下不会换行或对齐错误；无 trailing spaces
  2. 可干净地复制粘贴到日志/邮件/工单中
  3. 绝不会打印敏感信息（令牌、内部URL、个人数据）

Keywords

关键词

English: ascii, banner, logo, cli, terminal, startup, welcome, plain text, ansi, no-color 中文: ASCII, 启动横幅, 终端 Banner, CLI Logo, 欢迎页, 纯文本, ANSI 上色, 无色回退
英文: ascii, banner, logo, cli, terminal, startup, welcome, plain text, ansi, no-color 中文: ASCII, 启动横幅, 终端 Banner, CLI Logo, 欢迎页, 纯文本, ANSI 上色, 无色回退