用途
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协助查找;若存在多个团队,需询问用户要报告哪个团队。 - 报告中健康度评分为基于数据的主观判断。
- 未提供具体价格、收费或平台等信息。