convez.ai
SkillAutomaçãoAvançado
LavenderMikey

Weekly Report — Gerador de Relatórios Semanais

LavenderMikey/weekly-report-skill

Clona formatação de relatórios passados para gerar semanais com mesma estrutura

Ver no GitHub
InicialPluginScore · de 0 a 100

Skill que gera relatórios semanais (周报) imitando automaticamente a estrutura, tom e formatação de seus relatórios anteriores em .docx. Aprende o padrão histórico e sintetiza atividades e leituras da semana mantendo fidelidade visual: fontes, espaçamentos, numeração automática e até fórmulas matemáticas nativas do Word.

Instalação

$npx convez-ai LavenderMikey/weekly-report-skill

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
1
Forks
0
Acompanhando
0
Saúde
28%
Último commit
há 5 meses
Versão
—
Issues abertas
0
Contribuidores
1

Casos de uso

  • Gerar relatórios semanais para liderança mantendo padrão visual e tom da empresa
  • Sintetizar atividades, artigos e papers lidos em formato estruturado automaticamente
  • Extrair figuras de PDFs de pesquisas e inseri-las no relatório com numeração coerente

Veredito

Solução sólida e bem engenheirada para quem precisa gerar relatórios recorrentes sem perder padrão visual. Exige setup prévio (Pandoc, PyMuPDF) e coordenação com modelo histórico, mas entrega alta fidelidade e elimina tarefa repetitiva.

README

A tradução para o português deste README ainda está na fila.

weekly — 周报生成 Skill

一个用来模仿你过去的周报自动生成新一周周报的 Agent Skill,同时兼容 Claude Code 和 OpenAI Codex。它会先把你的历史周报当模板学习(章节结构、语气、详略,以及字体、字号、缩进、行间距、自动编号等视觉格式),再把你这周的工作和读过的文章/论文忠实地总结进同样的格式里。

核心原则:绝不编造未发生的工作、指标或文章——生成的周报要让领导看不出是自动生成的。

功能特点

  • 格式高保真:通过 .docx 克隆继承原周报的字体、行间距、页面设置,以及隐藏在 numbering.xml 里、文本看不到的自动编号(一、二、三 / 1、2、3)。
  • 原生 Word 公式:论文公式用 Pandoc 转成可编辑的 Word 公式(OMML),而不是 LaTeX 源码文本,无需手动转换。
  • 从论文 PDF 自动抠图:按图注(caption)定位裁剪论文里的架构图/实验图,以插入表格的形式放进周报。
  • 按历史排版规律放图:架构图放在"整体框架/方法"小节下,结果图放在"实验结果"下,按出现顺序编号(图1、图2…),而不是堆在末尾。
  • 学习板块独立:读过的文章单独成节,不与工作内容混在一起。

使用方式

脚本和参考文档是工具无关的纯 Python + Markdown,两边共用;区别只在"入口/触发方式"。

🟣 Claude Code

把整个目录放到 skills 目录下(例如 ~/.claude/skills/weekly),然后对 Claude 说"帮我写周报"、"根据以前的周报生成这周的"之类的话,会按 SKILL.md 的 description 自动触发。

🟢 OpenAI Codex(及其它读 AGENTS.md 的 agent)

仓库根目录的 AGENTS.md 就是 Codex 的入口。把它(连同 scripts/、references/)放进你的项目,然后说一句"按 AGENTS.md 的周报流程帮我写周报",或直接把历史周报 + 本周材料丢给它。Codex 没有自动发现 / 自动触发机制,所以需要你稍微点一下它去走这个流程。

两个入口(SKILL.md / AGENTS.md)描述的是同一套 5 步工作流,调用的是同一批脚本,不用维护两份逻辑。

目录结构

weekly-report-skill/
├── SKILL.md                       # Claude Code 入口:触发条件 + 5 步工作流
├── AGENTS.md                      # Codex / 通用 agent 入口(同一套流程)
├── README.md
├── scripts/
│   ├── inspect_docx.py            # 转储 .docx 的逐段结构与格式(字体/字号/对齐/缩进/编号/行间距)
│   ├── docx_report.py             # 克隆重建周报的通用积木:wipe_body / clone_with_text / add_figure_table / strip_unused_media 等
│   ├── docx_math.py               # latex_to_omath:把 LaTeX 转成原生 Word 公式(需 Pandoc)
│   └── extract_pdf_figure.py      # extract_figure:按图注从论文 PDF 裁剪图片(需 PyMuPDF)
└── references/
    └── docx_formatting.md         # python-docx 配方:中文字体、缩进、克隆模板、插入公式

依赖

  • python-docx(读写 .docx)
  • pandoc(LaTeX → Word 公式,可选,仅含公式时需要)
  • pymupdf(从 PDF 抠图,可选,仅需插图时需要)
pip install python-docx pymupdf
Ver o original no GitHub

Bom para

Relacionados