ASCIICLI启动横幅技能Skill ascii-cli-logo-banner

---

名称: ascii-cli-logo-banner 描述: ASCII CLI 横幅的入口点。根据需要选择 Python 内置字体技能或 figlet.js/FIGfont 技能。 许可证: 完整条款在 LICENSE.txt 文件中

何时使用此技能

关键触发规则

• 仅当用户明确提及确切的技能名称：ascii-cli-logo-banner 时，才使用此技能。

当用户说他们想要时使用此技能：

• CLI 或服务的启动横幅 / 徽标 / 欢迎屏幕

触发短语包括：

• “ascii-cli-logo-banner”
• “use ascii-cli-logo-banner”
• “用 ascii-cli-logo-banner”
• “使用 ascii-cli-logo-banner 生成启动 Banner”
• “用 ascii-cli-logo-banner 做一个 ASCII Logo”

边界

• 此技能是一个路由/选择入口点。它不提供自己的生成器实现。
• 对于内置（无外部字体引擎）：使用 ascii-cli-logo-banner-python。
• 对于 TAAG/FIGlet 样式（FIGfont 规范，合并布局）：使用 ascii-cli-logo-banner-figletjs。

如何使用此技能

输入（推荐）

• brandName（必需）
• version（可选）
• author（可选）
• repoUrl / docsUrl（可选）
• width（默认 80）
• slogan（可选，徽标下方的居中行）
• hint（可选，口号下方的居中行）
• glyph（ascii | block，默认 ascii）
• center（默认 true）
• rule（默认 true；设置为 false 仅输出徽标英雄模式）
• style（block | outline | thin，默认 block）
• colorMode（none | ansi256，默认 none；仅在脚本中上色徽标）
• includeCta（默认 true）

输出（必需）

• bannerPlain：仅 ASCII 的完整横幅（徽标区域 + 信息块 + 水平规则）
• compactPlain：用于 width < 60 的紧凑横幅（单行标题 + 规则 + 1-2 行信息）
• plainTextFallback：当 ANSI 启用时的无色回退（结构与 bannerPlain 相同）
• embedNotes：3-5 个嵌入注释（CLI 启动 / 服务启动 / README / 票据）

步骤

1. 决定宽度和回退：
   • 默认 width=80
   • 如果 width < 60，输出 compactPlain 并跳过大字徽标
2. 生成仅 ASCII 的徽标：
   • 避免全角字符和宽度模糊的 Unicode
   • 确保每行 <= width
3. 组合横幅结构（推荐顺序）：
   • 徽标区域（或紧凑模式下的单行标题）
   • 水平规则：恰好 width 个字符（- 或 =）
   • 信息块：名称 / 版本 / 仓库 / 文档 / 作者（仅包括提供的字段）
   • 可选 CTA：例如 运行：<command> 或 文档：<url>
4. 可选 ANSI 上色（不得破坏对齐）：
   • 仅对可见字符上色；不对空格上色
   • 始终提供 plainTextFallback

脚本（可选）

• 使用 ascii-cli-logo-banner-python 获取 Python 实现。
• 使用 ascii-cli-logo-banner-figletjs 获取 figlet.js/FIGfont 实现。

示例

• 在两个实现技能中查看示例：
  • ascii-cli-logo-banner-python/examples/*
  • ascii-cli-logo-banner-figletjs/examples/*

质量检查清单

1. 在 80 列时不换行或错位；无尾随空格
2. 可以干净地复制粘贴到日志/邮件/票据中
3. 从不打印秘密（令牌、内部 URL、个人数据）

关键词

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