Skip to content

Adonis0123/adonis-skills / .agents/skills/weekly-report

weekly-report

Verified

Generate structured weekly reports from Git commit history across one or multiple repositories. Use when you need concise, project-grouped progress summaries for status reporting.

FileKindSize
SKILL.mdskill md7.2 KB
evals/evals.jsonconfig2.2 KB
references/WEEKLY_REPORT_FORMAT.mdmarkdown2.9 KB
scripts/test_git_analyzer.pyscript9.8 KB
src/__init__.pyscript78 B
src/config_manager.pyscript3.6 KB
src/date_utils.pyscript6.5 KB
src/git_analyzer.pyscript10.5 KB
src/report_generator.pyscript6.3 KB
src/storage.pyscript13.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. 如果某周工作内容较少,如实反映即可,不需要刻意扩充
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 implementationStars: 322kUpdated Claude CodeCodexVerifiedInstall
requesting-code-reviewobra/superpowersUse when completing tasks, implementing major features, or before merging to verify work meets requirementsStars: 322kUpdated Claude CodeCodexVerifiedInstall
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 fallbackStars: 322kUpdated Claude CodeCodexVerifiedInstall
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 alwaysStars: 322kUpdated Claude CodeCodexVerifiedInstall