核心用法
nb Skill 是专为命令行笔记工具 nb CLI 设计的智能参考指南，它将复杂的笔记管理操作转化为结构化的自然语言指令。用户可以通过该技能创建、组织和检索存储在本地 ~/.nb/ 目录下的 Markdown 格式笔记。核心工作流围绕多笔记本架构展开，支持通过 nb add 创建带标签的笔记、nb search 进行跨库全文检索、nb todo 管理待办事项，以及 nb bookmark 归档网页链接。所有操作均自动触发 Git 提交，确保每次修改都有版本记录。特别值得注意的是其 wiki 风格的链接系统，允许在不同笔记间建立关联，形成知识网络。
显著优点
该技能的最大优势在于将 Git 的版本控制能力无缝集成到笔记管理中，用户可以通过 nb sync 命令将笔记库推送到远程仓库，实现跨设备同步和数据备份。纯文本 Markdown 存储格式确保了数据的长期可读性和格式兼容性，避免了厂商锁定风险。多笔记本架构支持按项目或主题隔离笔记，配合强大的布尔逻辑搜索（AND/OR/NOT）和标签过滤，大幅提升了信息检索效率。此外，内置的待办事项管理和网页书签功能，使其成为集笔记、任务、资料收集于一体的综合知识管理工具。
潜在缺点与局限性
使用该技能存在明显的准入门槛：必须预先安装 nb CLI 工具，且所有操作均依赖命令行环境，对非技术用户不够友好。虽然 Git 集成是优势，但也要求用户具备基本的版本控制知识才能有效利用同步功能。数据完全本地存储意味着用户需要自行配置远程 Git 仓库以实现云备份，否则存在单点故障风险。此外，该技能仅提供操作指南，不包含图形界面，对于习惯可视化笔记软件的用户可能需要适应期。
适合的目标群体
该技能特别适合以下人群：习惯在终端工作的开发者和技术人员、偏好纯文本和开源工具的效率追求者、需要将笔记纳入 Git 工作流的极客用户，以及重视数据所有权、拒绝云端笔记服务隐私条款的隐私敏感型用户。对于已经使用 Vim/Emacs 等编辑器、熟悉命令行操作的专业人士，nb 提供了与其工作流无缝衔接的笔记方案。
使用风险与注意事项
主要风险集中在数据操作层面：nb delete -f 命令可强制删除笔记且不可恢复，建议始终启用 Git 远程备份。技能文档明确警告不要手动编辑 ~/.nb/ 目录下的文件，直接修改可能导致索引损坏或 Git 历史不一致。由于依赖外部二进制文件，若 nb CLI 版本更新引入破坏性变更，可能导致部分命令失效。性能方面，随着笔记数量增长（数千条以上），纯文本搜索可能变慢，建议定期归档旧笔记到独立笔记本。