前言¶
团队知识库越写越多，常见问题不是「有没有文档」，而是「这篇该归哪一类、和哪几篇是一组」。只靠文件夹往往只能单维度归档；标签若没人维护，又会越打越乱。下面介绍 SkillHub 上的社区 Skill「知识库标签化」：在 Agent 里按固定流程分析你提供的文档信息，设计标签体系、批量打标、建立关联，并输出可导入现有工具的目录树方案。它不连接企业内部系统，也不替代 Notion、Confluence 等知识库产品，而是把「整理规则」写进 SKILL.md，由模型按步骤交付结构化结果。
这是什么¶
「知识库标签化」（坐标 @user_70c2f807/knowledge-base-tagging，版本 1.0.0）是 SkillHub 社区来源（community）的 Agent Skill，分类为 knowledge-management，由发布者 user_70c2f807 维护。Skill 元数据标明 requires_api_key=false，无需额外 API Key。
定位是：针对企业文档与知识库内容，自动推荐标签、设计多层级标签体系、建立文档关联，并生成目录树，缓解「文档找不到」的问题。触发场景包括用户提到知识库、文档标签、打标签、文档分类、目录树、文档关联、知识管理、wiki 整理等；不用于写新文档、全文搜索优化、数据库设计或文件备份。
核心功能¶
以下能力均来自该 Skill 的 SKILL.md 说明：
- 分析文档内容并推荐标签（需你提供标题、摘要或全文）。
- 设计多层级标签体系（一级 / 二级 / 三级），并约定互斥、可多选、必选等规则。
- 为文档分配主标签与辅助标签，建立前置、相关、进阶等关联关系。
- 生成目录树结构（可按主题、类型、受众等维度）。
- 识别标签冗余与缺失，支持批量文档列表打标输出。
- 按 MECE、颗粒度、用户检索习惯等原则输出标签使用指南。
执行上分为四步：理解需求与标签维度 → 设计标签体系 → 逐篇打标并建关联 → 输出清单、目录树与使用指南。单次建议不超过 50 篇文档，以保证标签质量。
安装与启用¶
安装前需本机有 SkillHub CLI。未安装时可按官方安装文档执行完整安装或仅安装 CLI：
command -v skillhub && skillhub --version
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
安装 Skill 时必须用 --dir 指向当前 Agent 的 skills 目录，否则默认落在 ./skills/ 可能不会被识别。该 Skill 的推荐命令为：
skillhub install knowledge-base-tagging --namespace user_70c2f807 --dir <skills 目录>
常用客户端 skills 路径（来自 SkillHub 安装说明）：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或项目下的.agents/skills/
也可让 Agent 参照 https://skillhub.cn/install/skillhub.md，安装 @user_70c2f807/knowledge-base-tagging。安装后按所用客户端要求重启或刷新 Agent，使 Skill 生效。
SkillHub 页面当前统计（以抓取资料为准）：评分 100000，下载 1068 次，安装计数 0。
典型用法¶
Skill 在对话中的入口是自然语言。下面几类请求与官方「快速开始」一致，可直接复现：
- 批量打标
用户：帮我给这批文档打标签
→ 请提供文档列表（标题+摘要即可），以及希望的标签维度
- 技术文档分类
用户：我有30篇技术文档，想分类整理
→ 请列出标题，我来设计标签体系并逐一打标
- 重整混乱标签
用户：现有标签太混乱，帮我重新设计
→ 请提供现有标签列表，我来优化合并并设计层级结构
- 生成目录树
用户：帮我生成知识库目录树
→ 提供文档列表，我按主题/类型/受众生成多维度目录
- 文档关联
用户：怎么找到相关文档的关联？
→ 我可以根据内容相似度和主题关系建立文档关联图
交付物通常包含：标签体系（一级 / 二级示例）、文档标签结果表（主标签、辅助标签、关联文档）、目录树，以及标签使用指南。FAQ 中说明：一篇文档可采用 1 个主标签加 1～3 个辅助标签；生成的方案为标准格式，可手工或批量导入 Notion、Confluence 等工具。
适用场景与注意¶
适合谁
- 已有大量文档或 wiki 片段，需要统一标签维度和目录结构的知识管理员、技术写作或研发团队。
- 希望先在小范围类目试点标签体系，再逐步推广的团队。
限制与坑
- 无法自动访问内部系统，必须提供文档标题、摘要或全文；仅凭标题难以准确打标时，Skill 会要求补充摘要或关键词。
- 首次使用建议确认或提供现有分类标准；标签体系需要迭代，不宜一次设计过深（Skill 建议层级不超过 3 层）。
- 超过 50 篇应分批处理；内容高度同质时需增加版本、场景、受众等细分维度。
- 不存储用户文档与标签数据，但涉及商业机密时仍建议脱敏后再提供内容。
不适用
编写新文档、搜索引擎调优、数据库建模、文件备份等场景，Skill 明确建议改用对应专业工具或流程。
结尾¶
「知识库标签化」把标签设计、批量打标、关联与目录树输出固化成 Agent 可执行的步骤，适合在已有文档材料的前提下做结构化整理。官方 Skill 页与 API 入口：
- https://www.skillhub.cn/skills/user_70c2f807/knowledge-base-tagging
- https://api.skillhub.cn/user_70c2f807/knowledge-base-tagging
