mcpField
S
sred-project-organizer

sred-project-organizer

github.com/getsentry文档处理1.1k2.1k 次安装5 天前更新
代码仓库

关于 sred-project-organizer

此 Skill 根据 SRED 标准评估年度工作总结中的项目,并在 Notion 中创建附有证据的项目说明。流程涵盖项目分类、技术不确定性、实验和资料记录。

主要功能

  1. 01按 SRED 标准分类项目
  2. 02创建 Notion 主文档和项目子页
  3. 03起草项目说明与目标
  4. 04记录不确定性、实验和结果
  5. 05添加支持证据链接

适用场景

  1. 01将年度工作总结整理为 SRED 项目记录
  2. 02记录技术不确定性与实验工作
  3. 03与用户共同审核项目分类

MCP 相关

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

安装

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

$npx skills add https://github.com/getsentry/skills --skill sred-project-organizer

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

附带文件references/project-template.mdreferences/SRED.md

详细介绍

SRED 项目整理

SRED 要求项目采用特定格式呈现。请整理过去一年开展过的项目,并按照 SRED 要求的格式进行总结,同时提供佐证材料。输出一份 Notion 文档,并为每个符合 SRED 要求的项目创建一个子文档。

前置条件

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

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

流程

第 1 步

请用户提供一份 Notion 文档的链接。该文档是由 sred-work-summary skill 生成的上一年度工作总结。

确保:

  • Notion 链接指向有效文档,且大致符合以下格式:
# 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]

第 2 步

对于工作总结中的每个项目,请根据 references/SRED.md 中对 SRED 项目的描述进行评估。这意味着要查看该项目相关的 Notion 文档和 PR,并判断项目工作是否符合 SRED 项目的要求。请尽量作出积极判断:可归类为 SRED 项目的项目越多越好。

输出符合 SRED 项目标准的项目列表,以及不符合该标准的项目列表。符合 SRED 描述的项目称为“SREDable”项目。

确保:

  • 工作总结中的所有项目都已归类为 SREDable 或非 SREDable。

第 3 步

询问用户 SREDable 项目列表是否正确。让用户可以手动将任何项目归类为 SREDable 或非 SREDable,并据此调整列表。

第 4 步

创建一份名为“SRED Project Descriptions”的私有 Notion 文档。输出该文档的完整链接。

步骤 5

对于每个符合 SRED 要求的项目,请按以下步骤操作。

步骤 1 创建一个私有 Notion 文档,命名为 “SRED Project Summary - ”,并将其设为步骤 4 中创建的 “SRED Project Description” 文档的子文档。该文档应遵循 references/project-template.md 中的模板。

步骤 2 填写该文档中的 Project Description 和 Project Goals 部分。根据文档这两部分中的 aside 区块提示,确定每个部分应填写哪些信息。使用 Work Summary 中收集的每个项目的所有信息。结合项目的 Notion 文档以及你自己的推理填写这些部分。

确保:

  • 项目描述不得超过 100 个单词。
  • 项目目标不得超过 100 个单词。

步骤 3 向用户提供该项目 “SRED Project Summary” 文档的完整 Notion 链接,并请用户在继续之前进行审核。根据用户提出的要求进行修改。

步骤 4 每个项目都有一个或多个不确定性。不确定性由以下问题定义:

  • 我们遇到了什么挑战或问题,但尚无答案?
  • 是否存在可用于作为问题解决依据的先例?
  • 如果没有,为什么?

查看该项目的所有 Notion 文档、Github PR 和 Linear 工单。确定该项目存在哪些不确定性,并向用户展示。询问用户这些内容是否正确,或是否需要调整。

确保:

  • 每项不确定性的描述应只有几句话。

步骤 5 将这些不确定性添加到 Project Summary Notion 文档的 “Technical Uncertainties” 部分。

确保:

  • 不确定性的描述应只有几句话。

步骤 6 对于上述发现的每项不确定性,使用 Notion 文档、Github PR 和 Linear 工单,查找为解决该不确定性而进行的实验或尝试。在该不确定性的 Experiments 部分中,为每项实验列出一个项目符号。在 Results / Learnings / Success 部分中,以项目符号列出实验结果,以及由此得出的经验或结论。对于引用的任何 Notion 文档、Github PR 或 Linear 工单,将对应资源的链接放入该不确定性的 Uncertainty-Specific Documentation & Links 部分。

确保:

  • 每项实验只列出一个项目符号。
  • 每项结果/经验/成功只列出一个项目符号。

步骤 7 获取 Work Summary 中该项目的所有链接;对于未作为某项不确定性的一部分链接的内容,将其加入 Project Summary 的 Project Documentation & Links 部分。

确保:

  • 列出所有具体链接,不要提供摘要,也不要只提供指向 Github 通知的通用链接。
  • 检查每个链接是否与该项目和/或其不确定性直接相关。

步骤 8 再次向用户提供 Project Summary 文档的链接,并请用户在继续处理下一个符合 SRED 要求的项目之前进行审核。提醒用户填写文档的 Participants 部分。

步骤 6

提供 “SRED Project Descriptions” Notion 文档的链接。

示例

Work Summary 示例:https://www.notion.so/sentry/SRED-Work-Summary-2026-30a8b10e4b5d81f5bc8df3553da55220

参考资料

项目的定义及其组织方式概述:references/SRED.md 特定项目摘要的 Notion 模板:references/project-template.md

资源

SRED 计划的完整文档:https://www.canada.ca/en/revenue-agency/services/scientific-research-experimental-development-tax-incentive-program.html

评论

支持 Markdown