positron-intake-rotation

Positron 接收轮值

概述

此技能为处理 Positron IDE 仓库的问题接收轮值提供全面指导。接收轮值是每周一至周五的值班安排，由团队成员审阅并回复新问题、讨论帖子和支持工单，以确保及时响应并对问题进行有效跟踪。

目标是在约一个工作日内响应新事项，并确保所有问题都包含可采取后续行动所需的详细信息。

🚨 重要：手动操作协议

此技能用于协助接收轮值，但绝不会直接执行 GitHub 操作。

所有 GitHub 交互都必须由用户手动完成：

• ✅ 在发布前起草回复供用户审阅
• ✅ 建议标签和分类方式
• ✅ 准备供用户执行的命令
• ✅ 搜索和分析问题与讨论
• ❌ 绝不直接发布评论或回复
• ❌ 绝不编辑问题、添加标签或更改状态
• ❌ 绝不关闭问题或创建新问题
• ❌ 绝不执行会更改 GitHub 状态的 gh 命令

**工作流：**分析 → 提议 → 起草 → 用户手动执行

何时使用此技能

在以下情况下使用此技能：

• 当前正在执行接收轮值
• 协助其他团队成员处理接收任务
• 学习接收轮值流程
• 审阅尚未设置状态的积压事项
• 回复 GitHub 讨论
• 处理客户支持工单
• 搜索重复或相关问题

快速开始

必备脚本

提供了四个 Shell 脚本，以简化接收任务：

1. scripts/fetch_intake_issues.sh - 列出尚未设置状态的开放问题（接收队列）
2. scripts/fetch_discussions.sh - 列出近期需要处理的开放讨论
3. scripts/fetch_labels.sh - 显示仓库中所有可用的分类标签
4. scripts/search_related.sh <query> - 搜索相关问题和讨论

所有脚本均支持 --json 标志，供程序化使用。请在技能目录中运行脚本。

必备参考文档

两份全面的参考文档提供了详细的工作流：

1. references/intake_workflow.md - 处理问题、讨论和支持工单的完整工作流
2. references/response_examples.md - 经验丰富的团队成员提供的回复模式和示例

起草回复或处理复杂情形时，请加载这些参考文档。

核心工作流

每日接收流程

轮值期间，请每天遵循此流程：

1. 检查新条目

   • 运行 scripts/fetch_intake_issues.sh，查看尚无状态的议题
   • 运行 scripts/fetch_discussions.sh，查看近期讨论
   • 查看 Jira 中的支持工单

2. 系统地审查每个条目

   • 阅读完整描述和上下文
   • 评估信息是否完整（是否提供了系统详情、复现步骤等？）
   • 确定条目类型（错误、功能请求、问题、重复项）

3. 搜索相关内容

   • 使用 scripts/search_related.sh "<keywords>" 查找类似议题
   • 查看文档：https://positron.posit.co/welcome.html
   • 查找有关该主题的现有讨论

4. 建议分类和整理方式

   • 运行 scripts/fetch_labels.sh 查看可用标签
   • 建议用户添加适当的标签（领域、类型、优先级）
   • 建议整理完毕后将状态设为 "Triage"
   • 建议在适用时将条目添加到 "Positron Backlog" 项目
   • 准备 gh 命令，供用户手动执行

5. 起草回复，供用户审核

   • 参考 references/response_examples.md 中的范例
   • 起草欢迎消息，感谢贡献者
   • 如果缺少信息，提出澄清问题
   • 如有可用的解决方法或相关内容链接，请一并提供
   • 对后续步骤设定切合实际的预期
   • 发布前先将草稿提交给用户审核

6. 建议后续行动

   • 如果需要专业知识，建议标记相关团队成员
   • 起草重复项关闭消息，并附上规范议题的引用
   • 在适当情况下，建议将讨论转换为议题
   • 建议轮值结束后继续跟进，或明确交接

使用 GitHub CLI

为保持一致，优先使用 GitHub CLI（gh），而非其他方法。以下所有命令均供用户手动执行。

只读命令（可执行以收集信息）：

# View issue with all comments
gh issue view <number> --repo posit-dev/positron --comments

# Search issues
gh issue list --repo posit-dev/positron --search "<query>" --state all

# View discussion
gh api graphql -f query='...' # (see scripts for examples)

修改命令（为用户准备，绝不可直接执行）：

# Add labels - DRAFT THIS COMMAND for user to run
gh issue edit <number> --repo posit-dev/positron --add-label "area: console,Bug"

# Close as duplicate - DRAFT THIS COMMAND for user to run
gh issue close <number> --repo posit-dev/positron --comment "Closing as duplicate of #<canonical-number>"

**重要提示：**请将修改命令放在代码块中提供给用户，并明确说明用户需要先审核，再手动执行。

处理不同场景

错误报告

对于错误报告，请评估信息是否完整：

完整的错误报告：

• 系统详情（Positron 版本、操作系统、提交哈希）
• 清晰的复现步骤
• 预期行为与实际行为
• 错误消息或屏幕截图

如果信息完整：

1. 使用 scripts/search_related.sh 搜索重复项
2. 建议用户添加标签（领域、“Bug” 类型）
3. 建议将状态设为 "Triage"
4. 起草回复，感谢报告者并确认已收到问题

如果信息不完整：

1. 起草消息，感谢报告者
2. 提出有关缺失信息的具体问题
3. 如有帮助，建议参考错误报告模板
4. 建议在提供信息前保持议题开放

有关错误处理工作流的详情，请参阅 references/intake_workflow.md。

功能请求

对于功能请求：

1. 起草消息，感谢用户提出建议
2. 搜索现有的相关功能请求
3. 如果是重复项，起草一条链接到现有议题的消息（由用户手动关闭）
4. 如果是新请求，建议添加标签，并建议将其加入待办事项
5. 起草消息，对优先级安排设定切合实际的预期

讨论

对于讨论：

1. 确定讨论类型（问题、想法、错误报告、公告）
2. 起草合适的回复：
   • **问题：**提供答案或文档链接
   • **想法：**表示认可，并链接到相关议题
   • **错误报告：**请用户创建正式议题
   • **无关内容：**礼貌地引导至其他渠道

建议将讨论转为议题，当其中包含明确且可执行的错误报告或功能请求时（由用户手动转换）。

支持工单

支持工单需要特殊处理：

⚠️ **重要：**绝不要在公开议题或讨论中提及客户姓名

1. 在 Jira 中查看工单背景
2. 搜索相关的公开议题
3. 在 Jira 中起草回复（不要公开发布），供用户发布
4. 如有需要，建议创建经过脱敏处理的公开议题
5. 建议在工单和议题之间建立关联

安全问题

如果议题描述了安全漏洞：

1. 切勿公开讨论详情
2. 起草消息，请报告者发送邮件至 [email protected]
3. 建议关闭公开议题，并附上有关通过私下渠道报告的说明（由用户手动关闭）
4. 建议私下提醒团队

回复指南

语气和风格

**热情友好：**感谢贡献者付出的时间和精力

**表达清晰：**使用简单的语言，解释技术术语，并提供示例

**乐于助人：**提供变通方案、资源链接和后续步骤

**切合实际：**不要过度承诺时间安排或解决方案

**保持专业：**即使报告者感到沮丧，也要保持冷静并积极沟通

借鉴示例

如需查看经验丰富的团队成员提供的示例：

# Find issues commented on by key team members
gh search issues --repo posit-dev/positron --commenter juliasilge --limit 20
gh search issues --repo posit-dev/positron --commenter jmcphers --limit 20

# View specific issue with comments
gh issue view <number> --repo posit-dev/positron --comments

请特别留意 juliasilge 和 jmcphers 的回复，从中了解语气和处理方式。

加载 references/response_examples.md，了解详细的回复模式和反面示例。

重要提醒

团队协作

**不要试图独自解决所有问题。**遇到以下情况时，请联系团队成员：

• 议题需要特定领域的专业知识
• 你不确定如何分类或确定优先级
• 议题描述了复杂的技术问题
• 你需要帮助理解用户的疑虑

交接流程

如果某项工作的处理时间超出你的轮值周：

• **通常情况下：**继续自行跟进，直至完成分诊
• **如果无法继续：**明确告知下一位轮值人员进行交接
• 不要在没有明确交接的情况下搁置事项

文档

如果出现反复发生的问题或常见疑问：

• 考虑编写常见问题条目
• 建议改进文档
• 记录相关模式，供团队讨论

快速参考链接

• 议题受理看板 - 尚未设置状态的议题
• 讨论 - 社区讨论
• 支持工单 - 客户支持（Jira）
• 轮值安排 - Google 表格
• 文档 - Positron 官方文档
• Positron 助手 - GitHub 议题助手

工作流摘要

Daily Intake (Assistant Mode - Draft & Recommend):
1. Fetch new items (scripts/fetch_intake_issues.sh, scripts/fetch_discussions.sh)
2. Review and assess each item
3. Search for related content (scripts/search_related.sh)
4. SUGGEST labels and categorization (scripts/fetch_labels.sh)
5. DRAFT response (references/response_examples.md) for user review
6. PREPARE gh commands for user to execute
7. RECOMMEND setting status to "Triage" (user executes)
8. ADVISE on follow-through or handoff

Remember: The goal is to ASSIST the user with timely response and actionable
organization. NEVER execute GitHub modification commands directly - always
present drafts and recommendations for the user to review and execute manually.