SuperAPI AI 工具集

knowledge-report

办公与效率

查看项目

更新于 10-16 08:54

技能介绍

用途

Knowledge Report(团队知识管理月报)用于从语雀(Yuque)采集团队协作数据,生成一份详尽的月度知识管理报告。它面向希望定期复盘团队文档健康度、成员贡献和知识库活跃情况的场景。

触发时机包括:用户想要一份月度知识管理报告;用户说出“生成知识月报”“knowledge report”“团队知识管理月报”;或团队需要进行文档健康度与活跃度的月度审查。

主要能力

该技能从语雀 MCP 服务器调用统计工具采集数据,并据此分析、生成报告:

  • yuque_group_stats:获取团队整体统计(成员总数、文档总数、知识库总数、整体活跃指标)。
  • yuque_group_member_stats:获取每位成员的贡献数据(文档数、字数、活跃明细)。
  • yuque_group_book_stats:获取每个知识库的统计(文档数、更新频率、增长指标)。
  • yuque_group_doc_stats:获取文档活跃统计(新建文档、更新文档、浏览量、热门文档)。
  • yuque_create_doc:创建月报文档。

基于采集数据,技能会计算如下洞察:整体健康度(文档总量与环比增长、活跃贡献者占比、文档产出速度)、成员分析(Top 贡献者、贡献分布是否集中、未活跃成员)、知识库分析(最活跃知识库、停更知识库、增长率)、趋势(月内按周活跃度、与上月对比)。

报告模板包含:月度概览表(总文档数、新建/更新文档、总浏览量、活跃成员、知识库数及环比)、健康度评分(文档产出、参与度、覆盖度、更新频率)、成员贡献(Top 贡献者表、贡献分布)、知识库分析(活跃知识库、需要关注的知识库)、趋势分析(周度活动趋势、关键发现)、建议(短期可执行与长期持续改进)以及附录(数据说明)。

使用方式

第 1 步:确定团队与周期。 向用户收集团队标识(group login,必填)和报告月份(默认为上一个月)。若用户未指定,提示:“请告诉我团队的语雀团队标识(group login),我来生成知识月报。”

第 2 步:采集数据。 依次调用上述四个统计工具,参数为团队 login。

第 3 步:分析数据。 计算整体健康度、成员分析、知识库分析和趋势。

第 4 步:生成报告。 按模板填充内容,默认语言为中文。健康度评分(⭐)是基于数据的主观评估,应诚实但具建设性;贡献分布若过度集中,需提示 bus factor 风险;建议应具体可执行;若缺少环比数据,应省略对比列而非编造。

第 5 步:保存到语雀。 使用 yuque_create_doc,参数包括 repo_id(如 "mygroup/mybook")、标题(如“团队知识管理月报 - YYYY年MM月”)、body(格式化报告)与 format: "markdown"。

第 6 步:确认。 输出生成成功的提示,包含文档链接、归档的知识库名称,以及本月亮点(新文档数、更新数、活跃成员占比、最活跃知识库、最大贡献者)。

适用场景

  • 团队每月知识管理复盘。
  • 查看成员文档贡献分布。
  • 评估知识库活跃度与停更情况。
  • 跟踪团队文档健康度与周度趋势。

限制与注意事项

  • 依赖语雀 MCP 服务器提供全部统计工具。
  • 团队 Token 需要具备 statistic:read 权限,否则会提示缺少该权限。
  • 若 yuque_group_stats 调用失败,需提示用户检查 group login 与团队 Token。
  • 若任一统计 API 仅返回部分数据,则用已有数据生成报告并标注缺口。
  • 若团队活跃度极低,仍应生成报告,并将建议重点放在如何改进上。
  • 若用户不清楚 group login,可通过 yuque_list_books 协助查找;若存在多个团队,需询问用户要报告哪个团队。
  • 报告中健康度评分为基于数据的主观判断。
  • 未提供具体价格、收费或平台等信息。