habit-weekly

Habit weekly（仓库内 skill — 开发习惯周报）

Who runs: the coding agent, not the human.
Never ask the human to paste habit-report.sh as the primary path — load this skill and run the co-located runner.

Scope: WezDeck 仓库内 skill（skills/habit-weekly/）。由 AGENTS.md 路由加载；不经 link-platform-skills.sh 同步到 ~/.agents/skills / ~/.claude/skills（依赖本仓 habit-report.sh，用户级软链会把 repo_root 算错）。

数据收集器是 scripts/dev/habit-report.sh（插件化 Claude / Grok / Codex + 可选 WakaTime）。本 skill 负责：定窗口 → 拉 JSON → 按固定模板渲染周报 →（可选）落盘 →（显式）推送到习惯归档仓。

When to load / run

用户意图	你做
开发习惯周报 / 习惯周报 / habit weekly	run.sh（默认上一完整 Mon–Sun；若归档仓落后则 catch-up 接到上次 until+1；默认含 WakaTime）
上周习惯 / last week	run.sh 或 run.sh --week last（与默认相同，含 catch-up）
只要单周、不要接假期缺口	run.sh --no-catch-up
本周迄今 / this week	run.sh --week this（Mon→today，未完结周；不做 catch-up）
自定义区间	run.sh --since YYYY-MM-DD --until YYYY-MM-DD（显式窗口，跳过 catch-up）
只要原始 JSON	run.sh --json-only
落盘归档（本机）	run.sh --write（再 --stdout 可同时打印正文）
落盘并推送到私有习惯仓	run.sh --write --push（--push 隐含 --write）

Skip / redirect:

• 团队业务周报（commit / TAPD / 飞书）→ coco-weekly-report（不是本 skill）
• 只要某一天的时间线事件流 → workflow-timeline.sh
• 只要热键表、不要 Agent 段 → habit-report.sh --no-hotkeys 的反义词是 --providers 裁剪；仍可用本 skill 再口头删段

Resolve TOOL_HOME

1. $HABIT_WEEKLY_HOME（显式覆盖）
2. $WEZDECK_REPO/skills/habit-weekly（本机主仓）
3. 本 SKILL.md 同目录（skills/habit-weekly，run.sh 共存）
4. $WEZDECK_ROOT/skills/habit-weekly

TOOL_HOME="${HABIT_WEEKLY_HOME:-$WEZDECK_REPO/skills/habit-weekly}"
R="$TOOL_HOME/run.sh"

run.sh 用 pwd -P 解析自身目录，并以 $WEZDECK_REPO（若含 scripts/dev/habit-report.sh）优先定仓库根。不要从 ~/.agents/skills/habit-weekly 启动。

Agent procedure

1. 定窗口（用户没说则默认上一完整 Mon–Sun；未完结周须显式 --week this）：
   • 默认 / 上周完整周 → 不传或 --week last
   • Catch-up（默认开）：读归档仓最新 habit-weekly-*_to_<until>.md；若 until+1 早于默认窗口起点（假期 / 漏跑），把 since 前移到 until+1，until 仍为上完整周日——一份报告接缺口，不要再问用户切不切开。--no-catch-up 可关；显式 --since/--until 与 --week this 不做 catch-up。
   • 本周迄今（未完结）→ --week this
   • 点名日期 → --since / --until，或 --week YYYY-MM-DD（取该日所在周 Mon–Sun）
2. 跑收集 + 渲染（优先 --write 落盘；用户要远端归档时再加 --push）：

   "$R" --write --push
   

   仅本机落盘：

   "$R" --write
   

   未完结本周（少用）：

   "$R" --week this --write
   

3. 读 references/REPORT_STYLE.md，核对渲染稿是否需补一句人话结论（数字已被模板写好；只在环路归纳与分工上可加 1–2 句，禁止改数字）。窗口若因 catch-up 超过 7 天，结论里可点一句「含假期/空档」。
4. 汇报：把 markdown 正文（或落盘路径 + 摘要）用简体中文交给用户。披露数据窗口、max_running 口径（pane+TTL）、WakaTime 是否成功、是否发生了 catch-up。