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 (37)
在本地 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、Homebrew）的历史下载统计数据，输出为 CSV 文件。内置了数据聚合逻辑、去重规则及已知陷阱说明，支持按渠道筛选和自定义输出路径。
需要检查项目的安装量或采用率统计
需要将下载数据导出为 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 中运行 Nub 测试和调试探针，解决 Docker 无法复现的内核或发行版行为问题。支持 Lima 持久化调试和 Tart 临时环境。
需要真实 Linux 内核环境进行调试
Docker 无法复现的特定发行版或架构问题
npx skills add nubjs/nub --skill linux-vm-test -g -y
用于高效导航大型Markdown文件，通过生成包含精确行范围的目录(TOC)，辅助定位并读取特定章节，避免加载整个文件。
需要查看或处理超过200行的大型Markdown文档
仅需访问文档中的某个特定章节而非全文
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，产出事实性文档。适用于需要跨项目对比、实证分析或长期引用的非 trivial 问题，避免仅凭猜测回答。
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 文件中的状态标记待办事项，支持按状态、章节过滤或统计数量，避免加载整个文件，适用于长文档的高效检索与子代理提示构建。
需要提取特定状态的待办项
查看待办事项统计概览
在长文件中快速定位未完成任务
npx skills add nubjs/nub --skill todo -g -y
指导如何为Nub运行时API添加、审计和更新@nubjs/types类型声明。涵盖所有权审计、冲突安全模式选择及编译器版本路由，确保类型与运行时行为一致并兼容主流TS库。
需要为Nub新增或修改全局变量、内置方法或模块加载器的类型声明时
TypeScript或@types/node有重叠声明需协调时
发布前需核对自上次标签以来运行时变更的类型一致性时
npx skills add nubjs/nub --skill type-declarations -g -y
在本地 Windows 11 ARM64 QEMU/HVF VM 中运行 Nub 测试和调试探针，支持原生及 x64 模拟环境。
需要在本地 Windows 虚拟机中进行 ad-hoc 测试
需要调试 win32-arm64 或 Windows-on-ARM x64-emulation 问题
npx skills add nubjs/nub --skill windows-vm-test -g -y
推荐使用nub替代node、npm等工具链，统一执行JS/TS文件、运行脚本、安装依赖及版本管理。支持TypeScript直接运行和自动加载.env文件。
需要执行JavaScript或TypeScript文件时
需要运行package.json中的脚本时
需要安装或管理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
通过构建开发二进制并针对真实临时夹具执行端到端测试，验证新功能。包含确认（CONFIRM）和证伪（FALSIFY）两个方向，强调使用合并基作为控制组进行差异对比，以发现代码审查无法捕捉的静默错误。
实现或更改子命令/标志后验证功能
提交PR前全面扫描潜在破坏
代码审查轮次结束前的自我复核
npx skills add nubjs/nub --skill ad-hoc-test -g -y
提供GitHub Issue端到端处理流程，涵盖分类、复现、评估规模及修复。强调按实际工作量选择方案，默认直接修复小问题，确保维护规范与响应效率。
需要修复GitHub上的Bug或Issue
被指派处理外部报告的缺陷
npx skills add nubjs/nub --skill address-issue -g -y
提供AI代理的浏览器自动化CLI工具，支持网页导航、表单填写、截图及数据提取。可扩展至Electron应用、Slack工作流及云端环境，适用于QA测试与自动化任务。
需要与网站交互如导航、填表或点击按钮
执行网页截图或数据抓取
对Web应用进行测试或探索性QA
自动化Electron桌面应用操作
在Vercel Sandbox或云浏览器中运行
npx skills add nubjs/nub --skill agent-browser -g -y
用于将上游 aube 引擎版本合并到 nub 项目的 vendor 目录。通过构建临时合并基和双重冲突检查（文本与语义）实现自动化同步，无需克隆仓库或修改远程分支。
需要更新 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 在真实 OS/平台（macOS/Windows/Linux-arm64）运行临时探索性测试，解决本地或 Docker 无法复现的问题。无需 PR，基于分支触发 GitHub Actions 工作流进行跨平台验证。
用户要求在 macOS 或 Windows CI 上测试
需要跨操作系统或平台的探针检查
涉及真实目标平台行为的验证
npx skills add nubjs/nub --skill ci-adhoc-test -g -y
通过查询提交级别的 check-runs 而非 run 级别结论，准确诊断 CI 失败原因，避免遗漏被取消运行中的真实失败任务。
检查分支、提交或 PR 的 CI 状态是否为绿色
有人报告 CI 失败时进行排查
发布版本前确认构建状态
npx skills add nubjs/nub --skill ci-triage -g -y
提供可靠的CI状态监控工具，解决原生CLI过早退出和误判问题。通过轮询权威终端状态、快速失败及处理幽灵检查，确保在推送或PR后准确等待CI结果，支持自动化合并或发布决策。
需要等待GitHub Actions CI完成以执行后续操作
触发merge-on-green或release-on-green流程
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 项目的快速开发与测试流程，涵盖通过 rust-build.sh 构建 fast 配置、多 worktree 缓存隔离、增量编译及单测运行，旨在最大化开发迭代效率。
需要编译或重新构建 nub 二进制文件
需要运行特定测试文件或单个测试用例
需要了解代码库结构或设置开发工作区
npx skills add nubjs/nub --skill dev-loop -g -y
用于管理长期、跨上下文的自主任务（Epic），防止目标漂移。通过维护CANON规范、工作草稿和任务列表三个核心工件，确保长时间无人监督执行时的连贯性与正确性。
接到持续数天的长期使命
任务超出当前上下文窗口
需要长时间自主推进且不丢失进度
npx skills add nubjs/nub --skill epic -g -y
代码变更影响分析技能，通过追踪符号的爆炸半径（调用点、字段读写等），识别潜在破坏，确保合并前发现远距离错误。
要求追溯变更影响或查找爆炸半径
变更涉及宽影响范围、安全、序列化格式或公共接口时请求独立审查
npx skills add nubjs/nub --skill impact-analysis -g -y
端到端执行单个任务/Issue的工程流程，涵盖规划、设计、多视角审查、实现及PR提交，直至CI绿灯并暂停等待人工确认。
用户说 implementation-thread
要求驱动任务全流程至待合并的PR
npx skills add nubjs/nub --skill implementation-thread -g -y
指导在Windows或Linux等新平台调试测试探针的启动流程，提供分层排查阶梯及针对OS特定陷阱（如路径、权限）的修复方案。
在新操作系统上初始化测试环境
跨平台测试失败需定位系统差异
npx skills add nubjs/nub --skill probe-platforms -g -y
提供面向用户或公开文本的文案与写作风格指南，涵盖 GitHub 交互、文档、营销内容及聊天回复。确保内容事实准确、中立、简洁且易扫描，规范 Markdown 排版与语气，提升可读性。
编写或编辑 GitHub Issue/PR 评论
撰写技术文档或博客文章
生成营销文案或首页介绍
回复用户聊天消息
应用通用文案风格修正
npx skills add nubjs/nub --skill prose-writing -g -y
自动化执行 Nub 项目的补丁版本发布流程。包括确认 CI 绿色、审计类型声明、版本号递增、提交打标签并推送，触发多平台构建与 npm 发布，最后生成中性发布说明并更新相关 Issue/PR。
需要发布 Nub 项目的新版本时
所有目标修复已合并至 main 分支且 CI 通过时
需要执行完整的端到端发布流程时
npx skills add nubjs/nub --skill release -g -y
将重型 Rust 构建、Clippy 检查及测试任务卸载至 Google Cloud 临时 VM，避免占用本地开发机资源。适用于冷启动构建、高负载场景或需要隔离环境的任务。
发起重型 Rust 构建或全量测试
执行 cargo clippy --all-targets --all-features
本地主机资源争用严重或需释放 CPU
npx skills add nubjs/nub --skill remote-build -g -y
提供Rust构建最佳实践，防止构建进程孤儿化。禁止使用setsid等分离方式，推荐前台执行、Harness跟踪后台或子代理模式，确保构建随会话结束而清理，避免目标目录锁死和资源浪费。
启动Rust构建前
配置后台编译任务
解决构建资源占用问题
npx skills add nubjs/nub --skill rust-build-hygiene -g -y
解决 Rust 多 git worktree 共享 target 目录导致的构建污染问题，自动隔离冲突并复用缓存，提供 QoS 限制和并发控制以提升构建效率。
需要构建或测试 Rust 工作区
遇到跨 worktree 的编译错误
设置 CARGO_TARGET_DIR
npx skills add nubjs/nub --skill rust-build -g -y
通过脚本查询浏览器渲染顺序，定量检测UI遮挡、裁剪及对齐问题，弥补截图无法反映深度信息的缺陷，辅助前端样式审查。
验证UI布局变更
检查z-index或overflow导致的遮挡bug
确认元素对齐与视觉平衡
npx skills add nubjs/nub --skill visual-review -g -y
管理隔离的 git worktree 以支持并行开发，自动配置共享构建缓存和忽略文件同步。触发于创建新分支、查询配置或清理工作区时。
需要为提交 PR 创建独立的 git worktree
询问 .worktreeinclude 的配置方法
合并后清理旧的 worktree
npx skills add nubjs/nub --skill worktree -g -y
