---
name: week
description: 周报（关键词）：扫工作区 CHANGELOG.md，按年内第 N 周归纳，写入 .growing/week-report/。说「周报」「本周总结」时用。
disable-model-invocation: true
---

# week · 周报

**工具技能**（无 slash · 非 plan/run 主路径）。**用这个**：汇总多仓 CHANGELOG 周报。**不是那个**：单项目任务/驾驶舱周报（目标项目自建 skill）；本仓约定沉淀 → **`/learn`**；打版 → **`/release`**。

扫描工作区各仓库 **CHANGELOG.md**，归纳后写入 **`.growing/week-report/第{N}周任务总结.md`**（本地、**不提交 git**）。

## 何时进入

- 用户说「周报」「本周总结」「总结最近一周的成果」
- `/master` → more 或关键词命中

## 周范围

| 今天 | 统计区间 |
|------|----------|
| 周一～周四 | 本周一 ～ **今天** |
| 周五～周日 | 本周一 ～ **本周日** |

周号：**年内第 N 周**（包含 1 月 1 日的那一周为第 1 周）。

## 流程（Agent 一次跑完）

### 1. 采集

```bash
python3 .cursor/skills/week/scripts/collect-week.py --format meta
python3 .cursor/skills/week/scripts/collect-week.py --format raw
```

可选：

- `--workspace <dir>` — 默认**当前工作目录**；多仓扫描须显式传入根目录或 AskQuestion
- `--today YYYY-MM-DD` — 测试用

### 2. 归纳并写入

```bash
mkdir -p .growing/week-report
```

输出：`.growing/week-report/第{N}周任务总结.md`（同周已存在则覆盖）。

**不要**只粘贴 CHANGELOG 原文。结构：

```markdown
# 第 {N} 周任务总结（{start} ～ {end}）

> 自动生成 · 来源：工作区 CHANGELOG

## 本周概览
## 按项目
## 亮点
## 风险 / 遗留
## 下周建议
```

- **本周概览**：3～5 条，跨项目主题
- **按项目**：有进展的仓库各一小节（版本 + 日期 + 要点）
- 中文为主；无条目时在概览说明

### CHANGELOG 格式兼容

采集器识别版本节分隔符：**ASCII `-`** · **en dash `–`** · **em dash `—`**（规范仍为 `-`，见 `changelog.mdc`）。

验收：`bash .cursor/skills/week/scripts/verify_collect_week.sh`

### 3. 确认

```bash
git status   # .growing/ 不应出现在待提交列表
```

**禁止** `git add .growing/week-report/`。

## 与 release 的关系

- **release**：各仓库写 CHANGELOG（数据源）
- **week**：只读聚合，不打 tag
