用途：为已有的 ASCII 艺术或纯文本输出叠加 ANSI 颜色层，支持渐变、彩虹与高亮效果，同时保证对齐不被破坏，并强制输出一份无色回退文本。
触发条件：仅在用户明确提及技能名 ascii-ansi-colorizer 时使用，例如“use ascii-ansi-colorizer”“用 ascii-ansi-colorizer 给 ASCII 上色”。边界：本技能只给现有文本上色，不生成 ASCII 图形本身，如需生成可搭配 ascii-cli-logo-banner。
主要能力与输入：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）通常最安全；默认只给非空格可见字符上色，避免破坏对齐；同时输出彩色与无色两份文本；给出无色语义建议 NO_COLOR / --no-color。附带脚本 scripts/colorize.py 可对 stdin 应用 ANSI 256 渐变或彩虹，示例见 examples/gradient.md。
质量检查：移除 ANSI 后内容仍可读且一致；上色后对齐不变；颜色不应压过信息行。
限制与注意事项：资料未提供具体安装命令、版本要求、收费与平台信息；常见陷阱包括框架与依赖版本兼容性、配置文件格式错误、环境变量未正确设置、多版本依赖冲突、大数据量下的性能问题。