mcpField
A
ascii-cli-logo-banner

ascii-cli-logo-banner

github.com/full-stack-skills创意与媒体576 次安装4 周前更新
代码仓库

关于 ascii-cli-logo-banner

用于选择 ASCII CLI 横幅实现方式的路由技能。它收集横幅需求，并将请求转交给内置 Python 或 FIGlet 技能，本身不负责生成。

主要功能

  1. 01将横幅请求路由到实现技能
  2. 02收集名称、宽度、样式和可选信息
  3. 03规定完整与紧凑横幅输出
  4. 04定义纯文本回退要求

适用场景

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

安装

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

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

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

包含的文件

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

LICENSE.txt
agents/
openai.yaml
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 个字符（- 或 =）
    • 信息块：名称 / 版本 / Repo / Docs / 作者（仅包含已提供的字段）
    • 可选 CTA：例如 Run: <command> 或 Docs: <url>
  4. 可选 ANSI 上色（不得破坏对齐）：
    • 仅为可见字符上色；不要为空格上色
    • 始终提供 plainTextFallback

脚本（可选）

  • 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、横幅、Logo、cli、终端、启动、欢迎、纯文本、ansi、无颜色 中文： ASCII、启动横幅、终端 Banner、CLI Logo、欢迎页、纯文本、ANSI 上色、无色回退

常见陷阱 (Gotchas)

  1. 版本兼容性：注意框架版本与依赖库的兼容性，不同版本 API 可能有差异
  2. 配置文件格式：配置文件格式错误是最常见的问题，建议使用编辑器的语法检查
  3. 环境变量：确保所有必要的环境变量已正确设置，敏感信息不要硬编码
  4. 依赖冲突：多版本共存时注意依赖冲突，使用 lock 文件锁定版本
  5. 性能陷阱：大数据量场景下注意性能优化，避免 N+1 查询等常见问题

使用流程

步骤 1：环境准备

确保开发环境已安装必要的依赖和工具。

步骤 2：配置初始化

根据项目需求进行基础配置。

步骤 3：使用核心功能

按照示例代码实现核心功能。

步骤 4：测试验证

运行测试确保功能正常。

步骤 5：部署上线

完成开发后进行部署和监控。

评论

支持 Markdown