腾讯 Coding 平台周报

周报从哪来、写多久

在腾讯 Coding DevOps 上协作时，一周的项目进展、缺陷与需求、流水线结果、提交与合并请求往往分散在多个项目与成员视图里。手工汇总既要反复翻事项与构建页，又容易漏掉某条 MR 或某天的提交节奏，周报写成「数据摘录」而不是可对照的统计。

技能如何工作

本技能通过 Coding OpenAPI 在指定自然周（默认当周周一起，日期格式 YYYY-MM-DD）内拉取数据，并输出 Markdown 周报，可按三种粒度生成：

• 团队周报：覆盖团队内项目与成员的整体画像
• 成员周报：聚焦指定成员的事项与代码活动
• 项目周报：单项目的进度与工程指标

报告结构大致包括：

1. 总览：项目数、成员数、事项总量与完成率，以及构建、提交、MR 的汇总
2. 事项统计：按类型（需求/任务/缺陷）、状态、负责人、项目分布
3. 构建统计：构建次数、成功率、平均耗时，按项目与 Job 拆分
4. 提交统计：提交总量、按日趋势、活跃贡献者
5. 合并请求：MR 数量与合并率，按创建者与项目统计

使用前需在技能目录配置 .env（参考 .env.example）：CODING_TEAM_DOMAIN、CODING_ACCESS_TOKEN 等。访问令牌需在个人设置中创建，并具备文档列出的只读权限（如 project:profile:ro、collaboration:issue:ro、ci:job:ro、git:commit:ro 等）。可用 --project-ids、--member-ids 收窄范围，或用 --no-* 排除某类数据；脚本会对大数据集做分页，并缓存成员/项目名称。

适用边界与注意点

• 仅统计指定时间范围内平台已有数据；若当周无事项或仓库无活动，会出现「无数据」类情况，需核对日期与项目/成员是否存在。
• Coding API 有限流（每团队每端点约 30 次/秒），大范围报表采集会较慢，可结合进度日志定位卡点。
• 访问令牌勿提交到版本库；令牌过期或权限不足会导致 API 报错，需重新签发并核对权限范围。