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 中运行临时测试和调试探针，用于复现 Docker 无法模拟的内核或发行版行为。支持持久化 Lima 调试与隔离 Tart 环境，提供预检、源码同步及构建测试流程。
需要测试特定 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
用于在实施前进行协作式方案设计，通过梳理开放问题、做出决策来确立实现方法。适用于需求模糊、需要权衡选项或确定技术架构的场景，旨在产出确定的设计方案而非代码。
spin up a plan
let's design
plan thread
how should we approach
think through the approach
npx skills add nubjs/nub --skill plan-thread -g -y
用于性能追踪包管理器安装过程，定位慢瓶颈。通过内置的相位计时和结构化诊断工具，分析耗时分布与策略使用情况，无需修改源码即可快速排查性能问题。
包管理器操作异常缓慢
需要定位安装或解析阶段的性能瓶颈
npx skills add nubjs/nub --skill pm-perf-tracing -g -y
用于生成事实性研究报告的 Skill，适用于技术调研、竞品分析、历史方案梳理等场景。通过系统性搜索、源码阅读和实验验证，产出 wiki/research/ 下的长期引用文档，避免主观臆断。
需要进行 prior art 调查
询问某技术的现状或解决方案
需要梳理被废弃的方案或历史尝试
执行非琐碎问题的实证调查
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添加、审计和更新@nubjs/types类型声明。涵盖所有权审计、冲突安全模式选择及版本兼容性处理，确保类型定义与运行时行为一致。
需要为新功能或变更添加TypeScript类型声明
审计现有类型声明以确保与运行时行为一致
解决与@types/node或其他库的类型冲突
npx skills add nubjs/nub --skill type-declarations -g -y
用于在本地 Windows 11 ARM64 QEMU VM 中运行临时测试和调试探针。支持原生 ARM64 及 x64 模拟环境，包含预检、生命周期管理及 SSH 探测执行流程。
需要在本地 Windows ARM64 环境中验证功能
进行 win32-arm64 或模拟 x64 的调试检查
npx skills add nubjs/nub --skill windows-vm-test -g -y
nub 是替代 Node 工具链的 Rust CLI，用于执行 JS/TS、运行脚本、安装依赖及版本管理。它无缝兼容 Node，支持 TypeScript 直接运行和自动加载 .env，旨在简化日常开发流程并统一包管理操作。
需要执行 JavaScript 或 TypeScript 文件时
需要运行 package.json 中的脚本时
需要安装或更新 npm 依赖包时
需要管理 Node.js 版本时
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
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 引擎变更合并至 vendored/aube。通过构建临时仓库和双冲突列表（文本与语义）自动化解决冲突，确保同步正确性并避免手动审查。
需要更新 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 工作流进行跨平台验证和探索性测试。
用户要求测试特定平台行为
需要在非 Linux 环境进行验证
npx skills add nubjs/nub --skill ci-adhoc-test -g -y
通过查询 commit 的 check-runs 而非 run-level conclusion，准确诊断 CI 失败原因，避免漏报被取消运行中的真实失败。
检查分支或 PR 状态
报告 CI 失败时
发布前验证
npx skills add nubjs/nub --skill ci-triage -g -y
解决GitHub Actions原生CLI监控工具过早退出及误判问题。通过脚本轮询权威状态，确保CI任务真正结束且结果可信，支持快速失败和超时控制，适用于发布或合并前的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
提供nub项目的快速开发构建与测试流程，涵盖工作区设置、fast配置编译、增量迭代及CI门禁，优化本地开发效率。
需要编译nub二进制文件
设置工作区进行快速增量迭代
运行特定测试文件或单个测试
了解代码库结构
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
负责将单个任务从需求澄清、设计规划、代码实现到PR提交的全流程端到端执行。强调单一负责人（L1）维持上下文连续性，按需调度子代理进行多视角审查，并在关键决策点暂停以获取人类确认，确保高质量交付。
用户明确输入 'implementation-thread'
要求驱动某个任务或Issue直到生成待合并的PR
npx skills add nubjs/nub --skill implementation-thread -g -y
管理nub知识库图谱，提供搜索、定位及链接检查功能。设计前查阅决策背景，变更后更新文档并运行CI门禁，确保知识关联有效，避免重复推导和文档腐烂。
进行非平凡的设计或架构变更前
修改了架构、行为或测试覆盖后
npx skills add nubjs/nub --skill lat-md -g -y
指导在Windows或Linux新平台上启动测试探针，提供分层调试阶梯以避免平台特异性陷阱（如路径、权限、进程隔离），适用于跨OS环境下的故障排查与适配。
在新操作系统上首次运行测试探针
测试探针在某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 项目补丁版本发布全流程，涵盖版本校验、类型审计、标签推送及多平台构建。需人工确认 CI 绿灯并明确授权后方可执行，确保发布安全与合规。
需要发布 Nub 项目的补丁版本
所有修复已合并至 main 分支且 CI 通过
npx skills add nubjs/nub --skill release -g -y
将重型 Rust 构建、Clippy 检查或测试套件卸载至 GCP 临时 VM，避免占用本地 Mac 资源。适用于冷启动构建、高负载场景及跨平台编译，配合本地增量循环使用以提升开发效率。
需要执行重型冷启动构建
运行 cargo clippy 全量检查
执行完整工作区测试套件
主机 CPU/磁盘负载过高需释放资源
用户请求不占用本地机器进行构建
npx skills add nubjs/nub --skill remote-build -g -y
提供 Rust 构建的最佳实践，核心是禁止分离进程以防孤儿进程占用资源。指导如何正确后台运行、等待长构建及清理残留，确保构建安全退出并自动清理。
启动 cargo build/test/clippy
设置后台构建或子代理
处理长时间运行的构建
npx skills add nubjs/nub --skill rust-build-hygiene -g -y
提供Rust多工作树共享缓存构建脚本，解决增量编译加速与跨分支内容污染冲突，自动隔离并优化资源调度。
需要快速构建或测试Rust项目
遇到因工作树切换导致的编译错误
配置CARGO_TARGET_DIR
npx skills add nubjs/nub --skill rust-build -g -y
通过Chrome DevTools执行脚本获取元素遮挡、裁剪及对齐数据，辅助UI视觉审查。结合几何测量与人工观察，解决截图无法反映层级和深度的问题，确保布局变更正确性。
需要验证UI布局或样式更改是否正确
检查z-index、溢出隐藏导致的遮挡或裁剪问题
npx skills add nubjs/nub --skill visual-review -g -y
管理Git工作树以支持并行开发，封装创建、共享构建缓存及清理流程，提升多任务协作效率。
需要为PR创建隔离的工作区
询问.worktreeinclude配置
清理合并后的工作树
npx skills add nubjs/nub --skill worktree -g -y
