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

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。

报告固定结构

见 references/REPORT_STYLE.md。核心段：

1. 一句话结论
2. WakaTime 时间投入（无 key 则降级说明）
3. Agent 并发（pane+TTL；raw_sid 仅诊断）
4. Skill / CLI / MCP + 分 provider
5. Token / 费用（分 agent · 分模型；Claude cost-state / Grok usage.json / Codex last_token_usage）
6. CDP 验证→迭代（有则写）
7. 热键调度（Alt+l 为主）
8. 工作环路归纳
9. 数据边界 + 复现命令

Options

Archive config

私有习惯仓（非 coco 业务周报）：

• 默认远程：yunsii/wezdeck-habit-weekly
• 本机偏好：~/.config/habit-weekly/state.json → .archive.{repo,local_path,branch,push_json}
• 环境覆盖：HABIT_WEEKLY_ARCHIVE_REPO / HABIT_WEEKLY_ARCHIVE_PATH / HABIT_WEEKLY_ARCHIVE_BRANCH / HABIT_WEEKLY_PUSH_JSON
• WakaTime 读统计：WAKATIME_OAUTH_TOKEN（waka_tok_…，Bearer）优先；写心跳仍用插件侧 WAKATIME_API_KEY。落盘：~/.config/shell-env.d/wakatime.env（经 runtime_env_load_managed）

Don't

• Don't 把 raw_sid_max_running 写成体感并发
• Don't 用含整夜的 avg_running 当白天主指标
• Don't 手改 JSON 里的计数再渲染
• Don't 与 coco-weekly-report 混用（一个是习惯可观测，一个是业务交付周报）
• Don't 在未要求时省略 --push 却声称已推远端；也不要在仅 --write 时 push
• Don't 把本 skill 链进 ~/.agents/skills / link-platform-skills.sh（仓库内专用）

Related

• Collector: scripts/dev/habit-report.sh + scripts/dev/habit_report/providers/ + habit_report/wakatime.py
• Push: skills/habit-weekly/push-archive.sh
• Docs: docs/diagnostics.md → Habit report
• Sibling timeline: scripts/dev/workflow-timeline.sh