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 项目全量下载统计 CSV，覆盖 npm 和 GitHub 渠道。解决数据粒度、延迟及去重问题，支持图表与导出分析。
查询下载量或安装数
生成 adoption stats 报告
导出分发渠道统计数据
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 无法模拟的系统级差异排查
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包管理器安装过程中的性能瓶颈。通过启用内置的阶段计时和结构化诊断工具，定位解析、获取或链接阶段的耗时原因，无需修改源码即可快速排查意外缓慢的问题。
包管理器操作（如install）执行速度异常缓慢
需要定位包解析、下载或文件链接的具体耗时环节
npx skills add nubjs/nub --skill pm-perf-tracing -g -y
用于进行深度技术调研，产出事实性综述文档。适用于竞品分析、先验技术调查或长期引用的非 trivial 问题研究，强调通过广泛搜索和实证验证得出结论。
prior art survey
how has X already been solved
state of the art
dig into whether
npx skills add nubjs/nub --skill research-thread -g -y
管理仓库供应链安全冷却期，统一配置各包管理器最小发布年龄。提供校验、修复窗口漂移及临时排除功能，防止恶意或回滚版本被采用，确保依赖安装安全。
任务涉及 minimumReleaseAge 或 min-publish-age 等安全参数
需要调整供应链冷却窗口或处理外部工具锁定
排查新发布包无法安装的安全策略问题
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类型声明。涵盖所有权审计、冲突安全模式选择及多编译器版本兼容，确保类型与运行时行为一致。
需要为Nub全局变量或内置方法添加类型声明
检查现有类型声明是否与运行时实现一致
解决TypeScript库间的类型冲突
npx skills add nubjs/nub --skill type-declarations -g -y
在本地 Windows 11 ARM64 QEMU/HVF VM 中运行 Nub 测试和调试探针。支持原生 ARM64 及 x64 模拟环境，包含预检、生命周期管理、SSH 就绪检查及探针执行流程。
需要在本地 Windows 环境中进行交叉架构测试
需要调试 win32-arm64 或模拟的 x64 应用行为
npx skills add nubjs/nub --skill windows-vm-test -g -y
介绍使用nub替代Node生态工具链（node/npm/bun等）的开发规范，涵盖文件执行、脚本运行、包管理及环境加载，旨在统一开发环境并简化日常操作。
需要使用node或npm命令时
需要运行TypeScript/JSX文件
需要安装或管理依赖包
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 提交。强调按实际工作量选择处理方式，避免过度工程化，确保维护规范与闭环。
需要处理 GitHub Issue
被要求修复报告的 Bug
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 引擎更新合并至 nub 项目的 vendor 目录。通过构建临时合并提交、生成文本与语义双重冲突列表，自动化处理依赖升级中的代码合并与编译验证。
需要更新 vendored aube engine 到新版本
需要拉取上游 jdx/aube 的任意 commits
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等真实平台进行无需PR的临时/探索性测试，解决本地或Docker无法复现的问题。
需要在macOS或Windows CI上测试特定行为
跨操作系统平台探测
需要真实环境验证而非本地模拟
npx skills add nubjs/nub --skill ci-adhoc-test -g -y
通过查询 commit 的 check-runs 而非 run 结论，准确诊断 CI 失败原因。解决因 cancel-in-progress 导致 run 被取消而掩盖 job 失败的漏报问题，提供权威且可点击的排查结果。
检查分支或 PR 是否通过
有人报告 CI 失败时
发布版本前确认状态
声称提交已通过验证前
npx skills add nubjs/nub --skill ci-triage -g -y
解决 GitHub CLI 原生监控工具因排队或瞬态错误导致的误判问题。通过脚本轮询权威状态，确保 CI 真正结束且结果可信，支持失败快速退出和幽灵检查处理，适用于合并、发布等自动化流程。
需要等待 CI 构建完成
PR 检查状态确认
自动合并或发布决策
npx skills add nubjs/nub --skill ci-watch -g -y
诊断并清理开发主机上的CPU、内存和磁盘争用。处理挂起的Rust构建锁、废弃的worktree目标目录、孤儿Node测试进程及负载生成器，通过测量、清理残留文件和验证循环恢复系统性能。
机器运行缓慢或负载/交换空间高
磁盘空间不足
Rust构建因目标锁挂起
基准测试需要安静环境
疑似存在孤立的构建或测试进程
npx skills add nubjs/nub --skill cpu-reduction -g -y
提供 Rust 项目 nub 的快速开发与测试工作流，涵盖基于 fast profile 的二进制构建、增量编译优化、多 worktree 隔离策略及单元测试执行。
需要编译开发环境二进制文件
设置用于快速迭代的工作区分支
运行特定文件或单个测试用例
了解代码库结构
npx skills add nubjs/nub --skill dev-loop -g -y
用于清理 Rust 构建残留以释放磁盘空间。处理工作树私有 target 目录和孤儿共享目标桶，提供安全清理脚本及 df/du 差异说明，解决 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提交的端到端全流程，支持多阶段审查与CI修复，在关键决策点暂停并交还控制权。
用户输入 'implementation-thread'
要求将任务驱动至待合并的PR阶段
npx skills add nubjs/nub --skill implementation-thread -g -y
用于维护 wiki/ 知识库图谱，通过 lat CLI 进行设计前查阅与变更后校验。确保文档链接有效，作为 CI 门禁防止文档腐烂，支持语义搜索、定位及引用检查。
设计或修改架构前查阅决策背景
更改架构、行为或测试覆盖后更新文档
提交代码前验证 wiki 链接有效性
npx skills add nubjs/nub --skill lat-md -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 发布操作，确保 CI 绿灯后生成中立发布说明并闭环相关 Issue/PR。
需要发布 Nub 补丁版本
完成修复后执行端到端发布流程
npx skills add nubjs/nub --skill release -g -y
将重型 Rust 构建、Clippy 检查及测试套件卸载至 GCP Spot VM，避免本地 Mac 资源争用。支持分离执行与结果收集，适用于冷启动构建或主机负载过高场景。
需要运行完整的 cargo test 或 clippy 检查
本地 Mac 主机 CPU/磁盘负载过高
请求在不占用本地资源的情况下进行重型构建
npx skills add nubjs/nub --skill remote-build -g -y
提供Rust构建最佳实践，防止因错误后台启动导致进程孤儿、锁死和目标目录堆积。核心规则是禁止detach构建，推荐通过harness跟踪或子代理管理构建生命周期，并优化缓存与QoS以提升性能。
需要启动Rust构建任务时
配置CI/CD中的构建流程时
解决构建锁竞争或资源占用问题时
npx skills add nubjs/nub --skill rust-build-hygiene -g -y
提供Rust多工作区构建脚本，解决跨worktree共享目标目录导致的编译污染问题。支持自动隔离依赖差异，优化增量构建速度，并集成macOS QoS限流与并发控制。
执行cargo build/test/clippy
遇到E0063等字段缺失的编译错误
配置CARGO_TARGET_DIR
npx skills add nubjs/nub --skill rust-build -g -y
通过浏览器脚本检测元素遮挡与裁剪，结合视觉检查验证UI布局、样式及对齐的正确性。
需要验证UI或样式变更是否正确时
检查z-index、溢出隐藏或固定覆盖层导致的遮挡问题
npx skills add nubjs/nub --skill visual-review -g -y
提供一键创建和管理隔离 git worktree 的脚本，支持共享 CARGO_TARGET_DIR 加速 Rust 构建及处理 .worktreeinclude，用于并行开发、测试和代码提交。
需要为功能分支创建隔离工作区
配置或查询 .worktreeinclude 规则
清理已合并的 worktree
npx skills add nubjs/nub --skill worktree -g -y
