mcpField
A
ascii-cli-logo-banner

ascii-cli-logo-banner

github.com/partme-ai创意与媒体71665 次安装3 周前更新
代码仓库

关于 ascii-cli-logo-banner

用于按名称明确调用 CLI 或服务启动横幅任务的路由技能。它不负责生成横幅,而是根据字体需求指向 Python 或 FIGlet.js 实现技能。

主要功能

  1. 01将需求路由至 Python 或 FIGlet.js 技能
  2. 02定义横幅输入与输出格式
  3. 03规定不足 60 列时的紧凑布局
  4. 04说明 ASCII 与 ANSI 回退规则

适用场景

  1. 01为 CLI 启动横幅选择实现方式
  2. 02整理服务启动横幅的需求

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/partme-ai/full-stack-skills --skill ascii-cli-logo-banner

安装后在 Claude Code 中输入/ascii-cli-logo-banner确认已加载。

包含的文件

除 SKILL.md 外,安装时一起下载的参考资料和脚本。

LICENSE.txt
examples/
banner-80.md
banner-compact.md

详细介绍

何时使用此技能

关键触发规则

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

用户表示想要以下内容时使用此技能:

  • 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"

边界

  • 此技能是路由/选择入口,不提供自己的生成器实现。
  • 对于内置字体(无需外部字体引擎):使用 ascii-cli-logo-banner-python。
  • 对于 TAAG/FIGlet 样式(FIGfont 规范、压缩布局):使用 ascii-cli-logo-banner-figletjs。

如何使用此技能

输入(推荐)
  • brandName(必填)
  • version(可选)
  • author(可选)
  • repoUrl / docsUrl(可选)
  • width(默认值为 80)
  • slogan(可选,置于 Logo 下方并居中的一行)
  • hint(可选,置于 slogan 下方并居中的一行)
  • glyph(ascii | block,默认值为 ascii)
  • center(默认值为 true)
  • rule(默认值为 true;设为 false 可仅输出 Logo 主视觉)
  • style(block | outline | thin,默认值为 block)
  • colorMode(none | ansi256,默认值为 none;仅在脚本中为 Logo 上色)
  • includeCta(默认值为 true)
输出(必填)
  • bannerPlain:仅含 ASCII 字符的完整横幅(Logo 区域 + 信息块 + 水平分隔线)
  • compactPlain:适用于 width < 60 的紧凑横幅(单行标题 + 分隔线 + 1–2 行信息)
  • plainTextFallback:启用 ANSI 时的无颜色回退版本(结构与 bannerPlain 相同)
  • embedNotes:3–5 条嵌入说明(CLI 启动/服务启动/README/工单)
步骤
  1. 确定宽度和回退方式:
    • 默认 width=80
    • 如果 width < 60,输出 compactPlain 并跳过大字母 Logo
  2. 生成仅含 ASCII 字符的 Logo:
    • 避免全角字符和宽度不明确的 Unicode 字符
    • 确保每一行不超过 width
  3. 组合横幅结构(推荐顺序):
    • Logo 区域(或紧凑模式下的单行标题)
    • 水平分隔线:恰好包含 width 个字符(- 或 =)
    • 信息块:名称/版本/仓库/文档/作者(仅包含已提供的字段)
    • 可选 CTA:例如 Run: <command> 或 Docs: <url>
  4. 可选的 ANSI 上色(不得破坏对齐):
    • 仅为可见字符上色;空格不着色
    • 始终提供 plainTextFallback
路由决策
需求使用的技能原因
简单的内置字体,无 npm/node 依赖ascii-cli-logo-banner-python使用内置 5x5 字体,仅需 Python
TAAG/FIGlet 字体、布局压缩ascii-cli-logo-banner-figletjs通过 figlet.js 支持完整 FIGfont 规范

示例:如果要快速生成启动横幅,brandName="MyApp" 且无需外部字体引擎,则路由到 ascii-cli-logo-banner-python。如果要使用 FIGlet“Standard”或“Big”字体生成带水平压缩效果的横幅,则路由到 ascii-cli-logo-banner-figletjs。

脚本(可选)

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

示例

  • 请参阅两个实现技能中的示例:
    • ascii-cli-logo-banner-python/examples/*
    • ascii-cli-logo-banner-figletjs/examples/*

质量检查清单

  1. 在 80 列宽度下不会换行或错位;没有尾随空格
  2. 可直接复制到日志/电子邮件/工单中
  3. 绝不输出机密信息(令牌、内部 URL、个人数据)

关键词

英文: ascii、banner、logo、cli、终端、启动、欢迎、纯文本、ansi、无颜色 中文: ASCII、启动横幅、终端 Banner、CLI Logo、欢迎页、纯文本、ANSI 上色、无色回退

评论

支持 Markdown