Agent Skills
› nubjs/nub
nubjs/nub
GitHub在本地 Linux VM（Lima/Tart）中运行 Nub 测试与调试探针，用于复现 Docker 无法模拟的内核或发行版行为。支持持久化环境调试和干净镜像验证。
Install All Skills
npx skills add nubjs/nub --all -g -y
Skills in Collection (41)
在本地 Linux VM（Lima/Tart）中运行 Nub 测试与调试探针，用于复现 Docker 无法模拟的内核或发行版行为。支持持久化环境调试和干净镜像验证。
需要真实 Linux 内核环境进行测试
Docker 无法准确复现的架构或发行版问题
需要追踪系统调用或进行内核级调试
npx skills add nubjs/nub --skill linux-vm-test -g -y
用于在本地Windows ARM64 QEMU虚拟机中运行Nub测试和调试探针，执行预检、生命周期管理及通过SSH传输执行脚本。
需要在本地Windows ARM64环境下进行原生或模拟测试
需要向远程VM传输二进制文件并执行调试探针
npx skills add nubjs/nub --skill windows-vm-test -g -y
用于执行兼容性审计，枚举目标与参考实现的差异。通过严格流程确保结果准确无误，消除误报。
audit
compat audit
parity audit
find all the gaps
what are we missing vs <tool>
npx skills add nubjs/nub --skill audit-thread -g -y
用于抓取并聚合 npm 与 GitHub 发布包的下载数据，生成 CSV 报表及可视化图表。支持按周、月、日维度统计，处理数据滞后、缺口及资产膨胀等陷阱，适用于监控软件分发渠道的采用率和安装量。
检查或导出下载数量
查看安装计数或采用率统计
生成发布包的分发渠道数据图表
npx skills add nubjs/nub --skill download-stats -g -y
提供Git历史考古查询的速查手册，通过Pickaxe、文件删除追踪、重命名跟随及行级变更等命令，快速定位代码或配置项的引入、移除及修改时间与责任人。
查询特定代码或字符串是何时添加或移除的
追踪文件删除或重命名的历史记录
查找某行代码的具体变更者和时间
npx skills add nubjs/nub --skill git-archaeology -g -y
提供基于 Lima 和 Tart 的本地 Linux VM 测试与调试能力，用于复现 Docker 无法模拟的内核、发行版及架构行为。支持持久化环境下的源码同步调试与临时环境的干净镜像验证。
需要测试特定 Linux 内核或发行版行为
Docker 无法准确模拟的目标环境
需要在真实 VM 中进行系统级调试
npx skills add nubjs/nub --skill linux-vm-test -g -y
用于高效导航大型Markdown文件。通过生成包含精确行范围的目录(TOC)，帮助定位并仅读取特定章节，避免加载整个文件，适用于长文档、架构说明及Agent任务分发场景。
需要阅读大型Markdown文件的特定章节
处理超过200行的长文档如架构说明或状态跟踪器
为子Agent准备精确的文档切片输入
npx skills add nubjs/nub --skill md-toc -g -y
用于在实施前进行协作式架构设计与方案规划。通过梳理开放问题、记录决策并锁定设计思路，为后续实现提供明确指导。适用于需求模糊或需权衡技术选型的场景。
需要协作设计功能实现方式
尚未确定具体实施方案
需要权衡多种技术选项
解决开放式设计问题
npx skills add nubjs/nub --skill plan-thread -g -y
用于追踪Nub包管理器安装等操作的耗时瓶颈。通过启用内置的阶段计时和结构化诊断工具，分析解析、拉取、链接等环节的性能数据，定位导致操作缓慢的根本原因。
包管理器操作意外变慢
需要定位性能瓶颈
分析安装或链接阶段的耗时
npx skills add nubjs/nub --skill pm-perf-tracing -g -y
用于进行事实性研究、技术调研及先验艺术调查的技能。通过系统性搜索、源码阅读和实验验证，产出长期引用的研究报告，适用于非代码类的事实确认场景。
research this
prior art
survey
find out how X works
what's the state of the art
dig into whether
npx skills add nubjs/nub --skill research-thread -g -y
管理仓库供应链冷却期，统一配置依赖发布后的等待时间以防范恶意版本。提供检查、修复各平台表面配置及外部工具排除项的功能，确保依赖安装安全。
需要调整或检查依赖发布的冷却窗口（SOAK_DAYS）
排查新发布包无法安装的问题
维护 external-tools.json 或 renovate.json 中的最小发布年龄设置
npx skills add nubjs/nub --skill soak -g -y
解析 Markdown 文件中的状态标记 TODO 行，支持按状态、章节过滤或统计数量。适用于长文件快速提取待办项，避免全量加载，提升子代理提示构建效率。
需要查看或筛选 Markdown 文件中的 TODO 项
需要统计文件中各类状态的 TODO 数量
为子代理构建仅包含特定章节或未完成任务的提示
npx skills add nubjs/nub --skill todo -g -y
规范 Nub 运行时 API 的 TypeScript 类型声明维护，涵盖所有权审计、冲突安全模式选择及编译器兼容性验证，确保类型定义与运行时行为一致。
新增或修改用户可见的全局变量、内置方法或模块加载器类型
TypeScript 或 @types/node 出现重叠声明需协调时
发布前核对运行时变更与类型声明的一致性
npx skills add nubjs/nub --skill type-declarations -g -y
在本地 Windows ARM64 QEMU VM 中运行 Nub 测试和调试探针，执行预检、生命周期管理及通过 SSH 传输执行脚本。
需要在本地 Windows ARM64 环境进行原生或仿真测试
需要调试 win32-arm64 或模拟的 x64 行为
npx skills add nubjs/nub --skill windows-vm-test -g -y
指导使用nub替代Node生态工具链，统一执行JS/TS、运行脚本、安装依赖及版本管理。
需要运行或调试JavaScript/TypeScript文件
需要安装、添加或删除项目依赖包
需要执行package.json中的脚本
需要运行本地CLI工具
npx skills add nubjs/nub --skill nub -g -y
提供AI代理的浏览器自动化CLI工具，支持网页交互、表单填写、截图及数据提取。扩展支持Electron应用、Slack自动化及云环境运行，适用于QA测试、探索性验证和Web应用质量审查。
需要与网站进行程序化交互
执行网页测试或QA任务
自动化Electron桌面应用操作
从页面抓取数据或填写表单
npx skills add nubjs/nub --skill agent-browser -g -y
指导通过构建开发二进制并针对真实临时夹具执行端到端验证，涵盖确认功能正常与对抗性破坏测试两个方向，确保实际行为正确。
实现新功能后验证端到端工作
PR前进行破坏性扫描
审查前自我复核
npx skills add nubjs/nub --skill ad-hoc-test -g -y
提供 GitHub Issue 端到端处理流程，涵盖复现、定级、修复及 PR 提交流程。确保维护规范，按实际规模执行修复，默认自行解决小问题，避免过度工程化，闭环通知报告者。
需要修复报告的 Bug
被指派处理 GitHub Issue
确认 Issue 为无效或重复项需关闭
npx skills add nubjs/nub --skill address-issue -g -y
面向AI代理的浏览器自动化CLI工具，支持网页交互、表单填写、截图、数据提取及Electron应用和Slack自动化。
需要与网站进行程序化交互
执行网页测试或QA
自动化桌面应用操作
抓取页面数据
npx skills add nubjs/nub --skill agent-browser -g -y
将上游 aube 引擎版本合并至 vendor 目录。通过构建临时合并基址，利用 git 文本冲突与 cargo 语义冲突双重检测机制，自动化解决依赖更新中的代码冲突，确保合并正确性。
需要升级 vendored aube 引擎版本
拉取上游 jdx/aube 的新发布或提交
npx skills add nubjs/nub --skill aube-bump -g -y
将jdx/aube上游更新同步至nub的vendor目录。利用nub-fork作为合并场所进行三方合并，保留本地修改并解决冲突，确保vendor与fork树一致，避免直接覆盖导致的冲突。
需要引入新的aube上游版本
需要拉取jdx/aube的特定提交到nub
npx skills add nubjs/nub --skill aube-sync -g -y
在 CI 中针对 macOS/Windows 等真实平台运行临时测试，解决 Docker 无法覆盖的环境差异问题。无需 PR，通过分支推送触发 GitHub Actions 进行跨平台验证和故障排查。
需要在 macOS 或 Windows CI 上测试特定行为
探测跨操作系统或平台的兼容性
执行需要真实 OS 环境的临时检查
npx skills add nubjs/nub --skill ci-adhoc-test -g -y
通过查询 GitHub Commit 的 Check-runs 而非 Run 结论，准确诊断 CI 失败状态。解决因并发取消导致的漏报问题，提供标准化的排查命令与分页陷阱规避指南。
检查分支或提交是否通过 CI
报告 CI 失败需要定位原因
发布前确认构建状态
npx skills add nubjs/nub --skill ci-triage -g -y
解决 GitHub CLI 原生监控工具在 CI 排队或瞬态错误时误报的问题。通过脚本轮询权威状态，确保等待至任务真正结束并返回可信退出码，支持失败快速响应和幽灵检查容错。
需要等待 GitHub Actions CI 结果
PR 合并前验证 CI 状态
标签发布后确认构建成功
npx skills add nubjs/nub --skill ci-watch -g -y
诊断并清理开发主机上的 CPU、内存和磁盘争用。处理卡住的 Rust 构建、孤立的 Node 测试进程及负载生成器，通过测量症状后执行安全清理，释放系统资源。
机器运行缓慢或负载过高
Rust 构建因目标锁挂起
磁盘空间不足
怀疑存在孤立进程
npx skills add nubjs/nub --skill cpu-reduction -g -y
指导本地快速编译 Rust 项目 nub，通过共享缓存和 worktree 隔离实现 ~5s 增量构建。涵盖 dev 二进制、N-API 插件及 macOS 原生测试，明确冷构建与全量测试应走 CI 或远程。
需要快速迭代编译代码时
设置工作树以并行开发时
运行单文件/单个测试时
npx skills add nubjs/nub --skill dev-loop -g -y
用于在Mac开发机上释放磁盘空间，清理Rust构建残留。涵盖工作树私有target目录和孤立共享缓存桶的清理，强调使用df而非du评估回收量，并提供安全保留机制以防止误删活跃构建或二进制文件。
磁盘空间不足或ENOSPC错误
需要手动清理Rust构建残留
自动化GC未覆盖的残留清理
npx skills add nubjs/nub --skill disk-reduction -g -y
一种通过动态任务队列实现长周期串行自动化工作的技能，适用于多阶段史诗级任务或跨平台调试，由智能体自主重写任务列表并持续执行直至完成。
需要长时间运行的串行循环处理大型任务集
设置自主工作循环、心跳机制或停止钩子
执行 corpus sweep 或多阶段史诗级项目
npx skills add nubjs/nub --skill dynamic-churn -g -y
用于管理跨多个上下文窗口的长期自主任务，防止目标漂移。通过维护CANON、草稿和任务列表三个持久化工件，确保长时间无人监督的执行不偏离初衷。
收到长期使命而非具体任务
工作流超出单次上下文限制
npx skills add nubjs/nub --skill epic -g -y
用于代码审查的冲击分析技能，通过追踪变更符号的调用链和依赖关系，评估修改对全局的影响范围，防止因局部正确但破坏远距离调用者导致的隐性故障。
请求追踪变更影响或爆炸半径
询问变更会破坏哪些部分
查找谁调用了特定函数
npx skills add nubjs/nub --skill impact-analysis -g -y
端到端执行单一任务的完整工程流程，涵盖需求澄清、设计、实现、多视角审查及PR提交。适用于涉及模块边界或公共接口的大改动，强调单代理所有权与人工决策暂停。
用户输入 implementation-thread
请求驱动任务直至生成待合并的PR
npx skills add nubjs/nub --skill implementation-thread -g -y
管理nub知识库图谱，支持搜索、读取和维护wiki内容。通过lat CLI进行索引、检查和引用验证，确保架构变更后的文档一致性，作为CI门禁防止过时链接。
设计或修改非平凡功能前查询决策依据
架构或行为变更后验证文档完整性
npx skills add nubjs/nub --skill lat-md -g -y
用于生成 nubjs.com 性能对比 SVG 图表，遵循特定视觉规范与排版规则，适用于博客、文档及社交媒体的基准测试结果展示。
需要生成性能基准测试的可视化图表
为博客或文档页面添加带有测量数据的图形
使用新数据重新生成现有图表
npx skills add nubjs/nub --skill nub-charts -g -y
用于在新操作系统（Windows/Linux）上调试和启动测试探针，提供分步排查阶梯及常见系统陷阱修复方案。
新平台探针首次运行失败
跨平台兼容性调试
npx skills add nubjs/nub --skill probe-platforms -g -y
提供面向用户文本的写作风格指南，规范 GitHub 交互、文档及营销文案的语气与格式，确保内容事实准确、简洁易读。
撰写或编辑任何面向用户的文本
生成 GitHub Issue/PR 评论
编写文档、博客或营销文案
npx skills add nubjs/nub --skill prose-writing -g -y
用于端到端执行 Nub 项目补丁版本发布，涵盖版本审计、构建测试、npm OIDC 发布及发布说明撰写。
需要发布新的 Nub 软件版本
执行标准化的发布流程
npx skills add nubjs/nub --skill release -g -y
将 Rust 构建、Clippy 检查和测试套件分发至 GCP 临时 VM 执行，以减轻本地 Mac CPU 负载。默认用于冷构建和全量测试，保留本地仅用于快速增量循环。支持分离模式与多实例并行。
需要运行重型 Rust 构建或测试时
用户要求不占用本地机器资源时
执行 cargo clippy 全目标检查时
npx skills add nubjs/nub --skill remote-build -g -y
提供Rust构建的最佳实践，防止因后台进程隔离导致的资源泄露。核心规则是禁止使用setsid等脱离父进程的方式启动构建，确保构建随会话结束而清理，避免目标目录锁死和CPU过载。
启动cargo build或test命令前
设置后台构建或子代理等待时
解决构建残留或锁定问题
npx skills add nubjs/nub --skill rust-build-hygiene -g -y
Rust工作树构建辅助脚本，解决多工作树共享target目录时的缓存复用与编译污染问题。自动隔离冲突依赖，提供QoS限流、并行度控制及增量构建优化，兼容直接cargo调用。
需要构建或测试Rust工作树代码时
遇到因共享target目录导致的编译错误（如字段缺失）
需要设置CARGO_TARGET_DIR进行隔离构建时
npx skills add nubjs/nub --skill rust-build -g -y
通过chrome-devtools MCP计算元素遮挡、裁剪和对齐，替代肉眼截图审查。结合几何测量与视觉检查，解决z-index、溢出等深层UI布局问题，确保样式变更正确性。
需要验证UI/布局/样式变更是否正确时
怀疑存在z-index遮挡或overflow裁剪问题时
npx skills add nubjs/nub --skill visual-review -g -y
用于创建和管理隔离的Git工作树，支持并行构建、测试和代码提交。通过脚本自动化配置共享CARGO_TARGET_DIR和应用.gitignore文件，提升多任务开发效率并节省磁盘空间。
需要为当前变更创建新的隔离工作树
查询或添加.worktreeinclude配置项
清理已合并的工作树残留
npx skills add nubjs/nub --skill worktree -g -y
