mcpField
A
ascii-mini-charts

ascii-mini-charts

github.com/full-stack-skills数据与数据库580 次安装4 周前更新
代码仓库

关于 ascii-mini-charts

根据数值序列生成小型 ASCII 图表的技能,支持火花线、柱状图和折线图。仅用于可视化,且只有在明确提及技能全名时才会触发。

主要功能

  1. 01生成火花线、柱状图和折线图
  2. 02支持线性或对数归一化
  3. 03输出简版和标注版图表
  4. 04提供尺度说明与压缩建议

适用场景

  1. 01将短数值序列显示为火花线
  2. 02用紧凑柱状图比较数值
  3. 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.txt
agents/
openai.yaml
examples/
sparkline.md
scripts/
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

质量检查清单

  1. 趋势清晰;标签简短且不过度使用
  2. 仅含 ASCII 字符的输出可干净地复制粘贴
  3. 为较长的序列提供压缩策略

关键词

英文: ascii-mini-charts, sparkline, ascii chart, bar chart, line chart, trend, normalize 中文: ascii-mini-charts, 火花线, ASCII 图表, 柱状图, 折线图, 趋势, 归一化

常见陷阱(Gotchas)

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

使用流程

步骤 1:环境准备

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

步骤 2:配置初始化

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

步骤 3:使用核心功能

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

步骤 4:测试验证

运行测试确保功能正常。

步骤 5:部署上线

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

评论

支持 Markdown