📦 Fabric CLI skill - Self-Organizing Personal Cloud — Fabric CLI 技能 - Self-Organizing Personal Cloud

Fabric.so CLI 代理技能 用于操作 Fabric.so 命令行工具（可执行文件为 fabric）。Fabric.so 是个人/团队知识工作区，支持笔记、文档、文件、链接、任务、搜索与 AI 助手工作流。 本技能不适用于 Microsoft Fabric、Azure、Power BI、OneLake、lakehouse、容量、语义模型、数据管道、Daniel Miessler 的无关 Fabric 模式框架、Python Fabric SSH 自动化、Fabric.js 画布或实体布料。

首步判断：确认是 Fabric.so？ 当用户想在终端使用 Fabric.so CLI（库搜索、保存笔记/链接/文件、工作区导航、任务、助手问答、JSON 输出、自动化或代理记忆）时激活。 若涉及 Microsoft Fabric、Azure、Power BI、OneLake、lakehouse、notebook、KQL、语义模型、容量、租户、部署管道或 fab CLI，勿用。 亦勿用于 Daniel Miessler 的 Fabric 框架、Fabric.js、Python Fabric SSH 或纺织布料。 用户仅说“Fabric CLI”且上下文模糊时，检查周边词：library、note、bookmark、workspace memory、fabric save/search/ask 指向 Fabric.so；lakehouse、Power BI、tenant、capacity、OneLake、workspace item、fab 指向其他。

真理源规则 本地 CLI 可能更新。使用未列选项前，先查实时帮助： fabric --help fabric help COMMAND fabric COMMAND --help

优先用全局 --json 获取可解析、非交互输出： fabric --json search "项目笔记" fabric --json workspace current fabric --json task list --todo 若 JSON 失败，去 --json 重试，查帮助并报告限制。不臆造 JSON 结构，防御性解析。

安全与同意规则 将 Fabric 视为真实远程工作区。只读操作（search、path、inbox、bin、workspace current/list、task list、subscription、本地 help/version）可直接执行。 变更状态操作（note、link、file、save、create、folder、task add/done/edit、workspace select、auth 设置）需用户明确请求。 破坏或难撤销操作（task rm、logout、删除/移动/批量编辑等）需执行前再次确认。 除非用户明确要求安装，否则不运行远程安装器。官方安装脚本： curl -fsSL https://fabric.so/cli/install.sh | sh 为安全，先下载到临时文件审查，获批后执行。 绝不打印、存储或保存 API 密钥、令牌、密码、Cookie 或其他私密凭据至 Fabric；生成记忆笔记时打码秘密。优先用环境变量或浏览器登录；仅当密钥已安全可用或用户明确选择时，用 fabric auth API_KEY。 长文本用 stdin，所有用户输入的文本、路径、标签、URL、标题、父文件夹、任务标题、工作区名使用 shell 安全引号。

快速环境检查 实时工作流中，确认 CLI 存在且未被混淆： python3 scripts/fabric_check.py --json 若用户将实际使用 Fabric 且只读账户检查可接受： python3 scripts/fabric_check.py --deep --json （检查器只读，不安装、不认证、不写 Fabric、不切换工作区、不登出。） 需多子命令最新帮助时： python3 scripts/fabric_help_cache.py --commands search,path,save,task,workspace --json 用 scripts/fabric_command_plan.py 构建带 shell 引号的命令计划而不执行。

核心命令映射 顶级用法：fabric [options] [command] 已知全局选项： fabric --version fabric --help fabric --json COMMAND

高层命令用途： auth API_KEY：存储 API 密钥。 login：浏览器登录。 logout：清除凭据。 search [options] [query]：搜索当前工作区。 path [options] [query]：浏览空间与文件夹；无 query 列根空间。 create [options] KIND：创建空间、文件夹、笔记、链接或文件。 note [options] [content]：新建笔记；省略 content 时读 stdin。 link [options] URL：保存书签。 file [options] PATH：上传本地文件。 save [options] [input]：智能保存 URL、本地路径、文本或 stdin。 folder [options] [name]：新建文件夹，默认在 Inbox，可指定 --parent。 inbox [options]：列 Inbox 项目。 bin [options]：列 Bin 项目。 workspace list/current/select NAME：查看/切换工作区。