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 (40)
在本地 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
自动化生成nub项目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
提供在本地 Linux VM（Lima/Tart）中运行 Nub 测试和调试探针的能力，用于复现 Docker 无法模拟的内核或系统级行为。支持持久化调试与干净环境重现。
需要测试 Linux 内核或特定发行版行为
Docker 无法忠实复现的系统级差异排查
需要在真实 Linux 环境中进行调试
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
用于开展深度技术调研的 Skill，通过广泛搜索、源码分析及实证实验，产出关于特定主题的长期引用事实文档。适用于竞品分析、前沿技术调查及解决复杂非代码类问题。
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、添加临时豁免或排查新包安装失败问题，确保依赖引入的安全性。
需要调整依赖最小发布年龄窗口时
为新发布的包添加临时冷却期豁免时
排查因发布太新导致的依赖安装失败问题时
检查供应链冷却配置一致性时
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 类型声明编写，涵盖所有权审计、冲突安全模式及版本路由，确保类型与实际行为一致。
添加或更新 @nubjs/types 声明
Nub 新增用户可见全局变量或内置方法
TypeScript 或 @types/node 出现重叠声明
发布前 reconciling 运行时变更
npx skills add nubjs/nub --skill type-declarations -g -y
在本地 Windows 11 ARM64 QEMU VM 中运行 Nub 测试和调试探针，支持原生 ARM64 及 x64 模拟环境。通过 SSH 传输并执行二进制文件与脚本，进行故障排查和兼容性检查。
需要在本地 Windows ARM64 环境中执行测试或调试
需要验证 win32-arm64 原生或 win32-x64 模拟行为
npx skills add nubjs/nub --skill windows-vm-test -g -y
提供名为nub的Rust CLI工具指南，替代Node/Bun等日常开发工具链。涵盖文件执行、脚本运行、包管理、版本管理及监听模式，支持TS/JSX直跑和自动.env加载，确保代码兼容原生Node。
需要运行Node或TypeScript文件时
需要安装或添加npm包时
需要执行package.json中的脚本时
需要管理Node版本或启动watch模式时
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
通过构建开发二进制并针对真实临时夹具执行端到端验证，包含确认功能正常和 falsify 破坏性扫描两个方向。强调使用 merge-base 作为控制变量进行差异对比，以发现静默错误并评估是否将检查纳入测试套件。
实现或修改子命令/标志后验证功能
提交 PR 前进行破坏性扫描
调用代码审查前自我复核
npx skills add nubjs/nub --skill ad-hoc-test -g -y
提供 GitHub Issue 端到端处理流程，涵盖分类、复现、修复及 PR 规范。强调按问题规模采取不同策略，默认自行修复小型 Bug，确保维护规范与代码质量。
需要修复报告的 Bug
处理 GitHub 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
将 vendor/aube 引擎同步至上游最新版本。通过构建临时合并点、利用 git 文本冲突与 cargo 语义冲突双重检测机制，自动化处理依赖更新中的代码冲突，确保合并正确性并消除人工审查差异的需求。
需要更新 vendor/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 环境上测试代码
本地或 Docker 无法复现的平台相关行为问题
需要跨操作系统进行临时验证
npx skills add nubjs/nub --skill ci-adhoc-test -g -y
通过查询Commit的Check-runs诊断CI状态，避免Run结论掩盖失败。提供正确排查命令及分页陷阱处理，用于确认分支、PR或提交是否绿色并定位具体失败原因。
检查分支、PR或提交的CI状态
报告CI失败时
发布版本前
声称提交为绿色前
npx skills add nubjs/nub --skill ci-triage -g -y
解决GitHub CLI原生监控CI的早退和误报问题。通过脚本轮询权威状态，确保等待CI真正结束，支持快速失败、超时控制和幽灵检查处理，提供可信退出码供编排器使用。
需要等待GitHub Actions CI完成后执行后续操作
PR合并前需验证所有检查项是否通过
npx skills add nubjs/nub --skill ci-watch -g -y
诊断并清理开发主机上的 CPU、内存和磁盘争用。处理挂起的 Rust 构建锁、残留的 Node 测试进程及虚假负载生成器，通过测量症状定位问题，执行安全清理以恢复系统性能。
机器运行缓慢或负载高
Rust 构建因目标目录锁而挂起
磁盘空间不足
存在孤立的 Node 测试进程
需要安静的环境进行基准测试
npx skills add nubjs/nub --skill cpu-reduction -g -y
指导 nub Rust 项目的快速开发与测试流程，包括使用 fast profile 构建、worktree 隔离及共享缓存机制。
需要编译或重新构建开发二进制文件时
需要运行特定测试文件或单个测试用例时
需要了解代码库结构（如 crate map）时
npx skills add nubjs/nub --skill dev-loop -g -y
用于在Mac开发机上清理Rust构建残留以释放磁盘空间，处理工作树私有target目录及孤立共享缓存桶。
磁盘空间不足或ENOSPC错误
需要例行清理Rust构建产物
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
端到端执行单个代码变更，涵盖需求澄清、设计、实现、多视角审查及CI修复，最终提交待合并的PR。通过L1主导和L2子代理协作，确保重大变更的质量与连续性。
用户明确要求驱动任务至PR阶段
涉及跨模块或公共接口的重大代码变更
npx skills add nubjs/nub --skill implementation-thread -g -y
用于维护知识库图谱，通过lat CLI进行语义搜索、链接检查和文档更新。在设计和架构变更前查阅决策依据，变更后验证引用有效性，确保知识一致性与CI构建通过。
设计或修改非 trivial 功能前需查阅历史决策
变更架构、行为或测试覆盖后需更新文档并检查链接
npx skills add nubjs/nub --skill lat-md -g -y
用于在新操作系统（Windows/Linux）上调试和启动测试探针。提供分步排查阶梯，解决路径、环境变量及进程隔离等跨平台兼容性问题。
在 Windows 或 Linux 上新建测试环境
探针在某一 OS 正常但在另一 OS 失败时
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 发布。
需要发布新版本时
所有修复已合并且 CI 通过时
npx skills add nubjs/nub --skill release -g -y
将重型 Rust 构建、Clippy 检查或测试任务卸载至 GCP 临时 VM，避免占用本地开发机资源。支持分离式执行与结果收集，适用于高负载场景及全量构建。
启动冷构建或完整测试套件
主机 CPU/磁盘负载过高需释放资源
请求在不影响当前工作机的情况下运行构建
npx skills add nubjs/nub --skill remote-build -g -y
提供 Rust 构建最佳实践，防止后台构建进程孤儿化。核心规则是禁止使用 setsid/nohup 等脱离父进程的方式启动 cargo 任务，确保构建随会话结束而清理，避免目标目录锁死和资源浪费。
启动后台 Rust 构建任务
配置 CI/CD 中的长耗时构建
解决 target-dir 锁定导致的构建阻塞
优化 Rust 编译性能与资源占用
npx skills add nubjs/nub --skill rust-build-hygiene -g -y
提供Rust工作区多worktree构建封装，解决共享target目录导致的缓存污染与编译错误。增强构建安全性，强制校验运行时依赖完整性，防止静默退化。
Rust项目构建或测试
Worktree间编译冲突或缓存污染
构建时缺少运行时依赖导致静默失败
npx skills add nubjs/nub --skill rust-build -g -y
通过脚本检测UI遮挡、裁剪与对齐，弥补截图无深度信息的缺陷。结合几何测量与视觉校对，验证z-index及布局变更是否正确。
需要验证UI组件遮挡关系
检查元素是否被意外裁剪
确认排版对齐与间距准确性
npx skills add nubjs/nub --skill visual-review -g -y
提供一键创建和管理 Git worktree 的脚本，支持并行开发、共享构建缓存及隔离工作区。适用于需要独立分支进行代码提交、测试或合并的场景，简化了多工作区配置流程。
需要为功能分支创建独立的 git worktree
清理不再需要的 worktree
查询或配置 .worktreeinclude 规则
npx skills add nubjs/nub --skill worktree -g -y
