GitCode 仓库运营报表（日报）

根据 config 或用户指定的仓库列表，生成运营日报（调 API + 写 DB）。摘要根据报表数据生成后，渲染时自动写入 DB。

何时使用

• 用户表达「生成日报」「仓库运营报表」「今日动态」「整理成日报」等意图。
• 可选：用户提供仓库链接或 owner/repo、日期；未提供则使用脚本从 config.json 读取的 repos（脚本负责读写 config）。
• 若用户本次指定了仓库，调用脚本时传入 --repos "owner/repo,..."，脚本会用于本次并写入 config，下次未指定时将使用此列表。
• 若 config 中 repos 为空且用户未指定仓库，则提示：「请本次对话中指定要统计的仓库（将保存为默认），或在 config.json 中配置 repos」。

认证

GITCODE_TOKEN：按以下优先级读取，任一处有值即用。

优先级	来源	适用平台
1	进程环境变量 GITCODE_TOKEN	所有平台
2	Windows 用户级环境变量	Windows
3	Windows 系统级环境变量	Windows

• Linux / macOS：仅读进程环境变量。建议在 ~/.bashrc 或 ~/.zshrc 中添加 export GITCODE_TOKEN="your_token"。
• Windows：进程环境变量 → 用户级 → 系统级。
• 日报必选（调 API 拉取当日数据）。

路径约定

• 技能根目录（下称 SKILL_ROOT）：本 SKILL.md 所在的目录。脚本通过 __file__ 定位自身，不依赖工作目录。
• 中间文件目录：SKILL_ROOT/temp_dir/，脚本自动创建。
• 执行脚本时，统一使用脚本绝对路径，无需 cd 到特定目录。
• --report-json 和 --summaries-file 参数的相对路径会自动按 SKILL_ROOT 解析（也可传绝对路径），已有默认值无需每次指定。

固化流程（必须按此执行）

日报

1. 解析：解析 日期（今日/昨天/YYYY-MM-DD）和 仓库列表（可选）。
2. 调用脚本：若用户本次指定了仓库，传入 --repos "owner/repo,..."（逗号分隔）；否则不传。config 由脚本读写，你无需写入 config。 python <SKILL_ROOT>/scripts/generate_daily_report.py [--date YYYY-MM-DD] [--repos "owner/repo,..."]（默认 --type day）。需 GITCODE_TOKEN。
3. 读取结果：脚本成功时自动写入 SKILL_ROOT/temp_dir/report.json（UTF-8 编码），同时也输出到 stdout。优先从文件读取（避免 Windows 管道编码乱码），若文件不存在再解析 stdout。
4. 错误：若 status == "error"，提示 message 并结束。
5. 提示用户：若脚本返回或 report.json 中含有 repos_saved: true 或 repos_saved_message，须用自然语言告知用户：「已保存为默认仓库列表，下次若不指定仓库将使用此列表。」不得向用户提及 config.json、--repos 等实现细节。
6. 成功：
   • 读取 SKILL_ROOT/temp_dir/report.json（脚本已自动写入，无需手动保存）。
   • 对 report.repos 中每个无 fetch_error 的仓，根据 merged_prs_for_ai，自行生成该仓今日摘要；再根据各仓摘要生成全局一句话摘要。

     摘要要求：1-2 句话，≤100 字，概括该仓当日主要变更方向。示例：「今日合并 3 个 PR，涉及 NPU 调度策略优化和单测补充。」

   • 将各仓摘要与全局摘要写成 SKILL_ROOT/temp_dir/summaries.json（使用 Write 工具），格式如下：
     json

     {
       "period_type": "day",
       "date": "2026-03-10",
       "repos": [
         {"repo": "owner/repo", "summary": "今日合并3个PR，涉及调度优化和单测补充。"}
       ],
       "global": "全局一句话摘要"
     }
     

   • 必须使用脚本渲染模式生成日报 Markdown： python <SKILL_ROOT>/scripts/generate_daily_report.py --render --output <用户指定的 .md 路径> 脚本自动从 temp_dir/report.json 和 temp_dir/summaries.json 读取，渲染时同时自动将摘要写入 DB。同一天多次执行时 DB 自动保留最新结果。报告结构由 resources/daily_report.md 唯一确定，不得自行改写模板结构或跳过渲染。

禁止

• 禁止在未得到脚本 stdout 输出前猜测或伪造数据。日报只调用 generate 一次。

脚本与路径

• scripts/generate_daily_report.py（唯一脚本）：
  • 生成日报：--type day（默认）、[--date YYYY-MM-DD]、[--repos "owner/repo,..."]。仓库列表：未传 --repos 时从 config.json 读取；传了则用于本次并写入 config（下次未指定时使用）。结果自动写入 temp_dir/report.json。stdout 仅输出简短状态（文件路径），必须从文件读取完整数据。
  • 渲染报表：--render --output <PATH> [--template <PATH>]。日报使用 resources/daily_report.md 模板。渲染时自动将 summaries.json 中的摘要保存到 DB。
  • 单独保存摘要（可选）：--save-summaries，仅在不渲染但需写 DB 时使用。
• resources/daily_report.md：日报的固定模板，不得擅自改动。
• 配置：config.json 由脚本读写（无需写入）；存储：resources/report.db。
• 脚本通过 __file__ 定位技能根目录，不依赖工作目录，Windows / Linux / macOS 均可使用绝对路径执行。

示例（供无歧义执行）

以下 <S> 代表 <SKILL_ROOT>/scripts/generate_daily_report.py，执行时替换为脚本绝对路径。

用户意图	命令
生成今日日报	python <S>
生成 3 月 8 日日报	python <S> --date 2026-03-08
指定仓库生成日报（并保存为默认）	python <S> --repos "owner/repo,owner2/repo2"
渲染报表到文件（同时自动保存摘要到 DB）	python <S> --render --output 报告路径.md

报表内容结构（由模板唯一确定）

日报 必须 通过 --render 使用 resources/daily_report.md 模板生成，以保证输出格式一致。结构：标题（含 emoji）→ 一、仓库概览（整体指标表 + 全局一句话摘要）→ 二、分仓详情（含可点击 Issue/PR 链接、合并 PR 列表、热门 Issue 明细、该仓小结）→ 三、行动建议（基于数据自动识别的关注事项）。

参考

• 设计、config、DB 表、报表 Schema：README.md。

历史版本

v1.0.0 (2026-03-11)

• 🎉 初始版本发布
• 📅 支持日报与摘要