核心用法
feishu-wiki 是一款面向飞书生态的知识库管理 Skill，通过调用飞书 Wiki v2 官方 API 实现知识空间与页面节点的全生命周期管理。其核心能力涵盖三大维度：空间管理（创建知识空间、获取空间列表）、节点管理（创建多级目录结构、移动与重命名节点）以及资产挂载（将现有云文档、表格等外部资产一键入库）。使用时需先通过 tenant_access_token 完成认证，随后即可调用标准化 RESTful 接口完成操作。特别值得注意的是，该 Skill 采用"群组授权法"解决权限穿透问题——将机器人加入群组并设为空间管理员，即可获得完整的节点操作权限。
显著优点
生态原生集成：深度对接飞书官方 API，与飞书文档、多维表格等核心产品无缝衔接，支持 docx、、sheet、、bitable 等多种文档类型的节点创建。自动化知识治理：能够批量构建标准化目录树，实现项目立项时的"入场即标准化"，大幅降低人工维护成本。权限模型清晰：通过群组授权机制巧妙解决企业级权限管控难题，兼顾安全性与可操作性。场景覆盖全面：从 SOP 自动化沉淀、项目全生命周期建档到存量资产智能整理，覆盖企业知识管理的典型高频场景。
潜在缺点与局限性
权限配置门槛：首次使用需手动完成群组创建与授权配置，对非技术用户存在一定学习成本。功能边界明确：仅负责知识空间的"骨架搭建"，文档内容写入需配合 feishu-doc-writer 等 Skill 使用，无法独立完成端到端的内容生产。Token 体系复杂：node_token（目录位置标识）与 obj_token（真实文档标识）容易混淆，跨接口调用时需额外注意参数映射。API 依赖性强：所有操作均依赖飞书服务端，网络波动或 API 变更可能影响稳定性，暂无本地缓存或离线能力。
适合的目标群体
该 Skill 主要面向三类用户：一是企业知识管理负责人，需要构建可扩展的知识中台并制定标准化归档规范；二是项目经理与 Scrum Master，希望在项目启动阶段快速搭建文档协作框架；三是飞书生态开发者，寻求与现有办公流程集成的自动化解决方案。特别适合已深度使用飞书、文档协作需求旺盛的中大型团队。
使用风险
性能风险：批量创建大量节点时可能触发飞书 API 速率限制，建议增加请求间隔与重试机制。依赖风险：紧密耦合飞书 Wiki v2 API，若官方接口升级或字段变更，需及时跟进适配。权限风险：群组授权后机器人获得空间管理员权限，需严格管控群组成员，避免权限扩散。数据一致性风险：节点移动操作涉及 target_space_id 与 target_parent_token 双参数，配置错误可能导致目录结构异常，建议在测试环境验证后再投入生产。