前言¶
协作里常见「最终版」「最终版2」「真的最终版」并存，网盘里同名文件叠了好几层，谁改了什么只能靠口头问。Git 管代码很合适，但方案、合同、报告这类办公文档往往不在仓库里，也未必值得上 Confluence 或语雀。下面介绍 SkillHub 上的社区 Skill「文档版本管理」（@user_70c2f807/document-version-manager）：让 AI 按固定流程帮你诊断现状、设计命名与版本号规则、输出可执行的 SOP 和对比模板，而不是替你直接改磁盘上的文件。
这是什么¶
「文档版本管理」是发布者 user_70c2f807 在 SkillHub 上架的社区 Skill（office-efficiency 分类，当前版本 1.0.0），基于通用 SKILL.md 格式。它面向文件命名混乱、需要追溯修订、要在版本间做差异核对、或要给团队定一套轻量文档版本制度的场景；明确不用于 Git/代码版本控制、云存储搭建、备份恢复，也不负责代写文档正文。标签标明 requires_api_key=false，安装后无需额外 API Key。
核心功能¶
以下能力均来自该 Skill 的说明文档，Agent 被触发后会按步骤产出方案与模板，由人在本地或网盘执行。
- 命名规范设计：按团队场景给出统一命名规则与正反例。
- 版本号体系：例如主版本.次版本，以及定稿后缀（如
_FINAL）等文档向规则。 - 变更日志模板：表格化记录版本、日期、修改人、修改内容与审批人。
- 对比检查清单：辅助识别两版方案等文档的关键差异（配合你提供的文件或描述）。
- 存储结构规划：文件夹层级、历史版本归档位置（如
历史版本/子目录）。 - 流程 SOP：从现状诊断到规范设计、渐进推行与定期 review 的可执行说明。
内置执行路径概括为三步：现状诊断（痛点、文档类型、规模、存储工具）→ 规范设计（命名、版本号、目录、变更日志）→ 落地方案（SOP、检查清单、推行计划、清理策略）。输出中会包含示例命名格式、版本号对照表、目录树示意和变更日志表头。
安装与启用¶
先确认本机是否已有 SkillHub CLI：
command -v skillhub && skillhub --version
未安装时可按 SkillHub 官方安装说明执行完整安装（CLI + 默认 Skill）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
仅装 CLI 时：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only
安装本 Skill 时必须用 --dir 指向当前 Agent 的 skills 目录，否则默认落在 ./skills/ 可能不会被识别。坐标与命令如下：
skillhub install document-version-manager --namespace user_70c2f807 --dir <你的 skills 目录>
常用客户端 skills 路径（以 SkillHub 安装文档为准）：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或项目下的.agents/skills/
也可在对话里让 AI 按 SkillHub 安装说明 安装 @user_70c2f807/document-version-manager。SkillHub 页面给出的提示词即指向该文档与上述坐标。
典型用法¶
在已启用该 Skill 的 Agent 中，用自然语言描述痛点即可触发。官方「快速开始」中的示例包括：
我们团队文件命名特别乱，"最终版""最终版2""真的最终版"到处都是，帮我设计一套命名规范
帮我设计一个文档版本管理流程，让大家都能找到最新版
我需要对比两个版本的方案文档有什么修改，帮我设计对比模板
怎么管理合同类文档的版本，确保签署的是最新审批版？
经过上面的步骤，Agent 会按 Skill 中的输出格式给出「文档版本管理规范」类结果，例如命名格式 [项目代号]_[文档类型]_[简要描述]_V[主版本].[次版本]_[日期]、版本号变更对照表、带 历史版本/ 的目录结构示意，以及变更日志表模板。合同类场景 Skill 建议增加审批状态后缀（如 _DRAFT / _REVIEW / _APPROVED / _SIGNED），定稿后不再改源文件、可导出 PDF 标注 FINAL。
适用场景与注意¶
适合：中小团队、项目制协作、本地或网盘存文档、希望先有一套可讨论的规范再考虑专业 DMS；个人整理自己的方案/报告版本也适用。
限制（Skill 原文要求提前说明）：
- Agent 不能直接操作你的文件系统，只输出规则与方案，执行靠人。
- 不替代 Confluence、语雀等专业文档平台，定位是轻量流程与模板。
- 规范需要团队统一执行才有意义；仅个人遵守效果有限。
- 历史版本会占空间，需配合保留策略（Skill 示例：保留最近若干版本 + 所有 FINAL，其余定期清理）。
勿误用：代码用 Git；灾难恢复靠备份而非版本命名；复杂协同编辑应优先在线文档工具；敏感合同等需配合权限与合规留存要求。
SkillHub 统计（以页面抓取为准）：评分 100000，下载 907，来源 community；与你手头其他渠道的下载/评分数字若不一致，以 SkillHub 页面实时数据为准。
结尾¶
「文档版本管理」把办公文档的版本痛点拆成可复用的诊断、规范与 SOP 输出，适合在已有 AI 客户端里用一句话拉起整套制度设计。安装与详情见 SkillHub：
- 技能页：https://www.skillhub.cn/skills/user_70c2f807/document-version-manager
- API 条目：https://api.skillhub.cn/user_70c2f807/document-version-manager
