从腾讯 Coding DevOps 平台生成周报,内容包括项目进度、问题(Issues)、构建(Builds)、提交(Commits)以及合并请求(Merge Requests)。
Tencent Coding Weekly Report. 由 Tencent Coding DevOps 平台提供每周全面报告,包括项目进度、问题跟踪、CI/
功能概述
Tencent Coding Weekly Report. 由 Tencent Coding DevOps 平台提供每周全面报告,包括项目进度、问题跟踪、CI/是一项面向实际任务的技能。它将相关步骤、工具调用和结果整理方式集中到统一流程中,帮助使用者更快完成目标并减少重复操作。
核心要点
- 使用时应结合输入条件选择合适的执行方式,核对必要参数、依赖环境与输出内容,并按原始要求处理异常情况。
- 该技能适合需要稳定复用相关能力的场景,可作为自动化工作流的一部分,也便于后续检查、调整和扩展。
- 从功能定位来看,该技能强调把分散的操作要求整理成清晰、可复用的处理流程,使用户能够围绕既定目标快速准备输入、选择执行方式并获得结构化结果。
使用与执行
实际使用前应先确认任务范围、数据来源、运行环境、必要权限和关键参数,再依据技能说明逐步执行;若输入条件不完整,应先补齐信息或采用保守配置,避免因错误假设导致结果偏离需求。
结果检查与注意事项
执行过程中需要关注工具调用是否成功、接口或依赖是否可用、输出格式是否符合预期,并对异常提示、缺失字段和边界情况进行处理;涉及批量任务时,还应保存进度,避免中断后重复操作。
腾讯 Coding 周报生成工具
从腾讯 Coding DevOps 平台自动生成全面的周报,涵盖项目进展、问题跟踪、CI/CD 构建、代码提交及合并请求(MR)等维度。
概述
本技能面向使用腾讯 Coding DevOps 平台的团队,提供自动化的周报生成功能。它跨项目、团队成员、问题(issue)、构建(build)、代码提交(commit)和合并请求(MR)等多个维度采集数据,并输出格式化 Markdown 报告。
快速开始
- 配置环境变量(详见「配置」章节)
- 生成团队级周报:
python {baseDir}/scripts/coding_report.py generate
- 生成指定成员的周报:
python {baseDir}/scripts/coding_report.py member
- 生成指定项目的周报:
python {baseDir}/scripts/coding_report.py project
配置
必需的环境变量
在技能目录下创建 .env 文件(参考 .env.example):
# 团队域名前缀(例如 your-team.coding.net 中的 your-team) CODING_TEAM_DOMAIN=your-team # 访问令牌(个人令牌或项目令牌) CODING_ACCESS_TOKEN=your-access-token-here
获取访问令牌
- 登录 Coding DevOps 平台
- 进入「个人设置」→「访问令牌」
- 创建新令牌,并授予以下必要权限:
project:profile:ro— 读取项目信息team:member:ro— 读取团队成员project:depot:ro— 读取代码仓库collaboration:issue:ro— 读取问题(issue)ci:job:ro— 读取构建任务(build job)git:commit:ro— 读取提交记录(commit)
使用方法
生成团队周报
为整个团队生成一份综合周报:
# 生成当前自然周的报告
python {baseDir}/scripts/coding_report.py generate
# 指定周起始日期(格式:YYYY-MM-DD)
python {baseDir}/scripts/coding_report.py generate --start-date 2026-03-21
# 指定输出文件路径
python {baseDir}/scripts/coding_report.py generate --output team_report.md
# 按项目 ID 过滤(逗号分隔的 ID 列表)
python {baseDir}/scripts/coding_report.py generate --project-ids 1,2,3
# 按成员 ID 过滤(逗号分隔的 ID 列表)
python {baseDir}/scripts/coding_report.py generate --member-ids 1,2,3
# 排除构建数据
python {baseDir}/scripts/coding_report.py generate --no-builds
# 排除提交数据
python {baseDir}/scripts/coding_report.py generate --no-commits
# 排除合并请求(MR)数据
python {baseDir}/scripts/coding_report.py generate --no-mrs
生成成员周报
为指定团队成员生成周报:
# 为成员 ID 123 生成报告
python {baseDir}/scripts/coding_report.py member 123
# 指定日期范围与输出文件
python {baseDir}/scripts/coding_report.py member 123 --start-date 2026-03-21 --output member_report.md
生成项目周报
为指定项目生成周报:
# 为项目 ID 456 生成报告
python {baseDir}/scripts/coding_report.py project 456
# 指定日期范围与输出文件
python {baseDir}/scripts/coding_report.py project 456 --start-date 2026-03-21 --output project_report.md
检查当前配置
验证当前环境变量配置是否有效:
python {baseDir}/scripts/coding_report.py config
报告内容
生成的周报包含以下模块:
1. 概览
- 项目总数与团队成员总数
- 问题总数及完成率
- 构建、提交与合并请求(MR)统计指标
2. 问题(Issue)统计
- 按类型分布(需求 / 任务 / 缺陷)
- 按状态分布(已完成 / 进行中 / 待办)
- 按负责人(assignee)统计
- 按项目统计
3. 构建(Build)统计
- 构建总数与成功率
- 平均构建耗时
- 按项目统计
- 按构建任务(job)统计
4. 代码提交(Commit)统计
- 提交总数
- 日级提交趋势
- 最活跃贡献者排行
5. 合并请求(MR)统计
- MR 总数与合入率(merge rate)
- 按创建者(creator)统计
- 按项目统计
高级选项
日期格式
所有日期参数均采用 YYYY-MM-DD 格式;若未指定周起始日,则默认为当前自然周的周一。
输出格式
报告以 Markdown 格式生成,便于阅读,且兼容各类文档平台。
过滤功能
可通过 --project-ids 和 --member-ids 参数聚焦特定项目或成员;也可使用 --no-* 类标志(如 --no-builds)在无需某类数据时主动排除。
故障排查
常见问题
配置错误:CODING_TEAM_DOMAIN 未设置
- 请确认
CODING_TEAM_DOMAIN已在.env文件或系统环境变量中正确设置
API 错误:访问令牌无效
- 请确认
CODING_ACCESS_TOKEN有效,且已授予所需权限 - 检查令牌是否已过期
指定时间范围内未查到数据
- 请确认所选日期范围与实际数据产生时间匹配
- 检查对应项目、成员或代码仓库是否存在
触发限流错误
- Coding API 对每个团队的每个端点设有限流策略(30 次请求/秒)
- 大型报告可能需要较长时间生成,请耐心等待
调试模式
脚本在数据采集过程中会输出进度提示信息,可据此定位异常发生的具体环节。
参考资料
- Coding DevOps OpenAPI 文档
- 访问令牌管理说明
- 详细 API 参考请参阅
references/coding-api.md
注意事项
- API 请求受速率限制,上限为每团队每秒 30 次请求
- 工具自动处理大数据集的分页逻辑
- 敏感信息(如访问令牌)严禁提交至版本控制系统
- 报告仅包含指定时间范围内产生的数据
- 成员名与项目名会被缓存,以提升后续报告生成效率
热门AI工具
相关专题
本专题聚焦GoFrame框架的Web开发,拆解路由注册与匹配规则、请求参数获取、参数校验与中间件执行顺序,说明统一响应、JWT鉴权、文件上传与接口文档生成的落地方式,并补充优雅重启与测试实践。
0
2026.11.17
本专题围绕GoFrame框架的安装与工具链配置展开,讲清Go版本要求、gf命令行的安装方式、代理镜像与依赖准备,说明项目初始化、热编译、交叉编译打包的做法,并整理安装阶段的常见报错与验证步骤。
0
2026.11.17
本专题整理GoFrame框架的入门知识,从模块化设计理念、环境准备到跑通第一个Web服务,讲清目录分层、配置加载、日志与中间件的用法,并对比Gin、Go-Zero的差异,帮助Go开发者建立整体认知。
0
2026.11.17
SQLAlchemy 一对多关系怎么建立?本专题整理父子表外键、relationship 双向映射、关联查询、级联删除和加载优化等相关文章,帮助你理解并实现常见的 ORM 关系建模。
0
2026.11.17
SQLAlchemy 如何增删改查?本专题整理 ORM 新增记录、条件查询、更新和删除、Session 事务提交与批量处理等实用文章,帮助你掌握 Python 数据库操作流程。
0
2026.11.17
SQLAlchemy ORM 模型怎么写?本专题整理模型类定义、Mapped 字段映射、主键与约束、表结构创建和常见报错的相关文章,帮助你从基础配置到实际建模逐步掌握 SQLAlchemy。
0
2026.11.17
本专题聚焦Go-Zero的API开发,拆解.api描述文件的语法结构、路由与分组定义、参数绑定与校验规则,说明统一响应体、JWT鉴权、跨域与接口文档生成的落地方式,并给出网关聚合与接口测试的实践建议。
0
2026.11.12
本专题围绕Go-Zero的安装与工具链配置展开,讲清Go版本要求、goctl安装方式、代理镜像、protoc依赖与环境变量设置,说明多版本共存、升级回退与CI流水线安装的做法,并整理安装阶段的常见报错与验证步骤。
0
2026.11.12
本专题整理Go-Zero的入门知识,从框架定位、环境准备到跑通第一个API服务,讲清目录分层、配置加载、日志与中间件的基本用法,并对比Gin、Kratos的差异,帮助Go开发者建立整体认知,判断它是否适合当前项目。
0
2026.11.12
热门下载
相关下载
精品课程
共6课时 | 12.1万人学习
共79课时 | 161.9万人学习
共6课时 | 54.7万人学习