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
用于拉取并生成 nub 包在 npm 和 GitHub 的下载统计数据，输出 CSV 文件及可视化图表。支持按周、月、日维度聚合，处理数据完整性校验与滞后问题，适用于检查安装量、采用率等统计需求。
检查或导出包的下载数量
生成安装统计或采用率图表
查看分发渠道（npm/GitHub）的数据趋势
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 内核特定行为
需要验证特定 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
用于在实施前进行协作式架构设计与方案制定，通过梳理开放问题、做出决策来锁定实现路径。适用于需求模糊、需权衡技术选项或确定整体approach的场景，交付物为 settled design。
需要协作设计而非直接编码时
用户提出'spin up a plan'或'let's design'
不确定如何实现，需先明确approach
npx skills add nubjs/nub --skill plan-thread -g -y
用于追踪 Nub 包管理器安装等操作的耗时瓶颈。通过启用内置的 Phase 计时和结构化诊断工具，定位性能问题根源，无需修改源码。
包管理器操作（如 install）异常缓慢
需要定位性能瓶颈而非修改代码
npx skills add nubjs/nub --skill pm-perf-tracing -g -y
用于执行深度技术调研、专利检索及前沿状态分析的技能。通过系统性搜索源码、Issue 及实验验证，产出长期引用的事实性研究报告，适用于非代码类的复杂知识探索场景。
需要进行广泛的技术背景调查或竞品分析
用户询问特定技术的最新进展、历史解决方案或被放弃的方案
需要生成结构化的研究文档以支持后续决策
npx skills add nubjs/nub --skill research-thread -g -y
管理仓库供应链 soak 窗口，统一配置 SOAK_DAYS 以延迟采纳新发布。提供校验、修复漂移配置、更新依赖及排除过期项的自动化脚本，确保生态安全。
需要调整或检查供应链安全等待时间(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兼容。涵盖所有权审计、冲突安全模式选择及版本路由，保障类型定义准确反映运行时行为。
Nub新增或修改全局变量、内置方法或模块加载器类型
TypeScript或@types/node获得重叠声明时
发布前同步运行时变更
npx skills add nubjs/nub --skill type-declarations -g -y
用于在本地Windows ARM64 QEMU虚拟机中运行Nub测试和调试探针，支持原生ARM64及x64模拟环境检查。
需要在本地Windows VM中进行交互式测试
需要调试win32-arm64或x64-emulation问题
npx skills add nubjs/nub --skill windows-vm-test -g -y
指引使用nub替代Node生态常用工具，统一执行JS/TS、运行脚本、包管理及版本控制，保持代码兼容性。
需要执行JavaScript或TypeScript文件时
需要安装或管理Node依赖包时
需要运行package.json中的脚本时
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
针对nub工具进行端到端验证，包含确认功能生效和反向查找回归的两种测试方向。通过构建开发二进制并运行对抗性夹具，确保变更未引入静默错误，强调与参考工具对比及合并基线控制。
实现新功能或修改行为后需验证实际可用性
提交PR前或请求代码审查前需全面排查潜在回归
npx skills add nubjs/nub --skill ad-hoc-test -g -y
提供 GitHub Issue 端到端处理流程，涵盖分诊、复现、评估规模、修复及发布闭环。遵循维护规范，强调按实际工作量执行，避免过度工程化，确保响应及时与代码质量。
需要修复报告的 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
用于将 vendored aube 引擎同步至最新上游版本。通过构建临时合并基、处理文本与语义冲突，实现自动化升级，无需克隆或推送，确保变更准确且高效。
需要更新 vendor/aube 依赖时
上游 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
通过 GitHub Actions 分支触发 CI，在真实 macOS/Windows 环境执行探索性测试，解决 Docker 无法覆盖的平台特定问题（如代码签名、Shell 行为），无需 PR 即可验证跨平台兼容性。
需要在 macOS 或 Windows CI 上测试
跨操作系统或平台探测
需要真实环境进行 ad-hoc 检查
npx skills add nubjs/nub --skill ci-adhoc-test -g -y
通过查询Commit级别的Check-Runs而非Run结论，准确诊断CI状态。解决因cancel-in-progress导致Run被误判为cancelled从而掩盖Job失败的问题，确保正确识别红色CI并定位原因。
检查分支、Commit或PR的CI是否通过
有人报告CI失败时排查原因
发布版本前验证CI状态
声称某个Commit是绿色状态前进行核实
npx skills add nubjs/nub --skill ci-triage -g -y
提供GitHub Actions CI状态监控能力，解决原生CLI过早退出和临时错误问题。支持等待PR检查或Workflow运行直至终端状态，实现失败快速终止和可信退出码，适用于CI触发后的自动化决策流程。
需要等待GitHub Actions CI完成并获取结果
在PR创建、推送main分支或打标签后需阻塞直到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 profile、共享缓存及worktree隔离实现~5s增量构建，覆盖CLI二进制、N-API插件构建及单元测试，明确区分本地迭代与远程CI流程。
需要快速编译开发环境下的nub二进制文件
设置工作树以进行快速增量迭代
运行特定文件或单个测试用例
了解代码库结构（如crate map）
npx skills add nubjs/nub --skill dev-loop -g -y
用于清理Mac上因Rust构建产生的磁盘空间占用，解决ENOSPC问题。通过脚本清理worktree私有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的完整工程流程，强调子代理分层协作与人工决策暂停。
用户说 implementation-thread
要求驱动任务至PR阶段
npx skills add nubjs/nub --skill implementation-thread -g -y
管理知识库图谱，支持搜索、阅读和维护 wiki/ 下的设计决策与研究内容。通过 lat check 确保链接有效性，辅助开发前查阅与变更后验证，防止重复推导并保障文档一致性。
进行非平凡的设计或架构变更前
变更影响架构、行为或测试覆盖率后
需要查找已有决策依据时
维护知识库链接有效性时
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 新平台上部署或调试测试探针的标准化流程。通过分层验证策略隔离故障，解决跨平台特有的路径、权限及进程管理陷阱，避免无效排查。
在新操作系统上首次运行测试探针
测试探针在某一 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 项目端到端发布流程。涵盖版本校验、补丁升级、类型审计、生成事实性发布说明，并触发包含多平台构建、OIDC 暂存及人工审批门禁的 CI/CD 流水线，最终完成发布与闭环通知。
需要执行 Nub 软件版本的正式发布
修复已合并至 main 分支且 CI 通过的补丁后准备上线
执行 npm 包的 OIDC 可信发布与人工审批流程
npx skills add nubjs/nub --skill release -g -y
将重型 Rust 构建、Clippy 检查及测试套件卸载至 Google Cloud 临时 VM，避免占用本地 Mac 资源。默认用于冷启动和全量任务，保留本地仅用于快速增量循环。
执行完整的 cargo test 或 clippy 检查
需要释放本地 CPU 资源进行重型构建
运行 ad-hoc 脚本且无需 macOS 特定行为
npx skills add nubjs/nub --skill remote-build -g -y
规范 Rust 构建启动流程，防止因后台进程脱离导致的目标目录锁死和资源耗尽。核心规则为禁止使用 setsid/nohup 等方式分离构建进程，推荐通过 Harness 追踪或子代理方式管理构建生命周期，确保会话结束时自动清理。
启动 cargo build/test/clippy
配置后台构建任务
处理长时间编译等待
npx skills add nubjs/nub --skill rust-build-hygiene -g -y
提供 Rust 工作区的跨 worktree 构建脚本，解决共享目标目录导致的缓存复用与编译污染问题。支持自动隔离、QoS 限流及并行度控制，确保多分支开发时构建速度与正确性。
需要构建或测试 Rust 项目
在多 worktree 环境下进行增量编译
遇到因 worktree 切换导致的编译错误
npx skills add nubjs/nub --skill rust-build -g -y
通过Chrome DevTools执行脚本，量化检测UI遮挡、裁剪及对齐问题。结合几何测量与视觉观察，解决截图无法反映深度和堆叠上下文导致的布局误判，确保样式变更正确。
验证UI或样式变更的视觉正确性
检查z-index、overflow等导致的遮挡或裁剪bug
npx skills add nubjs/nub --skill visual-review -g -y
管理隔离的Git工作树以支持并行开发，自动配置共享构建缓存和.gitignore文件链接，简化多任务环境下的代码提交与构建流程。
需要创建新的隔离分支进行开发或测试
询问如何配置工作树包含文件或清理旧工作树
npx skills add nubjs/nub --skill worktree -g -y
