1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | lieflat-charts |
| 作者/维护者 | lieflat（GitHub 个人开发者） |
| 来源链接 | https://github.com/larashero3-dotcom/lieflat-charts |
| 许可证 | PolyForm Noncommercial License 1.0.0（读取仓库 LICENSE 文件确认） |
| GitHub Stars | 341（GitHub API 获取） |
| Forks | 30（GitHub API 获取） |
| 最新版本 | 无正式 Release/Tag，滚动更新，最近一次提交 2026-07-24（GitHub API 获取） |
| 安装方式 | npx skills add 一条命令，或克隆到技能目录 |
2. 功能介绍与亮点
lieflat-charts 是一套模板驱动的单色数据可视化 skill，把数据图表做成“有编辑感、能阅读”的视觉内容，而非图表库默认样式。内置四个视觉风格家族：Lupi 编辑叙事型（15 种模板，细线、点阵、大量留白，适合论文/年报/长文数据故事）、Glance 快速判断型（18 种模板，粗柱、大数字，几秒看懂结论，适合周报/看板）、Basics 基础编辑型（12 种模板，柱状/折线/环形图的编辑感升级版）、以及独立的 Interactive 交互大图（网络图、路径图、多段流向图）。
核心亮点：
- 模板优先硬约束：SKILL.md 规定必须复用仓库真实 gallery 文件的完整代码骨架，禁止臆造“看起来差不多”的图或拼接混合图型。
- 默认选型顺序固定：优先比较 Lupi Editorial 与 Lupi Basics，只有都不适配、或用户明确要求“三秒快读”时才降级用 Glance。
- 统一视觉语法：色板、字体、圆角、动画参数全部从
mono-tokens.js取值，保证每张图“一眼一家人”。 - 零构建交付：产出无需构建、双击可打开的单文件 HTML，改数据只需改顶部一个数组；纯 SVG 模板可完全离线运行。
3. 适用场景
固定分类：数据分析与可视化。
SKILL.md 明确将目标用户定义为“非程序员”——写作者、新媒体运营、做 PPT 汇报的人。用户只需要说人话（“帮我把这季度转化画一下，发公众号用”），不必懂图表类型术语，技能负责把口语需求翻译成正确的图。具体场景包括：公众号/长文配图、周报与日报数据看板、论文与年报的数据故事叙述，以及任何需要“编辑质感”而非默认 AI 生成图表风格的场合。
4. 跨 Agent 兼容性
- Claude Code：✅ 原生支持，README 给出
~/.claude/skills/安装路径。 - Codex：✅ 官方支持，README 给出
~/.codex/skills/专属安装路径，仓库另附agents/openai.yaml配置文件（含 display_name、default_prompt），是比纯文字声明更具体的适配证据。 - OpenClaw：❓ 未验证，已抓取材料未提及。
- Hermes Agent：❓ 未验证，已抓取材料未提及。
（结论均基于已抓取的 README 与 SKILL.md，未为兼容性单独发起搜索。）
5. 推荐理由
面向非技术用户、开箱即用的图表生成技能——双击即得成品 HTML，不需要用户或 agent 懂设计理论或图表库 API，产出效果具备统一编辑感，明显区别于默认花哨的 AI 生成图表。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 6 | 341 stars/30 forks，仓库创建约两周内快速积累；已有非作者本人的外部贡献者提出模板扩展建议并提交文档修复，均被采纳/合并，但尚未发现 GitHub 之外的独立第三方讨论 |
| 可用性 | 8 | 一条命令安装（npx skills add）；README/SKILL.md/catalog/示例/第三方依赖说明文档齐备；近日仍有提交维护；默认 Lupi/Basics 模板纯 SVG 可离线运行、无需 API Key；许可证限定非商业用途，是使用前需确认的前提条件 |
| 安全性 | 9 | 纯模板/内容生成类技能，不执行 shell 命令；唯一联网行为是 Glance 等模板可选加载 jsDelivr 上的 Chart.js/ECharts 与 Google Fonts 等公开 CDN 静态资源，不外发任何用户数据；License 条款明确，并附完整第三方依赖清单 |
安全检查清单：① 无 shell 命令执行，技能仅生成 HTML 文本文件 ② 不外发用户数据，仅按需加载公开 CDN 静态资源（图表库/字体） ③ 不要求任何 API Key 或凭据 ④ SKILL.md 与配套脚本未发现可疑指令（仓库自带的 validate.mjs 是面向维护者的本地文件完整性/语法自检工具，不在 SKILL.md 指示的用户运行流程中） ⑤ 作者为个人开发者，无造假迹象 ⑥ License 条款明确（PolyForm Noncommercial 1.0.0）。
7. 跟同类 Skills 相比的优势
| 对比对象 | 定位 | 与 lieflat-charts 的差异 |
|---|---|---|
| tufte-claude-skill | 把 Tufte 图表设计十原则蒸馏为规则，agent 据此为 Recharts/D3 等图表库现写代码 | 原则驱动、面向已会用图表库的技术用户；lieflat-charts 是模板驱动，直接复用成品代码，不要求用户或 agent 理解图表库 API |
| tufte-data-viz | 22 条只读规则集，覆盖 Recharts/ECharts/Chart.js/matplotlib/Plotly/D3 六种图表库的统一风格改造 | 纯规则、不含任何成品模板，面向团队跨技术栈统一图表风格；lieflat-charts 反过来提供 40+ 张可直接复用的成品视觉模板，产出双击即开的单文件，目标用户明确是非程序员 |
三者取向相近，但路径不同：前两者教 agent“怎么按原则画”，lieflat-charts 直接给“已经画好、只需换数据”的成品，对不懂图表设计或代码的用户更友好。
8. 用户评价
目前可查证的具名第三方互动来自 GitHub 用户 SilasSolivagus：先提出一项模板扩展建议（新增一种适配长类目名的柱状图样式），随后提交了一份 SKILL.md 文档修复 PR，两者均已被作者采纳/合并。这是本技能除仓库自身之外唯一可验证的具名用户互动记录；尚未发现其他平台上的具名用户评价。
9. 安装使用方式
一条命令安装：
npx skills add https://github.com/larashero3-dotcom/lieflat-charts --skill lieflat-charts也可让有 shell 权限的 Agent 直接克隆仓库到 ~/.claude/skills/lieflat-charts（Codex 换成 ~/.codex/skills/lieflat-charts），完成后确认 SKILL.md、templates/、catalog.md、mono-tokens.js 均存在。更新时进入安装目录执行 git pull 即可，无需重启。安装后直接用自然语言描述场景（如“把周报数据做成 10 秒看懂的图表”），技能会自动选型并产出单文件 HTML。
10. 注意事项
- 许可证为 PolyForm Noncommercial 1.0.0，仅授权非商业用途；如需商业化使用需另行获得作者授权。
- Glance 家族及部分使用在线字体的模板，在未内联依赖时需要联网访问 jsDelivr、Google Fonts 等公开 CDN；纯离线环境应优先选用 Lupi/Basics 家族（纯 SVG，可完全离线运行）。
- 仓库未打正式版本号/Release 标签，采用滚动更新，无法通过语义化版本判断每次变更的兼容性影响。
- OpenClaw、Hermes Agent 的兼容性尚未验证，若在这两个生态使用需自行测试。