Agent Skills
› nubjs/nub
nubjs/nub
GitHub用于在本地 Linux VM（Lima/Tart）中运行 Nub 测试和调试探针，解决 Docker 无法复现的内核或发行版行为问题。支持持久化 Lima 调试源码状态及 Tart 干净环境复现，涵盖预检、命令追踪、构建及生命周期管理。
Install All Skills
npx skills add nubjs/nub --all -g -y
Skills in Collection (29)
用于在本地 Linux VM（Lima/Tart）中运行 Nub 测试和调试探针，解决 Docker 无法复现的内核或发行版行为问题。支持持久化 Lima 调试源码状态及 Tart 干净环境复现，涵盖预检、命令追踪、构建及生命周期管理。
需要复现特定 Linux 内核或发行版行为
Docker 无法准确模拟的架构或包行为测试
Linux Rust 项目源码级调试与构建
npx skills add nubjs/nub --skill linux-vm-test -g -y
在本地 Windows 11 ARM64 QEMU/HVF VM 中运行 Nub 测试和调试探针。通过 SSH 连接执行 win32-arm64 原生或 x64 模拟检查，需确保磁盘、SSH 密钥及 QEMU 工具可用，禁止自动重建环境。
需要在本地 Windows 11 ARM64 VM 中进行交互式测试
需要调试 win32-arm64 或 Windows-on-ARM x64 模拟行为
存在可用的外部磁盘和 SSH 配置
npx skills add nubjs/nub --skill windows-vm-test -g -y
用于执行兼容性/对等性审计，枚举 nub 与参考目标间的差异。通过五道严格关卡（精确锁定版本、实证测试、核对决策记录、对抗性自我证伪、分级交付）确保零误报，提供清洁、完整且经核实的功能缺口列表。
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 渠道（含 Homebrew），自动处理数据粒度、滞后及校验文件膨胀问题，支持按日/版本导出安装量与采用率数据。
检查或导出下载数量
分析安装计数或采用率
生成发布统计图表
npx skills add nubjs/nub --skill download-stats -g -y
提供Git历史考古的快速命令配方，用于高效查找代码、文件、字符串或API的添加、删除、重命名及变更时间。涵盖Pickaxe搜索、正则匹配、文件删除追踪、重命名跟随、行范围历史、具体提交内容查看、行级Blame分析及日期主题提取等场景。
查询特定字符串或符号何时被添加或删除
查找文件被删除的具体提交
追踪文件的重命名历史
分析特定代码行或函数的引入和变更历史
确认某个提交的详细变更内容和作者信息
npx skills add nubjs/nub --skill git-archaeology -g -y
用于高效导航大型 Markdown 文件。先通过脚本生成包含精确行范围的目录，再结合 Read 工具的 offset 和 limit 参数精准读取指定章节，避免加载全文，适用于长文档或子代理任务。
需要阅读超过200行的Markdown文件中的特定章节
处理大型架构文档、状态跟踪器或长篇 Epic 文档
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
用于追踪Nub包管理器安装等操作的耗时瓶颈。通过启用内置的阶段计时和结构化诊断工具，分析解析、获取、链接等阶段的性能表现，无需修改源码即可定位慢速问题的根源。
包管理器操作（如install）异常缓慢
需要定位性能瓶颈以优化代码
npx skills add nubjs/nub --skill pm-perf-tracing -g -y
管理仓库供应链安全等待期(SOAK_DAYS)，确保依赖发布后经过规定时长才采用。支持统一调整窗口、为特定包添加临时豁免，并自动同步更新Cargo、pnpm、npm及外部工具的配置，防止恶意或已撤销版本被安装。
任务涉及 minimumReleaseAge、min-release-age、min-publish-age
修改 external-tools.json 或 renovate.json
调整 taze cooldowns
排查新发布版本无法安装的原因
npx skills add nubjs/nub --skill soak -g -y
解析 Markdown 中的状态标签 TODO 行，支持按状态、章节过滤或统计总数。无需加载全文即可提取特定项，输出包含行号以便快速定位，适用于长文件的高效管理与子代理提示构建。
需要查看或筛选 Markdown 文件中的 TODO 事项
需要获取 TODO 文件的整体统计概览
需要从长文件中提取特定章节或状态的待办任务
npx skills add nubjs/nub --skill todo -g -y
使用 nub Rust CLI 替代 Node/bun/npm 等工具链。支持直接运行 TS/JS、执行脚本、包管理、自动配置 .env 及 Node 版本管理，无需额外构建或配置，保持代码兼容性。
需要运行 JavaScript 或 TypeScript 文件时
需要安装、添加或删除 npm 依赖包时
需要执行 package.json 中定义的脚本时
需要启动文件监听模式 (watch mode) 时
需要模拟 npx 执行本地或远程命令时
npx skills add nubjs/nub --skill nub -g -y
专为AI代理设计的快速浏览器自动化CLI，基于Rust实现。支持通过CDP控制Chrome/Chromium，提供网页交互、表单填写、截图、数据提取及Electron应用、Slack等场景的自动化能力，强调高性能与可靠性。
需要打开网站或导航页面
填写在线表单或点击按钮
截取网页屏幕截图
从网页抓取或提取数据
测试Web应用或进行QA探索性测试
登录网站或自动化浏览器操作
自动化Electron桌面应用（如VS Code、Slack）
在Vercel Sandbox或AWS Bedrock中运行浏览器任务
npx skills add nubjs/nub --skill agent-browser -g -y
用于验证 nub 新功能端到端正确性的技能。通过构建 dev 二进制并针对真实临时夹具执行，分为确认（验证新行为）和证伪（全面扫描回归）两个方向。强调使用 merge-base 作为控制组对比，以捕捉代码审查遗漏的静默错误。
实现或更改子命令/标志后验证功能
提交 PR 前进行自我审查
调用 review round 完成前
npx skills add nubjs/nub --skill ad-hoc-test -g -y
处理 nubjs/nub GitHub Issue 的全流程指南，涵盖从复现、定级到修复和发布通知。强调按比例修复、本地验证及保持专业沟通，避免过度工程化。
需要修复报告的 Bug
接手 GitHub Issue 进行处理
npx skills add nubjs/nub --skill address-issue -g -y
将nub的aube引擎从上游jdx/aube合并至vendor目录。通过动态构建临时合并节点避免克隆，利用git文本冲突与cargo语义冲突双列表机制自动化解决冲突，无需人工审查差异，确保合并正确性。
需要更新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
用于在CI环境中对macOS、Windows等平台进行无法在本地复现的临时或探索性测试。无需PR，通过分支推送触发GitHub Actions工作流，覆盖Docker无法模拟的系统级行为验证。
用户要求测试macOS/Windows CI
跨操作系统探测
需要真实运行环境的平台检查
npx skills add nubjs/nub --skill ci-adhoc-test -g -y
提供安全的CI状态监控脚本，解决gh CLI原生命令在队列期误报成功及网络抖动误报失败的问题。通过轮询权威终端状态、快速失败机制和超时控制，确保在合并或发布前获得可信的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 Rust项目的快速开发与测试流程。通过worktree隔离、fast编译配置及共享缓存机制，实现秒级增量构建。涵盖二进制编译、安装、单元测试执行及代码库导航指南。
需要编译nub开发二进制文件
设置工作树以进行快速迭代
运行特定文件或单个测试
了解代码库结构
npx skills add nubjs/nub --skill dev-loop -g -y
强制性的代码变更影响分析技能，通过追踪符号的爆炸半径（调用点、字段读写等）发现潜在破坏。要求基于证据而非记忆，对每个变更点进行系统性审查并生成带证据的报告，防止本地正确但远程失效的合并。
非平凡代码变更的自我审查
用户要求追踪影响范围
查找爆炸半径
询问变更会破坏什么
查询谁调用了某函数
npx skills add nubjs/nub --skill impact-analysis -g -y
端到端执行单一任务，涵盖规划、审查、实现及PR创建。由L1代理主导并嵌套L2子代理，在关键决策点暂停以获取人类反馈，最终提交待合并的PR。
用户明确输入 implementation-thread
要求驱动任务直至生成并持有PR
npx skills add nubjs/nub --skill implementation-thread -g -y
规范所有用户可见文本（如GitHub交互、文档、营销文案）的写作风格。要求内容事实、中立、简洁且易扫描，避免冗余和营销话术，确保技术文档的专业性与可读性。
撰写或编辑GitHub Issue/PR评论、描述及发布说明
创建或修改面向用户的文档、博客及营销文案
生成实质性对话回复或重构文本以提高可读性
npx skills add nubjs/nub --skill prose-writing -g -y
用于一键执行 nub 项目的补丁版本发布。流程包括确认 CI 绿色、递增版本号、打标签推送以触发自动化构建与 npm 发布，并生成中性发布说明及评论关联 Issue/PR。严禁未经明确授权或修复未合入时发布。
用户明确要求发布新版本
所有目标修复已合并至 main 分支且 CI 状态为绿色
npx skills add nubjs/nub --skill release -g -y
将重型 Rust 构建、Clippy 检查或测试套件调度至 GCP Spot VM，以缓解 Mac 磁盘 I/O 瓶颈。适用于冷启动构建及高负载场景，但增量编译应保留本地。
需要运行 cargo clippy --all-targets --all-features
需要执行完整的 cargo test 测试套件
主机 CPU/磁盘负载过高，需释放资源
用户请求在不占用本机资源的情况下进行构建
npx skills add nubjs/nub --skill remote-build -g -y
指导如何正确启动Rust构建以防止进程孤儿化。核心规则是禁止使用setsid/nohup等分离方式，避免持有target-dir锁。提供前台、后台追踪及子代理等场景的正确执行方案，确保构建随会话结束而清理。
准备运行 cargo build/test/clippy
需要后台执行长期构建任务
设置子代理进行构建等待
解决构建残留或锁冲突问题
npx skills add nubjs/nub --skill rust-build-hygiene -g -y
解决并行工作树下 Rust 构建的缓存共享与隔离冲突。自动处理目标目录，防止因代码分歧导致的制品污染。提供 QoS 限制和并发控制以优化多代理构建性能，并修复了测试通过但二进制文件过期的问题。
需要在工作树中构建或测试 nub Rust 工作区
遇到疑似工作树间制品污染的编译错误（如缺失字段）
设置 CARGO_TARGET_DIR 时
npx skills add nubjs/nub --skill rust-build -g -y
通过chrome-devtools MCP执行脚本，计算元素遮挡、裁剪和对齐的确定性数据，弥补截图缺乏深度信息的缺陷。结合几何测量与视觉审查，确保UI布局正确，特别检测z-index和溢出问题。
需要验证UI组件的遮挡关系或层级堆叠是否正确时
检查元素是否被固定/粘性覆盖层意外裁剪时
调整间距或对齐后需确认视觉效果而非仅数学一致时
npx skills add nubjs/nub --skill visual-review -g -y
用于在nub仓库中创建和管理隔离的git worktree，支持并行构建测试。通过脚本自动处理工作树初始化、共享CARGO_TARGET_DIR配置及.worktreeinclude应用，配合dev-loop技能提升构建效率并简化清理流程。
需要创建新的git worktree以提交PR或进行并行开发
询问如何配置或使用.worktreeinclude文件
需要清理已合并的worktree
npx skills add nubjs/nub --skill worktree -g -y
