搜索你想找的开源项目

输入名称、用途或关键词,也可粘贴 GitHub 仓库链接

分享到微信

当前解读页的微信分享二维码

用微信扫一扫打开,点击右上角「···」分享给朋友或朋友圈。

手机上可截屏后,在微信扫一扫中从相册识别二维码。

pritamux/gridlines

开发工具

让编程 Agent 测量界面边缘、找出偏离参考线并修正 padding 的对齐技能。

这是一个 Agent 技能包 · 1 个技能看技能清单和安装方法 →
101
1
JavaScript
MIT
今天创建

项目介绍

gridlines 是给编程 Agent 用的界面调校技能。它会根据文字、图标和控件实际渲染出的边缘推断参考线,再处理侧边栏、工具栏、面板、菜单或表格这类界面,找出边缘没有落在参考线上的项目,报告期望值与实际偏差,并调整 padding,让各部件共用少量对齐边。

仓库包含三部分:描述流程和规则的 skills/gridlines/SKILL.md、在页面里运行并绘制参考线的 probe.js,以及用无头 Chromium 载入页面、导出带参考线的 2 倍截图和 JSON 报告的 audit.mjs。examples/sidebar.html 预置了四个偏离项,方便在接入自己的应用前先看报告长什么样。

快速使用

用 skills 命令安装技能:

npx skills add pritamux/gridlines

也可以把 skills/gridlines/ 复制进 Agent 的技能目录(Claude Code 为 ~/.claude/skills/gridlines/)README 安装说明。装好后直接让 Agent 做一次对齐,或调用:

/gridlines line up the settings sidebar

要在自己的页面上跑审查脚本,先在任意临时目录安装 Playwright,并把 PW_DIR 指向该目录 probe 使用示例:

npm i --prefix /tmp/gridlines-pw playwright
npx --prefix /tmp/gridlines-pw playwright install chromium
PW_DIR=/tmp/gridlines-pw node skills/gridlines/audit.mjs "file://$PWD/examples/sidebar.html" .gridlines 800

最后两个参数分别是输出目录和视口宽度。命令会写出截图和 JSON 报告,报告逐条列出类似 MISS y56 trailing: 15px vs 12px [12] 的偏差,给出所在行、实测边缘和目标线。不想用脚本时,也可以把 probe.js 贴进任意页面的控制台,调用 window.__gridlines()。

使用约束

  • 审查脚本依赖 Playwright 和已安装的 Chromium;probe 本身运行在页面内,可通过控制台单独使用。
  • 规则关注界面框架(侧边栏、工具栏、面板、菜单、表格等)的垂直边缘和 padding,不是通用布局引擎。
  • 项目以 Agent 指令加脚本的形式分发,Agent 需要支持技能安装,或允许手动复制到技能目录。
  • 对齐规则参考 Karri Saarinen 对 Linear 侧边栏的重绘笔记,以及 Apple 人机界面指南的布局章节 README;项目采用 MIT 许可证。

HotRepo 点评

该项目在 2026-11-22 的 JavaScript 新项目榜上被记录到约 15 小时窗口内新增 100 Star,从创建到快照仅有一条记录,这只能说明初始关注度,不足以判断热度趋势。交付物是一套紧凑、可复用的技能,带 probe、无头审查路径和可复现的示例,使对齐规则可以被实际检查,而不只是口头建议。

本文由 AI 根据项目公开资料和 HotRepo 的记录撰写,更新于 ,以项目官方文档为准。

相关推荐

  1. react/react一个用组件描述状态的 JavaScript UI 库,前端团队在选择渲染层时绕不开的默认选项。JavaScript251,745
  2. nolly-studio/cult-ui面向 React 与 Next.js 开发者的开源动画组件库,提供 150+ 个 shadcn/ui 组件。TypeScript7,439
  3. sveltejs/svelte把声明式 Web 组件编译成高效 JavaScript、精确更新 DOM 的编译器。JavaScript88,514
  4. plugin87/ux-ui-agent-skills给编程 Agent 一套设计系统教义和 52 道可执行的检查门,让生成的 UI 在构建阶段失败,而不是交付成网页垃圾。JavaScript2,971
  5. figma/mcp-server-guide把 Figma 设计文件接入 AI 编程代理,让它按设计稿生成代码并回写画布。Python2,169