mcpField
S
sred-work-summary

sred-work-summary

github.com/getsentry生产力1.1k2.1k 次安装5 天前更新
代码仓库

关于 sred-work-summary

此 Skill 汇集指定年度区间内的 GitHub PR、Notion 文档和 Linear 工单,按项目归类链接并写入私有 Notion 文档,适用于整理 SRED 工作记录。

主要功能

  1. 01汇集 GitHub PR、Notion 文档和 Linear 工单
  2. 02按指定时间范围筛选记录
  3. 03按项目归类链接
  4. 04创建私有 Notion 总结文档

适用场景

  1. 01汇编年度工作记录
  2. 02整理不同代码库和工作跟踪工具中的证据

MCP 相关

通过 MCP 连接使用 Notion 和 Linear;GitHub 可通过 MCP 或 `gh` 命令行访问。

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/getsentry/skills --skill sred-work-summary

安装后在 Claude Code 中输入/sred-work-summary确认已加载。

详细介绍

SRED 工作总结

收集某人在指定年份完成的所有 GitHub PR、Notion 文档和 Linear 工单。将这些内容的链接按项目分组。将所有内容放入一个私密的 Notion 文档中,并返回该文档的链接。

前提条件

开始前,请确保可以访问 GitHub、Notion 和 Linear。Notion 和 Linear 应通过 MCP 连接。GitHub 也可以通过 MCP 连接,但如果你可以使用 gh CLI 工具,也可以改用它。

如果无法访问其中任何一项,请先提示用户授予访问权限,再继续。

流程

第 1 步
# Get the current year
date +%Y

此命令的输出是当前年份。 当前年份减 1 即为上一年。

第 2 步

向用户收集所有必需的信息:

GitHub 用户名:用户的 GitHub 用户名是什么?

GitHub 仓库:应在哪些 GitHub 仓库中搜索 PR?

用户可以提供以逗号分隔的仓库列表,也可以提供一个包含仓库的目录。如果用户选择后者,请在指定目录中运行此命令:

# Find github repos
find . -maxdepth 2 -name ".git" -type d | sed 's/\/.git$//' | sort

确保:

  • 列出的所有仓库都属于 GitHub 的 getsentry 组织。

以下将此命令的输出称为“用户仓库”。

事件:询问用户是否要包含事件文档。

答案为是或否。如果答案是否,则稍后搜索时排除某些文档。

其他用户:询问是否还有其他用户可能创建了 Notion 文档。

答案应为以逗号分隔的姓名列表。将此列表记为“其他用户”。

第 3 步

创建一个名为“SRED Work Summary [current year]”的私密 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 步

根据你的判断,将 Work Summary 文档中的所有 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 标题和 PR 描述进行归类。 对于 Notion 文档,请参考完整文档进行归类。 对于 Linear 工单,请参考工单标题和工单描述进行归类。

请确保:

  • 文件中的所有链接都已归入某个项目。
  • 文件符合上述格式。
  • 不要截断链接列表。不要使用“……以及另外 75 项”之类的缩略写法。请确保文档中显示所有 Github PR、Notion 文档和 Linear 工单的完整集合。
第 7 步

搜索由“其他用户”创建的 Notion 文档。找出与 Work Summary 中项目相关的文档,并将这些 Notion 文档的链接添加到 Work Summary 中相应的项目下。

第 8 步

向用户返回 Work Summary Notion 文档的链接。

请确保:

  • 最终输出中包含实际的 Notion 文档链接。

资源

这是 2025 年 Work Summary 文档示例:https://www.notion.so/sentry/Work-Summary-Feb-2025-Jan-2026-3068b10e4b5d81d3a40cfa6ad3fe1078?source=copy_link

评论

支持 Markdown