AGENT SKILL

skillfs-mount

Help users configure, mount, and unmount a skillfs FUSE virtual filesystem on their local machine (e.g. for openclaw). Covers analyzing existing skill usage to suggest view configuration, generating skillfs-views.toml, mounting, and graceful unmount. Use this skill when the user asks to: set up skillfs, configure skill views, mount or unmount skillfs, check if skillfs is running, or get help organizing their skills directory (especially for openclaw users).

License 许可
Apache-2.0
最近更新
2026-11-14
Stars
★ 665
Forks
195

01 前言 Front Matter

name
skillfs-mount
description
Help users configure, mount, and unmount a skillfs FUSE virtual filesystem on their local machine (e.g. for openclaw). Covers analyzing existing skill usage to suggest view configuration, generating skillfs-views.toml, mounting, and graceful unmount. Use this skill when the user asks to: set up skillfs, configure skill views, mount or unmount skillfs, check if skillfs is running, or get help organizing their skills directory (especially for openclaw users).

02 资源文件 2

03 SKILL.md 正文

skillfs 配置与挂载指南

前提条件

  • skillfs 已安装(RPM 包),运行 skillfs --version 确认
  • 系统已安装 fuse3(若缺失:yum install -y fuse3)
  • 确认 skills 源目录路径(openclaw 用户通常为 ~/.openclaw/skills)

操作流程

STEP 1:了解用户类型,确定主视图

有使用历史的用户(openclaw):

运行脚本分析历史调用频次,按调用次数决定哪些 skill 进主视图:

# 分析 openclaw session 日志中的 skill 使用频次(默认读 ~/.openclaw)
python3 <skill_dir>/scripts/skill_usage_from_session_logs.py

# 分析 copilot-shell (cosh) chat 日志中的 skill 调用统计(默认读 ~/.copilot-shell)
python3 <skill_dir>/scripts/skill_usage_from_chat_logs.py

两个脚本都支持 --logs-dir 指向自定义日志目录。

输出示例:

=== Skill Invocation Statistics ===
  github: 42
  slack: 28
  tmux: 17
  weather: 3

调用频次高的 skill 建议放入主视图,频次低或从未使用的放入次级视图。

纯新用户(无历史):

列出 skills 目录内容,按用途给出分类建议:

ls ~/.openclaw/skills/

常见分类建议:

  • 主视图(高频核心):代码工具、版本管理、常用 API 集成
  • 次级视图:不常用工具、实验性 skill、特定场景用途

STEP 2:生成 skillfs-views.toml

根据分析结果,运行 classify 命令生成初始配置:

skillfs classify ~/.openclaw/skills --primary-count 8

生成的 ~/.openclaw/skills/skillfs-views.toml 结构(视图名称固定为 major / other):

[[view]]
name = "major"
default = true
description = "Core skills shown at mount time"
skills = ["github", "slack", "tmux", ...]

[[view]]
name = "other"
default = false
description = "Additional skills accessible via skill-discover"
skills = ["weather", "notion", ...]

挂载行为由 default = true/false 决定,视图名称仅作为 skill-discover 中的分组标题显示。

按分析结果手动调整:直接编辑 views.toml,在两个 skills 列表之间移动 skill 名称。

⚠️ views.toml 中的字符串必须与 skill 的目录名完全一致,否则该技能将从视图中 消失。目录名是权威的 skill key;SKILL.md frontmatter 里的 name: 只是展示元数据, 不参与视图匹配,重命名目录后也不会覆盖目录 key。


STEP 3:挂载

# 原地挂载(推荐):Agent 访问同一路径,FUSE 透明过滤内容
skillfs mount ~/.openclaw/skills ~/.openclaw/skills \
  --pid-file /tmp/skillfs.pid \
  --log-file /tmp/skillfs-{pid}.log &
sleep 1

# 确认挂载成功
ls ~/.openclaw/skills/    # 应只显示主视图 skill + skill-discover

挂载时将未分配到任何视图的新 skill 纳入内存中的默认视图,不改写 skillfs-views.toml。需要持久化分配时显式编辑配置,修改后重挂载生效。

需要长期保持挂载时改用 managed 模式:它启动一个 detached supervisor,worker 意外退出后 会自动重挂,不需要自己管理 pid file。

skillfs mount ~/.openclaw/skills ~/.openclaw/skills --managed

STEP 4:验证挂载状态

# 检查进程是否存活
kill -0 $(cat /tmp/skillfs.pid) 2>/dev/null && echo "mounted" || echo "not mounted"

# 查看实时日志
tail -f /tmp/skillfs-$(cat /tmp/skillfs.pid).log

STEP 5:卸载

# managed 挂载:用 stop 停止 supervisor 并卸载
# 非 managed 或残留挂载:stop 也会直接卸载,可作为通用兜底
skillfs stop ~/.openclaw/skills

# 前台挂载也可以直接向进程发信号
kill -TERM $(cat /tmp/skillfs.pid)
sleep 1

# 卸载后目录恢复完整内容
ls ~/.openclaw/skills/

# 若进程意外退出,手动清理残留挂载:
fusermount3 -u ~/.openclaw/skills

PID 文件在卸载成功后自动删除。


关键说明

  • SkillFS 不是只读文件系统:挂载期间对 skill 的写入(含 install / update / remove) 会透传到底层 source 树,写 SKILL.md 还会触发重新解析
  • 但 views.toml 是例外:挂载期间它对 FUSE 不可见,需修改时先卸载
  • 不生成 views.toml 也可直接挂载,此时所有 skill 均在主视图中可见
  • 该工作区不能同时作为 ws-ckpt 工作区根初始化 —— in-place 挂载会让 rename(2) 返回 EBUSY。先 init 再挂载,或先卸载再 init

故障排查

错误 解决方案
Package fuse3 was not found yum install -y fuse3 fuse3-devel
Transport endpoint is not connected fusermount3 -u <mountpoint> 后重新挂载
skill 消失于列表 统一 skill 目录名与 views.toml 字符串(不是 SKILL.md 的 name:)
skill-discover 不完整 重新运行 skillfs classify 或手动编辑 views.toml
原地挂载后无法写 views.toml 先卸载,编辑,再重新挂载

04 同仓库更多 Skills

agentic-os-org
agentic-os-org/ANOLISA

ws-ckpt

Linux 工作区快照(ws-ckpt)。用户想保存或备份工作区当前状态("保存一下"、"留个底"、"先备份"), 想撤销或恢复文件改动("回滚"、"撤销"、"改回去"、"恢复到之前"、"刚才那版"), 想查看、对比或删除历史版本,或要开启/关闭每回合自动快照、定时快照、快照保留策略时使用。 用户没提"快照"、只表达保存或恢复工作区文件的意图时同样适用;用户点名 git 操作(commit、branch、reset 到某提交)时不适用。

★ 665
agentic-os-org
agentic-os-org/ANOLISA

test-skill

A test skill used in integration tests.

测试与质量Skill与智能体开发
★ 665
agentic-os-org
agentic-os-org/ANOLISA

storage-resize

Linux 磁盘扩容技能(RPM 包管理系统),实现云盘扩容后自动完成分区调整和文件系统扩容。支持系统盘/数据盘在线扩容,适配 XFS/EXT4/Btrfs 文件系统。适用于 RPM 包管理的 Linux 系统(如 Alibaba Cloud Linux)。

★ 665
agentic-os-org
agentic-os-org/ANOLISA

ktuner

内核参数自动调优。分析系统配置,输出调优建议并可一键应用,支持自动回滚。使用场景:系统性能优化、安全加固、内核参数诊断。

★ 665
agentic-os-org
agentic-os-org/ANOLISA

backup-restore

处理所有备份与恢复任务,覆盖四个层面:工作区(项目/数据库/代码)、用户数据(家目录/dotfiles/密钥)、操作系统(全量系统/磁盘镜像/LVM 快照)、阿里云快照(云盘快照/自动策略/跨地域复制/整机镜像)。适用于 RPM 包管理的 Linux 系统(如 Alibaba Cloud Linux)纯命令行环境,使用 yum 包管理器。当用户提到备份、恢复、快照、归档、回滚、克隆、迁移、容灾等任何涉及数据保存或恢复的请求时触发此技能,即使请求看起来很简单也应使用。

★ 665
agentic-os-org
agentic-os-org/ANOLISA

linux-admin

此技能专为 Alibaba Cloud Linux 4 (ALinux 4) 设计,用于管理 Linux 服务器、编写 shell 脚本、配置 systemd 服务、管理网络。触发场景包括:bash 脚本编写、systemd 单元、SSH 配置、firewalld 防火墙配置、NetworkManager 网络管理、文件权限、进程管理、磁盘管理、文件系统操作,以及任何需要 ALinux 4 系统管理的任务。

★ 665