Skip to content

feat: add lark-scan-report skill#37

Open
KasparChen wants to merge 1 commit intolarksuite:mainfrom
KasparChen:feat/lark-scan-report-skill
Open

feat: add lark-scan-report skill#37
KasparChen wants to merge 1 commit intolarksuite:mainfrom
KasparChen:feat/lark-scan-report-skill

Conversation

@KasparChen
Copy link
Copy Markdown

Summary

Adds skills/lark-scan-report — a skill that generates structured Lark/Feishu work reports as message cards by combining task data and chat messages.

Five report types:

  • morning: TOP 3 tasks (DDL today > P0 > overdue) + overnight action items
  • evening: Completed tasks + tomorrow push list + conversation highlights
  • quick-scan: Delta @mentions + task updates since last scan; plain text if nothing new
  • full: Comprehensive snapshot across all sources
  • weekly: Two output blocks — exec-facing narrative + internal task list

Implementation notes

  • tasklists list returns error 1470500 — skill discovers tasklist GUIDs from tasks list response, then fetches per GUID via tasklists tasks
  • Sections API returns 404 — section GUID to name mapping is hardcoded in config.yaml
  • .last-scan-ts tracks last scan time to avoid re-processing messages on every run
  • Output sent via messages-send --msg-type interactive --as bot

What is included

  • SKILL.md — Full execution flow, API workarounds, formatting rules
  • README.md — Bilingual EN/ZH: installation, triggers, required permissions with copy-paste JSON
  • config.example.yaml — Clean template with no personal data
  • templates/ — Five report templates (card structure + extraction logic)

🤖 Generated with Claude Code

Adds `skills/lark-scan-report` — generates structured Lark/Feishu work
reports as message cards by combining Task v2 API data and chat messages.

All logic runs through lark-cli commands — no code execution or SDK
dependency. Any AI agent that can run shell commands can operate this skill.

Five report types:
- morning: TOP 3 tasks (DDL today > P0 > overdue) + overnight action items
- evening: completed tasks + tomorrow push list + conversation highlights
- quick-scan: delta @mentions + task updates since last scan
- full: comprehensive snapshot across all sources
- weekly: exec-facing narrative + internal task list (two output blocks)

Key implementation notes:
- tasklists list returns error 1470500 — GUIDs discovered from tasks list
- Sections API returns 404 — section names hardcoded in config.yaml
- Delta scanning via .last-scan-ts avoids re-processing messages
- Cards sent via messages-send --msg-type interactive --as bot

Includes bilingual README (EN/ZH), five report templates, and
config.example.yaml with no personal data.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
@KasparChen KasparChen force-pushed the feat/lark-scan-report-skill branch from 739f438 to aaeed0b Compare March 29, 2026 06:10
@KasparChen
Copy link
Copy Markdown
Author

Hi @timzhong1024 @liuxinyanglxy — this PR adds a new lark-scan-report skill that combines task + message APIs to generate daily/weekly work reports as message cards.

Would love a review when you get a chance. Happy to adjust anything to match your conventions. Thanks!

@KasparChen
Copy link
Copy Markdown
Author

@schumilin would appreciate your eyes on this as well 🙏

@CLAassistant
Copy link
Copy Markdown

CLA assistant check
Thank you for your submission! We really appreciate it. Like many open source projects, we ask that you sign our Contributor License Agreement before we can accept your contribution.
You have signed the CLA already but the status is still pending? Let us recheck it.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants