从腾讯 Coding DevOps 平台生成周报,内容包括项目进度、问题(Issues)、构建(Builds)、提交(Commits)以及合并请求(Merge Requests)。
Tencent Coding Weekly Report. 由 Tencent Coding DevOps 平台提供每周全面报告,包括项目进度、问题跟踪、CI/是一项面向实际任务的技能。它将相关步骤、工具调用和结果整理方式集中到统一流程中,帮助使用者更快完成目标并减少重复操作。
实际使用前应先确认任务范围、数据来源、运行环境、必要权限和关键参数,再依据技能说明逐步执行;若输入条件不完整,应先补齐信息或采用保守配置,避免因错误假设导致结果偏离需求。
执行过程中需要关注工具调用是否成功、接口或依赖是否可用、输出格式是否符合预期,并对异常提示、缺失字段和边界情况进行处理;涉及批量任务时,还应保存进度,避免中断后重复操作。
从腾讯 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
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
生成的周报包含以下模块:
所有日期参数均采用 YYYY-MM-DD 格式;若未指定周起始日,则默认为当前自然周的周一。
报告以 Markdown 格式生成,便于阅读,且兼容各类文档平台。
可通过 --project-ids 和 --member-ids 参数聚焦特定项目或成员;也可使用 --no-* 类标志(如 --no-builds)在无需某类数据时主动排除。
配置错误:CODING_TEAM_DOMAIN 未设置
CODING_TEAM_DOMAIN 已在 .env 文件或系统环境变量中正确设置API 错误:访问令牌无效
CODING_ACCESS_TOKEN 有效,且已授予所需权限指定时间范围内未查到数据
触发限流错误
脚本在数据采集过程中会输出进度提示信息,可据此定位异常发生的具体环节。
references/coding-api.md相关专题
热门下载
相关下载
精品课程
共6课时 | 54.7万人学习
共89课时 | 134.3万人学习
共49课时 | 82.7万人学习