← 返回 Skills 市场
78
总下载
0
收藏
0
当前安装
2
版本数
在 OpenClaw 中安装
/install skylv-file-versioning
功能描述
Tracks file changes with git-like versioning for any project
安全使用建议
This skill appears to implement local file versioning and doesn't request network access or credentials, but exercise caution before installing or running it on sensitive directories. Specific points to consider:
- Tag handling bug: SKILL.md promises using tag names (e.g., restore config.json v1.0.0), but the version-parsing function in the included code as shown does not lookup tags; test tag commands carefully and inspect tags.json to confirm behavior.
- Large text files: text files over 10MB are recorded as 'hash-only' while still flagged as text; diffs may be incorrect or misleading for these cases.
- Watch mode: the watch command runs continuously and will snapshot anything you point it at. Only use it on directories/files you trust and intend to version; do not point it at system or secret-containing directories unless you understand the consequences.
- Review full source before use: the provided code snippet is truncated in the listing; inspect the rest of version_engine.js to ensure there are no hidden network calls, telemetry, or operations beyond local file I/O.
If you need to proceed: run the tool in a sandbox or on a non-sensitive test directory, verify tag/restore/diff behaviors, and confirm that snapshots are stored only where you expect (.fvsnap next to target files).
能力标签
能力评估
Purpose & Capability
Name/description promise git-like file versioning and the package includes a Node.js engine (version_engine.js) that snapshots files to a local .fvsnap directory, shows history, diffs, tags, restore, compare and watch — which is coherent with the stated purpose. No external credentials, binaries, or network access are requested.
Instruction Scope
SKILL.md instructs the agent to run node version_engine.js commands and to snapshot/restore files — expected. However, there are mismatches between the documentation and code: parseVersion in the provided code does not resolve tag names (it only understands HEAD, HEAD~N, or numeric versions), yet SKILL.md repeatedly describes tagging and using tag names (e.g., restore <file> v1.0.0). There are also edge-case behaviors (text files > 10MB are stored as hash-only but are still marked isText, which may produce confusing diffs). These incoherences mean the skill may behave differently than described.
Install Mechanism
No install spec and no external downloads — the skill is instruction-only plus included source files. This is the lower-risk delivery model (nothing is pulled from arbitrary URLs during install).
Credentials
The skill requests no environment variables, credentials, or config paths. Its file and directory reads/writes are limited to paths specified by the user (it writes a local .fvsnap directory next to tracked files), which is proportionate to its purpose.
Persistence & Privilege
always is false and the skill does not request persistent platform privileges. It writes only to per-project .fvsnap directories and tags.json within those directories; it does not attempt to modify other skills or system-wide agent settings in the provided code.
如何使用
- 确保已安装 OpenClaw（本地或 Docker 部署）
- 在对话框中输入安装命令：
/install skylv-file-versioning - 安装完成后，直接呼叫该 Skill 的名称或使用
/skylv-file-versioning触发 - 根据 Skill 的参数说明提供必要输入，即可获得结构化输出
版本历史
v1.0.1
- Added a front matter section to SKILL.md with concise description, keywords, name, and triggers.
- Included an explicit "Install" section at the end, detailing how to add the skill using OpenClaw.
- No functional or API changes; documentation and metadata improvements only.
- Existing technical content, usage, and features remain unchanged.
v1.0.0
Initial release: Git-style version control for any file with snapshots, diffs, tags, and restore—no git required.
- Capture file snapshots with metadata and hash, stored locally in a `.fvsnap` directory.
- View complete file history with versioning, messages, and hashes.
- See detailed diffs (including binary-aware comparison and color-coded text changes).
- Tag file versions for easy reference and restore to any previous state (or tag).
- Monitor files/directories for changes and auto-snapshot on modification.
- Compare any two files, regardless of version history.
- Pure Node.js operation—no external dependencies or git required.
元数据
常见问题
Skylv File Versioning 是什么？
Tracks file changes with git-like versioning for any project. 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件，目前累计下载 78 次。
如何安装 Skylv File Versioning？
在 OpenClaw 或 Claude Code 对话框中运行命令「/install skylv-file-versioning」即可一键安装，无需额外配置。
Skylv File Versioning 是免费的吗？
是的，Skylv File Versioning 完全免费，采用 MIT-0 许可证，可自由下载、安装和使用。
Skylv File Versioning 支持哪些平台？
Skylv File Versioning 跨平台运行，可在任意部署了 OpenClaw / Claude Code 的环境中使用（cross-platform）。
谁开发了 Skylv File Versioning？
由 SKY-lv（@sky-lv）开发并维护，当前版本 v1.0.1。
推荐 Skills