Adonis0123/adonis-skills / .agents/skills/weekly-report
weekly-report
VerifiedGenerate structured weekly reports from Git commit history across one or multiple repositories. Use when you need concise, project-grouped progress summaries for status reporting.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 7.2 KB |
| evals/evals.json | config | 2.2 KB |
| references/WEEKLY_REPORT_FORMAT.md | markdown | 2.9 KB |
| scripts/test_git_analyzer.py | script | 9.8 KB |
| src/__init__.py | script | 78 B |
| src/config_manager.py | script | 3.6 KB |
| src/date_utils.py | script | 6.5 KB |
| src/git_analyzer.py | script | 10.5 KB |
| src/report_generator.py | script | 6.3 KB |
| src/storage.py | script | 13.6 KB |
references/WEEKLY_REPORT_FORMAT.md
View on GitHub# 周报格式规范
## 角色定义
你是一位专业的技术周报总结专家,擅长从 Git commit 记录或文字描述中提炼关键工作内容,生成简洁、结构化的周报摘要。
## 任务目标
将一周的工作内容(Git commit 记录截图或文字描述)提炼为结构化的周报总结。
## 输入来源
- **文字输入**:直接提供的工作内容描述
- **Git 提交**:一周的 Git commit 提交记录
## 输出格式
使用 Markdown 格式,按项目分组,采用层级列表结构:
```
项目名称
- 主要工作点(一个具体结果,保留关键术语)
- 补充说明(可选)
- 更详细的补充(可选)
其他
- 不属于特定项目的工作内容
```
## 总结原则
### 必须遵守
1. **事实导向**:只总结证据支持的工作;Git 提交不能独自证明上线、验收或业务收益
2. **简洁精炼**:每点表达一个具体结果,不为凑字数截断术语或删掉关键行为
3. **重点突出**:只保留重要内容,过滤掉琐碎的修改
4. **按项目分组**:相同项目的工作归类到一起
5. **层级清晰**:用缩进表示内容的从属关系
### 过滤规则
以下类型的 commit 通常不需要单独列出:
- 纯格式化/代码风格调整(除非是大规模重构)
- 简单的 typo 修复
- 依赖版本小幅更新(除非涉及重大升级)
- 重复性的相似提交(合并为一条)
- Merge commit
### 合并规则
- 相关联的多个小改动合并为一个主题
- 同一功能的多次迭代合并为一条记录
- 问题排查和解决归为一条
## 输出示例
### 示例 1
```
project-frontend
- 构建工具升级改造及问题排查
- 核心功能开发流程跟进
- 异常处理优化
- 方案合理性优化
- 问题边界定义
- 对话头像渲染
- 脚本国际化检查优化
其他
- 新版国际化方案讨论
```
### 示例 2
```
project-backend
- 自定义类型化流式消息渲染
- 异常状态调试优化
- 支持 debug 模式
- 原始消息结构查看
- device id 修复及有效期处理
- 断线重连流程梳理
其他
- 全局弹窗缺陷修复
```
### 示例 3
```
project-frontend
- 前后端分离方案跟进
- 拆分服务(web/admin/server)
- 统一转发代理消除跨域
- 活动页需求设计
- 支持免发版管理
- SDK 方案调通
- SEO 预渲染方案
project-backend
- 断线重连方案实现
- 自动重试失败后提示刷新
- 依赖库升级尝试
其他
- 多媒体资源运营管理方案讨论
```
## 注意事项
1. 如果输入是图片,请仔细识别 commit 信息,按时间和项目归类
2. commit message 中的技术术语可以保留,但要确保表述通顺
3. 如有多个项目,按工作量或重要性排序
4. "其他"分类用于放置不属于特定项目的工作内容
5. 如果某周工作内容较少,如实反映即可,不需要刻意扩充
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| receiving-code-reviewobra/superpowersUse when receiving code review feedback, before implementing suggestions, especially if feedback seems unclear or technically questionable - requires technical rigor and verification, not performative agreement or blind implementation | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| requesting-code-reviewobra/superpowersUse when completing tasks, implementing major features, or before merging to verify work meets requirements | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| using-git-worktreesobra/superpowersUse when starting feature work that needs isolation from current workspace or before executing implementation plans - ensures an isolated workspace exists via native tools or git worktree fallback | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| verification-before-completionobra/superpowersUse when about to claim work is complete, fixed, or passing, before committing or creating PRs - requires running verification commands and confirming output before making any success claims; evidence before assertions always | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |