gh-standup
Generate a standup summary from GitHub activity since the last standup day.
Quick Start
CODEBLOCK0
Parameters
| Flag | Required | Default | Description |
|---|
| INLINECODE0 | one of | — | Single repo (org/repo) |
| INLINECODE2 |
one of | — | Entire GitHub org (all repos) |
|
--standup-days | no |
Friday | Comma-separated weekdays |
|
--author | no |
@me | GitHub username or
@me |
Workflow
- 1. Run
scripts/standup.py with the user's repo/org and standup days - The script calculates the most recent past standup day and uses it as INLINECODE9
- Output: merged PRs + direct commits (PR commits de-duped) since that date
- Post the output as the standup message
Requirements
- -
gh CLI authenticated (gh auth status) - Python 3.10+
Notes
- -
--org fetches all repos in the org; can be slow for large orgs — prefer --repo when possible - PRs are matched by merge date; commits by author date
- Commits that belong to a merged PR are excluded from "Direct Commits" to avoid duplication
gh-standup
根据自上次站会日以来的GitHub活动生成站会摘要。
快速开始
bash
单个仓库,每周五站会
python3 scripts/standup.py --repo ORG/REPO --standup-days Friday
多个站会日
python3 scripts/standup.py --repo ORG/REPO --standup-days Monday,Thursday
整个组织,指定作者
python3 scripts/standup.py --org MY_ORG --standup-days Friday --author username
参数
| 标志 | 是否必需 | 默认值 | 描述 |
|---|
| --repo | 二选一 | — | 单个仓库(org/repo) |
| --org |
二选一 | — | 整个GitHub组织(所有仓库) |
| --standup-days | 否 | Friday | 逗号分隔的工作日 |
| --author | 否 | @me | GitHub用户名或@me |
工作流程
- 1. 使用用户的仓库/组织和站会日运行 scripts/standup.py
- 脚本计算最近的上一个站会日,并将其作为起始时间点
- 输出:自该日期以来的已合并PR + 直接提交(PR提交已去重)
- 将输出发布为站会消息
环境要求
- - gh CLI已认证(gh auth status)
- Python 3.10+
注意事项
- - --org 会获取组织中的所有仓库;对于大型组织可能较慢——尽可能优先使用 --repo
- PR按合并日期匹配;提交按作者日期匹配
- 属于已合并PR的提交会从直接提交中排除,以避免重复