贡献者沟通

Agent Client Protocol 贡献者的沟通方式

本文档说明了如何在 Agent Client Protocol (ACP) 项目中进行沟通和协作。

沟通渠道

简而言之：

  • Zulip：用于实时或临时讨论。
  • RFDs：用于对规范的拟议变更。
  • GitHub Discussions：用于结构化的、较长篇幅的讨论。
  • GitHub Issues：用于可执行的任务、bug 报告和功能请求。

所有沟通均受我们的 行为准则 约束。我们期望所有参与者在所有渠道中保持尊重、专业和包容的互动。

Zulip

用于贡献者实时讨论和协作。该服务器围绕 ACP 贡献者 构建，不旨在作为一般 ACP 支持的场所。Zulip 服务器将同时设有公开和私有频道。在此加入 Zulip。

公开频道（默认）

  • 目的：开放的社区参与、协作开发以及透明的项目协调。
  • 主要使用场景：
    • 公开的 SDK 和工具开发
    • 社区引导 和贡献指导。
    • 社区反馈 和协作头脑风暴。
  • 应避免：
    • ACP 用户支持：参与者应阅读官方文档，并为问题或支持开启新的 GitHub Discussions。
    • 服务或产品营销：在此 Zulip 上的互动应是供应商中立的，不用于品牌建设或销售。除非用作示例或回应以规范为出发点的对话，否则不鼓励提及品牌或产品。

私有频道（例外情况）

  • 目的：机密协调和无法公开讨论的敏感事项。访问权限将限于指定的维护者。
  • 私有使用的严格标准：
    • 安全事件（CVE、协议漏洞）。
    • 人事事项（与维护者相关的讨论、行为准则政策）。
    • 部分频道将被配置为只读。例如，这适用于维护者决策。
    • 需要立即或以其他方式集中响应且受众有限的协调。
  • 透明度：
    • 所有影响社区的技术和治理决策必须记录在 RFDs、GitHub Discussions 和/或 Issues 中。
    • 与个别贡献者相关的某些事项在适当时可保持私密（例如，个人情况、纪律处分或其他敏感的个人事项）。
    • 私有频道应作为**临时”事件室”**使用，而非用于日常开发。

Zulip 上任何可能导致决策或提案的重大讨论都必须转移到 RFD、GitHub Discussion 或 GitHub Issue 中，以创建持久的、可搜索的记录。然后，提案将根据需要提升为完整的 PR 及相关工作项。

RFDs

请参阅 RFD 流程 了解其管理方式。这是实际创建协议变更的主要方式。关于特定 RFD 的对话可在为推进 RFD 而创建的相关 PR 中进行。或者，可以在 Zulip 的 rfds 频道中创建讨论，与其他贡献者进行实时讨论。

GitHub Discussions

用于关于项目方向、功能、改进和社区主题的结构化、长篇幅讨论和辩论。何时使用：

  • 公告和发布沟通
  • 社区投票和共识建立过程
  • 带有背景和理由的功能请求
    • 如果特定仓库未启用 GitHub Discussions，可以改为开启 GitHub Issue。

GitHub Issues

用于 bug 报告、功能跟踪和可执行的开发任务。何时使用：

  • 带有可重现步骤的 bug 报告
  • 具有特定范围的文档改进
  • CI/CD 问题和基础设施问题
  • 发布任务和里程碑跟踪

安全问题

请勿公开发布安全问题。 而是：

  1. 直接联系首席和/或核心维护者，或 hi@zed.dev。
  2. 遵循负责任的披露准则。