用途：MindOS 是本地知识助手与跨会话、跨 Agent 共享的知识库，存放决策记录、会议纪要、SOP、排错经验、架构选型、调研结论和偏好设置。本技能仅处理 mindRoot 知识库内任务，不用于改代码仓库、项目源码或 KB 外路径。
主要能力：通过 mindos file 子命令完成知识库操作，加 --json 获取结构化输出。支持 list（列出文件）、read（读取）、write（写入/覆盖）、create（创建）、append（追加）、edit-section（编辑段落）、insert-heading（标题后插入）、append-csv（追加 CSV 行）、delete（删除）、rename（重命名/移动）、backlinks（反向链接）、recent（最近文件）、history（Git 历史）；另有 search 搜索、space list/create 空间管理。
使用方式： 安装：npm install -g @geminilight/mindos 远程模式：mindos config set url http://<IP>:<端口> && mindos config set authToken <token> 仅有 MCP 工具（mindos_*）时可直接使用，有 CLI 时优先用 CLI。
规则要点：先了解目录结构再搜索或写入；默认只读，仅在用户明确要求保存、记录、整理、编辑时写入；写入前先读取，不做整文件覆盖的小修改；多文件编辑先出方案，获批后执行；创建/删除/移动/重命名后同步相关 README。规则优先级：用户当前指令 → .mindos/user-preferences.md → 最近目录 INSTRUCTION.md → 根 INSTRUCTION.md → 技能默认。
限制：禁止写入知识库根目录（除非明确要求）；禁止假设目录名；禁止未确认就修改 INSTRUCTION.md 或 README.md；结构变更后需检查反向链接；超出 KB 范围的代码修改请求不应通过知识库工具处理。
常见错误处理：command not found: mindos → 重新安装；Mind root not configured → mindos onboard；401 Unauthorized → 检查 AUTH_TOKEN（服务器运行 mindos token）；ECONNREFUSED → 服务器启动 mindos start。