关于 ascii-ansi-colorizer
ascii-ansi-colorizer 是一项按需触发的技能,为现有文本添加 ANSI 色彩,适合需要制作终端彩色文字且保留对齐的场景。它同时提供纯文本回退,不负责生成 ASCII 图案。
主要功能
- 01为可见字符添加 ANSI 色彩
- 02支持彩虹、渐变和品牌色
- 03可设置方向、色深和作用范围
- 04提供纯文本回退与兼容提示
适用场景
- 01为现有 ASCII 标志添加渐变色
- 02制作带 ANSI 色彩的终端文字
- 03需要保留空格对齐的彩色输出
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ full-stack-skills/ ascii-skills --skill ascii-ansi-colorizer安装后在 Claude Code 中输入/ascii-ansi-colorizer确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
LICENSE.txtagents/openai.yamlexamples/gradient.mdscripts/colorize.py详细介绍
何时使用此技能
关键触发规则
- 仅当用户明确提及确切的技能名称
ascii-ansi-colorizer时,才使用此技能。
触发短语包括:
- "ascii-ansi-colorizer"
- "use ascii-ansi-colorizer"
- "用 ascii-ansi-colorizer 给 ASCII 上色"
- "使用 ascii-ansi-colorizer 做 ANSI 渐变/彩虹"
边界
- 此技能仅为现有文本添加颜色,不会生成 ASCII 艺术本身(如有需要,可搭配
ascii-cli-logo-banner使用)。 - 必需输出:
coloredText+plainTextFallback。 - ANSI 颜色不得破坏对齐:默认不为空格上色;仅为可见字符上色。
如何使用此技能
输入
- textOrAscii(必填)
- palette(rainbow | gradient | brandColors)
- direction(leftToRight | topToBottom,默认 leftToRight)
- colorDepth(ansi16 | ansi256 | truecolor,默认 ansi256)
- scope(logoOnly | highlightsOnly | fullText,默认 logoOnly)
输出(必需)
- coloredText:带 ANSI 颜色的输出
- plainTextFallback:无颜色的回退版本(内容相同,不含 ANSI)
- compatNotes:复制粘贴和重定向指南(建议使用 NO_COLOR / --no-color)
步骤
- 选择
colorDepth(默认值:ansi256)。 - 选择稳定的上色策略:
- 按列渐变(leftToRight)通常最安全
- 仅为非空格字符上色
- 同时输出
coloredText和plainTextFallback。 - 提供无颜色使用建议:
NO_COLOR/--no-color。
脚本
scripts/colorize.py:对标准输入应用 ANSI 256 色渐变或彩虹效果
示例
examples/gradient.md
质量检查清单
- 移除 ANSI 后,内容仍清晰可读(
plainTextFallback)。 - 上色后,对齐方式保持不变。
- 颜色不应盖过信息内容。
关键词
英语: ascii-ansi-colorizer, ansi, color, gradient, rainbow, terminal, no-color, plain text, ascii 中文: ascii-ansi-colorizer, ANSI, 上色, 渐变, 彩虹, 终端, 无色回退, 纯文本, ASCII
常见陷阱 (Gotchas)
- 版本兼容性:注意框架版本与依赖库的兼容性,不同版本 API 可能有差异
- 配置文件格式:配置文件格式错误是最常见的问题,建议使用编辑器的语法检查
- 环境变量:确保所有必要的环境变量已正确设置,敏感信息不要硬编码
- 依赖冲突:多版本共存时注意依赖冲突,使用 lock 文件锁定版本
- 性能陷阱:大数据量场景下注意性能优化,避免 N+1 查询等常见问题
使用流程
步骤 1:环境准备
确保开发环境已安装必要的依赖和工具。
步骤 2:配置初始化
根据项目需求进行基础配置。
步骤 3:核心功能使用
按照示例代码实现核心功能。
步骤 4:测试验证
运行测试确保功能正常。
步骤 5:部署上线
完成开发后进行部署和监控。
评论
支持 Markdown