mcpField
F
fabric-cli

fabric-cli

github.com/tristanmanchester生产力338 次安装6 周前更新
代码仓库

关于 fabric-cli

fabric-cli 是用于 Fabric.so 的命令行工作流技能，面向需要检索内容、管理任务或保存资料的用户。它强调核实工作区与操作结果，并区分读取、写入和委托式 Agent 执行。

主要功能

  1. 01检查 CLI 版本、帮助与工作区
  2. 02搜索内容并浏览路径
  3. 03读取原始内容以核实证据
  4. 04按类型创建笔记、链接或文件
  5. 05管理任务并核对变更结果

适用场景

  1. 01在指定工作区搜索项目资料
  2. 02将审阅后的笔记或文件保存到目标位置
  3. 03按明确 ID 更新或删除任务
  4. 04核实写入操作及返回的资源 ID

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/tristanmanchester/agent-skills --skill fabric-cli

安装后在 Claude Code 中输入/fabric-cli确认已加载。

附带文件references/MEMORY.md

详细介绍

Fabric.so CLI 工作流

直接使用原生 CLI，或使用已获授权的 Fabric 连接器（如果这是可用的接口）。不要再套一层命令目录，也不要把规划器的 read 标签当作访问控制保证。

验证工具和工作区

fabric --version
fabric --help
fabric --json workspace current
fabric --json workspace list
fabric search --help

确认这是 Fabric.so，而不是另一个同名可执行文件。帮助和版本检查在本地进行；工作区检查会访问账户状态。进行任何写入前，请检查退出状态和返回的工作区。工作区名称可能存在歧义；如果有提供方 ID，请保留。切换工作区会改变持久化 CLI 上下文：应串行执行操作，或使用有文档说明的单命令作用域，并重新检查目标。

官方安装程序为 https://fabric.so/cli/install.sh。在获准安装前，先下载并检查安装程序；默认情况下，不要将远程代码直接管道传给 shell。设置时优先使用浏览器登录。fabric auth <api-key> 会将密钥放入进程参数和历史记录；请使用受支持的受保护身份验证方式，绝不要将凭据记录或复制到笔记中。不要臆造已安装 CLI 未说明支持的环境变量。

搜索和检索证据

fabric --json search "project notes"
fabric --json search "design" --tag work
fabric --json path
fabric --json path "Inbox/Reports"

使用搜索查找候选内容，使用路径浏览查找已知文件夹。明确展示查询、标签、工作区和分页方面的限制。摘要片段并非完整来源。如需详细摘要，请通过受支持的 CLI/API/连接器操作检索原始内容。不要悄然以 Fabric AI 助手的解读替代源文档，也不要假定搜索结果是完整的。

**fabric ask 会委派 Agent 执行。**其文档说明的用途包括要求助手执行操作。自然语言的“只读”提示词或旧版 ask-read 规划器标签，并不会禁用工具、写入操作或付费推理。只有在明确限定范围后才使用它；检索证据时应使用实际的资源读取操作。

保存准确内容并指定类型

对于获准的写入，已知类型时请使用 note、link 或 file。save 会自动检测类型：看起来像路径的文本可能会被当作文件上传，而不是创建笔记。使用前请验证这种推断。

fabric --json note --parent "Work/Projects" < "/private/output/reviewed-note.md"
fabric --json link "https://example.com" --title "Reference" --parent "Work/Reading"
fabric --json file "/absolute/path/reviewed-report.pdf" --parent "Work/Reports"

note 命令中的位置文本是正文，不是标题。只有在已安装命令提供相应标志时，才能单独设置标题。上传前请检查确切字节内容和附件范围，保留目标位置限制，并保存返回的 ID。在支持的情况下，按 ID 验证创建的资源；搜索索引延迟意味着暂时找不到并不能说明创建失败。

任务和变更

读取 fabric --json task list，并在完成、编辑或删除前确认准确的任务。使用当前的 task help 查看字段、优先级、截止日期和标识符。区分截止日期与提醒发送时间，以及带时区的时间。批量操作前，先预览明确的 ID 集合；不要把会变化的查询重新运行并当作操作计划。删除、工作区变更和远程助手执行都需要用户明确授权；不能仅凭某个标志或捆绑配方推断获得了许可。

分别检查标准输出、标准错误、退出状态和预期的响应格式。**解析失败时，绝不要在不带 --json 的情况下重新运行变更操作。**操作可能已经成功。请保存原始结果，按 ID/当前状态核对，并报告结果未知的情况。适当时可对读取操作进行有限次数的重试；对于创建、保存或委派请求，不得假定其具备未记录说明的幂等性。

项目记忆

只有在用户或既定项目指令授权使用持久化 Fabric 记忆时，才使用 记忆和交接。检索少量相关内容，保留来源信息，并在保存前拟好简洁的笔记。不要上传原始对话，也不要相信启发式脱敏器能够移除所有密钥。

用证据收尾

报告已验证的工作区、找到或更改的 ID、相关源内容以及尚未解决的结果。生成的完成脚本是可执行的 shell 代码；在执行脚本或编辑 shell 启动文件之前，请先检查。此技能中的 CLI 命令不会仅仅因为语法出现在这里就被视为已验证。

当前官方来源，审阅日期：2026-09-13： Fabric CLI 指南。 进行应用 SDK 开发时，请使用 fabric-api，而不是这些终端操作示例。

评论

支持 Markdown