
关于
回顾过去一年的工作,创建 Notion 文档将相关链接分组为可作为 SR&ED 项目记录的项目。
name: sred-work-summary description: 回顾过去一年的工作,创建一个 Notion 文档,将相关链接分组为项目,然后可以作为 SRED 项目进行记录。 risk: unknown source: community
SRED 工作总结
收集某人在给定年份完成的所有 Github PR、Notion 文档和 Linear 工单。将所有来源的链接分组为项目。将所有内容放入私有 Notion 文档中并返回该文档的链接。
何时使用
- 你需要将一年的 PR、Notion 文档和 Linear 工单收集并按项目分组,为 SRED 准备工作。
- 任务是在编写单个 SRED 项目描述之前构建上游 Notion 工作总结。
- 你需要一个可重复的收集工作流程,跨越 GitHub、Notion 和 Linear,针对固定时间窗口。
前提条件
开始之前,确保可以访问 Github、Notion 和 Linear。Notion 和 Linear 应通过 MCP 连接。Github 可以通过 MCP 连接,但如果你有 gh CLI 工具的访问权限,也可以使用它。
如果其中任何一个无法访问,请提示用户在继续之前授予访问权限。
流程
步骤 1
# Get the current year
date +%Y
此命令的输出是当前年份。 当前年份减一是上一年。
步骤 2
从用户处收集所有必需信息:
Github 用户名:用户的 github 用户名是什么?
Github 仓库:应该搜索哪些 Github 仓库的 PR?
用户可以指定逗号分隔的列表,或提供包含仓库的目录。在第二种情况下,在指定目录中使用此命令:
# Find github repos
find . -maxdepth 2 -name ".git" -type d | sed 's/\/.git$//' | sort
确保:
- 列出的所有仓库都在
getsentryGithub 组织中。
此输出以下称为"用户仓库"。
事件:询问用户是否要包含事件文档。
答案为是或否。如果答案为否,将在后续搜索中排除某些文档。
其他用户:询问是否有其他用户可能创建了 Notion 文档。
这应该是逗号分隔的名称列表。记住这个为"其他用户"。
步骤 3
创建一个名为"SRED Work Summary [当前年份]"的私有 Notion 文档。此文档以下称为工作总结。
如果同名文档已存在,通知用户重命名现有文档并停止执行。
确保:
- 如果工作总结已存在,停止执行。
步骤 4
时间窗口为上一年 2 月 1 日至当前年份 1 月 31 日。
在时间窗口内查找给定 github 用户名在用户仓库中创建的所有 Github PR。
如果用户不想包含事件文档,忽略标题或描述中包含 INC-X、inc-X 的任何 Github PR。
使用 Github MCP 或 gh 命令来完成此操作。
查找用户在时间窗口内创建的所有 Notion 文档。
如果用户不想包含事件文档,忽略标题中包含 INC-XXXX 的任何 Notion 文档。
使用 Notion MCP 来完成此操作。
查找在时间窗口内分配给用户的所有 Linear 工单。
如果用户不想包含事件文档,忽略标题中包含 INC-XXXX 的任何 Linear 工单。
使用 Linear MCP 来完成此操作。
确保:
- 所有 Github PR 都是在时间窗口内创建或合并的,且由用户打开。
- 所有 Notion 文档都是在时间窗口内创建的,且由用户创建。
- 所有 Linear 工单都是在时间窗口内打开或完成的,且在完成时分配给用户。
步骤 5
对于步骤 4 中找到的每个 Github PR、Notion 文档和 Linear 工单,将链接放入步骤 3 中创建的私有文档中。
确保:
- 工作总结中包含所有 Github PR 的链接
- 工作总结中包含所有 Notion 文档的链接
- 工作总结中包含所有 Linear 工单的链接
- 不要截断链接列表。不要使用缩写如"...还有 75 个"。确保所有 Github PR、Notion 文档和 Linear 工单的完整集合在文档中可见。
步骤 6
使用你自己的智能将工作总结文档中的所有 Github、Notion 和 Linear 工单链接分组为项目。此文档的格式如下所示。
# Projects
## [Project Name]
*Summary*: [X] PRs, [X] Notion docs, [X] Linear tickets
### Pull Requests [X]
*[repository name]
[Links to all the PRs]
- [link] - [Merge date]
### Notion Docs [X]
[Links to all the Notion docs]
- [link] - [Creation date]
### Linear Tickets [X]
- [link] - [Creation date]
对于 Github PR,使用 PR 的标题和描述进行分组。 对于 Notion 文档,使用完整文档进行分组。 对于 Linear 工单,使用工单的标题进行分组。