weekly-summary

Generates HTML weekly work summaries by merging Feishu reports with daily-summary records.

Updated May 28, 2026
One-click install
npx skills add https://github.com/changfengpro/agent-skills --skill weekly-summary-changfengpro
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: weekly-summary
Source: https://github.com/changfengpro/agent-skills/tree/main/skills/weekly-summary
Command: npx skills add https://github.com/changfengpro/agent-skills --skill weekly-summary-changfengpro

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes assets (resource) components.

What problem does it solve? Writing a weekly report means manually reconciling a week of scattered work records. This Skill automates that by fusing two complementary sources: your hand-written Feishu daily/weekly reports (the authoritative mainline) and detailed daily-summary HTML files (commit hashes, bug root causes, metrics), producing a structured HTML weekly summary emailed to your Feishu mailbox. ## Core Features & Use Cases - Dual-source fusion: Pulls your own Feishu reports via lark-cli as the authoritative skeleton, then enriches each project with 1-3 key details from local daily-summary HTML files, falling back to Feishu mail when local files are missing. - Deterministic collection script: Runs assets/collect.py to fetch your open_id at runtime, query the report API, filter client-side by your identity, and output a per-day JSON digest with coverage stats. - Feishu-aligned output: Generates a three-layer HTML document whose summary section mirrors the four official Feishu weekly report fields, ready to paste back into the Feishu form, then sends it to your own mailbox. - Use Case: On Saturday, say "write my weekly report" and receive an HTML summary covering Monday through Saturday with project progress, milestones, and closed/open loops, already in your inbox. ## Quick Start Ask the assistant to summarize this week's work into a weekly report and send it to your Feishu email.

Frequently Asked Questions about weekly-summary

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I generate a weekly work summary from Feishu reports?

Run the collection script with python3 assets/collect.py to pull your Feishu daily and weekly reports for the current ISO week, then let the assistant aggregate them into an HTML summary. The output is emailed to your own Feishu mailbox via lark-cli.

How to combine daily summaries into a weekly report automatically?

The Skill treats hand-written Feishu reports as the authoritative mainline and merges in details from local daily-summary HTML files, falling back to Feishu mail when local files are missing. Each project gets only 1-3 key details like commit hashes or bug root causes.

Does the weekly summary include Sundays?

No, the statistics window covers Monday through Saturday only, treating six days as the work week. Even if you run it on Sunday, that day is excluded and only the current week's Monday to Saturday are counted.

What happens if I have no Feishu reports or daily summaries for a week?

The Skill falls back to scanning raw .jsonl session files under ~/.claude/projects for the week window. This fallback is slower and produces lower-detail output, so it is only used when both primary sources are absent.

Why does the Feishu report query return other people's reports?

The report tasks/query API ignores the server-side user_id filter and returns the whole group's reports. The collection script filters client-side by comparing from_user_id against your own open_id, which is fetched at runtime.

What dependencies are required to run the weekly summary collection?

You need lark-cli logged in with user identity and an unexpired token, plus python3 for the collection script. The script uses only Python standard library modules, so no extra packages are required.