name: sred-project-organizer
description: Take a list of projects and their related documentation, and organize them into the SRED format for submission.
risk: critical
source: community
SRED 项目组织
SRED 期望项目以特定格式呈现。获取过去一年中已处理的项目列表,并将其总结为 SRED 期望的格式,附上支持证据。输出一个 Notion 文档,其中每个可 SRED 项目都有一个子文档。
使用时机
- 你需要将上一年的工作总结转变为 SRED 格式的项目文档。
- 任务涉及将项目分类为可 SRED、收集证据并在 Notion 中组织输出。
- 你已经拥有或准备生成此组织器依赖的上游工作总结。
前置条件
开始之前,确保可以访问 Github、Notion 和 Linear。Notion 和 Linear 应使用 MCP 连接。Github 可以使用 MCP 连接,但如果你有权访问ghCLI 工具,也可以使用它。
如果其中任何一项无法访问,请在继续之前提示用户授予访问权限。
流程
步骤 1
提示用户提供一个 Notion 文档的链接,该文档是由sred-work-summary技能生成的上一年的工作总结。
确保:
- 该 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
对于工作总结中的每个项目,根据${CLAUDE_SKILL_ROOT}/references/SRED.md中对 SRED 项目的描述对其进行评估。这意味着查看项目的相关 Notion 文档和 PR,并判断项目工作是否看起来是有效的 SRED 项目。对此要采取规定性做法:能被分类为 SRED 项目的项目越多越好。
输出看起来符合 SRED 模型描述的项目列表,以及不符合该模型的项目列表。符合 SRED 描述的项目列表称为"可 SRED"项目。
确保:
- 工作总结中的所有项目都已被分类为可 SRED 或不可 SRED。
步骤 3
询问用户可 SRED 项目列表是否正确。给他们手动将任何项目分类为可 SRED 或不可 SRED 的选项,并相应调整列表。
步骤 4
创建一个名为"SRED Project Descriptions"的私有 Notion 文档。输出此文档的完整链接。
步骤 5
对于每个可 SRED 项目,经历一系列步骤。
步骤 1
创建一个名为"SRED Project Summary - "的私有 Notion 文档,它是步骤 4 中创建的"SRED Project Description"文档的子文档。该文档应遵循${CLAUDE_SKILL_ROOT}/references/project-template.md中的模板。
步骤 2
填写该文档的Project Description和Project Goals部分。使用这些部分中的aside部分作为每个部分应包含什么信息的提示。使用工作总结中收集的每个项目的所有信息。使用项目的 Notion 文档以及你自己的推理来填写这些部分。
确保:
- 项目描述不应超过 100 字。
- 项目目标不应超过 100 字。
步骤 3
向用户提供项目的"SRED Project Summary"文档的完整 Notion 链接,并在继续之前请他们审阅。按他们的要求进行更改。
步骤 4
每个项目将有一个或多个不确定性。不确定性由以下问题定义:
- 我们当时没有答案的挑战或问题是什么?
- 是否有我们可用于解决问题基础的现有技术?
- 如果没有,为什么?
审查项目的所有 Notion 文档、Github PR 和 Linear 工单。确定项目的不确定性并向用户展示。询问用户这些是否正确或应以某种方式调整。
确保:
- 每个不确定性的描述应只有几句话长。
步骤 5
将不确定性添加到"Technical Uncertainties"部分的 Project Summary notion 文档中。
确保:
- 不确定性的描述应只有几句话长。
步骤 6
对于上面发现的每个不确定性,使用 Notion 文档、Github PR 和 Linear 工单来查找为解决此不确定性所做的任何实验或尝试。在每个实验的Experiments部分中为每个实验制作一个项目符号列表。在Results / Learnings / Success部分制作一个项目符号列表,列出实验结果以及得出的任何学习或结论。对于引用的任何 Notion 文档、Github PR 或 Linear 工单,将该资源的链接放入不确定性的Uncertainty-Specific Documentation & Links部分。
确保:
- 每个实验只有一个项目符号
- 每个结果/学习/成功只有一个项目符号
步骤 7
获取工作总结中找到的项目的所有链接,对于任何未作为不确定性一部分链接的链接,将它们包含在 Project Summary 的Project Documentation & Links部分。
确保:
- 提供所有具体链接的列表,而不是摘要或指向 Github 通知的通用链接。
- 检查每个链接是否与项目和/或其不确定性直接相关。
步骤 8
再次向用户提供 Project Summary 文档的链接,并在继续下一个可 SRED 项目之前请他们审阅。提醒用户填写文档的 Participants 部分。
步骤 6
提供"SRED Project Descriptions"notion 文档的链接。
示例
示例工作总结:https://www.notion.so/sentry/SRED-Work-Summary-2026-30a8b10e4b5d81f5bc8df3553da55220
参考
什么构成项目以及应如何组织的摘要:${CLAUDE_SKILL_ROOT}/references/SRED.md
特定项目摘要的 Notion 模板:${CLAUDE_SKILL_ROOT}/references/project-template.md
资源
关于 SRED 计划的完整文档:https://www.canada.ca/en/revenue-agency/services/scientific-research-experimental-development-tax-incentive-program.html
限制
- 仅当任务明确匹配上述范围时使用本技能。
- 不要将输出视为针对特定环境验证、测试或专家审查的替代品。
- 如果缺少所需输入、权限、安全边界或成功标准,请停下来并要求澄清。