关于 ascii-mini-charts
根据数值序列生成小型 ASCII 图表的技能,支持火花线、柱状图和折线图。仅用于可视化,且只有在明确提及技能全名时才会触发。
主要功能
- 01生成火花线、柱状图和折线图
- 02支持线性或对数归一化
- 03输出简版和标注版图表
- 04提供尺度说明与压缩建议
适用场景
- 01将短数值序列显示为火花线
- 02用紧凑柱状图比较数值
- 03通过 ASCII 折线图展示趋势
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ full-stack-skills/ ascii-skills --skill ascii-mini-charts安装后在 Claude Code 中输入/ascii-mini-charts确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
LICENSE.txtagents/openai.yamlexamples/sparkline.mdscripts/mini_charts.py详细介绍
使用此技能的时机
关键触发规则
- 仅当用户明确提及确切的技能名称
ascii-mini-charts时,才使用此技能。
触发短语包括:
- "ascii-mini-charts"
- "use ascii-mini-charts"
- "用 ascii-mini-charts 生成 sparkline / 火花线"
- "使用 ascii-mini-charts 标注 min/max/current"
边界
- 不进行统计推断。仅进行可视化。
- 默认输出仅包含 ASCII 字符。可选用 Unicode 块字符,但必须同时提供仅含 ASCII 字符的备用版本。
- 默认输出宽度应保持在 60 列以内。对于更长的序列,需提供压缩策略(采样/分桶)。
如何使用此技能
输入
- series(必需的数值列表)
- type(sparkline | bar | line,默认 sparkline)
- width(默认值为 min(len(series), 30))
- height(bar/line 的默认值为 10)
- normalize(linear | log,默认 linear)
- showLabels(默认 true)
输出(必需)
- chartMinimal
- chartAnnotated(包含 min/max/current)
- scaleNotes(归一化 + 异常值策略)
脚本
scripts/mini_charts.py:从 JSON 标准输入生成 ASCII 迷你图表
示例
examples/sparkline.md
质量检查清单
- 趋势清晰;标签简短且不过度使用
- 仅含 ASCII 字符的输出可干净地复制粘贴
- 为较长的序列提供压缩策略
关键词
英文: ascii-mini-charts, sparkline, ascii chart, bar chart, line chart, trend, normalize 中文: ascii-mini-charts, 火花线, ASCII 图表, 柱状图, 折线图, 趋势, 归一化
常见陷阱(Gotchas)
- 版本兼容性:注意框架版本与依赖库的兼容性,不同版本 API 可能有差异
- 配置文件格式:配置文件格式错误是最常见的问题,建议使用编辑器的语法检查
- 环境变量:确保所有必要的环境变量已正确设置,敏感信息不要硬编码
- 依赖冲突:多版本共存时注意依赖冲突,使用 lock 文件锁定版本
- 性能陷阱:大数据量场景下注意性能优化,避免 N+1 查询等常见问题
使用流程
步骤 1:环境准备
确保开发环境已安装必要的依赖和工具。
步骤 2:配置初始化
根据项目需求进行基础配置。
步骤 3:使用核心功能
按照示例代码实现核心功能。
步骤 4:测试验证
运行测试确保功能正常。
步骤 5:部署上线
完成开发后进行部署和监控。
评论
支持 Markdown