用途
Group Knowledge Report(团队知识月报)用于从语雀(Yuque)采集团队数据,生成一份详细的月度知识管理报告。它面向需要定期复盘团队文档健康度与活跃度的场景,例如按月回顾团队文档产出、成员贡献和知识库更新情况。
主要能力
该技能通过 yuque-mcp 服务器的一组工具完成数据采集与报告生成:
- yuque_group_stats:获取团队整体统计(成员总数、文档总数、知识库总数、整体活跃度指标)。
- yuque_group_member_stats:获取每位成员的贡献数据(文档数、字数、活跃度细分)。
- yuque_group_book_stats:获取每个知识库的统计(文档数、更新频率、增长指标)。
- yuque_group_doc_stats:获取文档活跃度统计(新建、更新、浏览量、热门文档)。
- yuque_create_doc:创建月报文档并归档。
在数据分析层面,技能会计算:整体健康度(文档总量与环比增长、活跃贡献者比例、文档产出速度)、成员分析(Top 贡献者、贡献分布是否集中、本月零贡献成员)、知识库分析(最活跃知识库、本月无更新的停滞知识库、增长率)以及趋势(月内逐周活动、与上月对比,如数据可用)。
使用方式
- 确定团队与周期:需要用户提供团队标识(group login),报告月份默认为上一个月。若用户未指定,技能会提示“请告诉我团队的语雀团队标识(group login),我来生成知识月报。”
- 采集数据:依次调用上述四个统计工具。
- 分析数据:计算健康度、成员贡献、知识库活跃度和趋势等洞察。
- 生成报告:按内置模板产出 Markdown 报告,包含月度概览表、健康度评分(⭐)、成员贡献(Top 贡献者、贡献分布)、知识库分析(活跃与需关注)、趋势分析(周度活动、关键发现)、建议(短期与长期)和附录(数据说明)。
- 保存到语雀:调用 yuque_create_doc,参数包括 repo_id(如 "mygroup/mybook")、标题“团队知识管理月报 - YYYY年MM月”、body(格式化后的报告)和 format: "markdown"。
- 确认:输出文档链接、归档知识库名称以及本月亮点(新文档数、更新数、活跃成员占比、最活跃知识库、最大贡献者)。
适用场景
- 用户明确要求生成知识月报,或说出“生成知识月报”“knowledge report”“团队知识管理月报”等触发语。
- 团队按月复盘文档健康度与活跃度。
- 需要识别贡献集中风险(bus factor)、停滞知识库和低活跃成员时。
限制与注意事项
- Token 需要具备 statistic:read 权限,否则无法获取统计数据。
- 健康度评分(⭐)是基于数据的主观评估;贡献分布需关注知识创作是否过于集中;建议应具体可执行;若缺少环比数据,应省略对比列而不编造。
- 当统计接口失败时,需提示用户检查团队标识和 Team Token;若数据不完整,用已有数据生成报告并标注缺口;若团队活跃度极低,仍应生成报告并将建议聚焦于如何改进;用户不知道 group login 时可通过 yuque_list_repos 帮助查找;存在多个团队时需询问用户报告哪个团队。默认语言为中文。
- 本技能的具体价格、平台支持范围、性能效果等信息暂未提供。