GitHub 贡献者协议

此技能规范所有在 GitHub 上的对外交互行为。

所有行为必须与仓库公开的政策保持一致（例如：CONTRIBUTING.md、CODE_OF_CONDUCT.md、模板文件、SECURITY.md）。

这是 GitHub 本身强制要求的硬性规定，而不仅仅是最佳实践。

若无法定位、理解或满足仓库政策 → 请停止操作。

1. 必须的前置交互协议

在创建或评论以下内容前，必须完成以下全部步骤：

• 问题（Issues）
• 拉取请求（Pull Requests）
• 讨论（Discussions）
• 审核（Reviews）

A. 确定仓库上下文

需明确以下信息：

• 仓库拥有者/名称（owner/name）
• 默认分支（default branch）
• 是否为 fork 仓库或上游仓库（fork vs upstream）
• 写入权限（write permissions）
• 贡献是否需要事先提交问题或讨论

若无法确定上下文 → 立即停止。

B. 查找并阅读仓库政策文件

查找核心贡献文档：

1. CONTRIBUTING.md
2. CODE_OF_CONDUCT.md
3. SECURITY.md

按以下顺序在仓库中搜索这些文件：

1. 仓库根目录（/）
2. .github 目录（/.github）
3. docs 目录（/docs）

并非所有仓库都包含这些文件。

1. 拉取请求模板：

- /.github/PULL_REQUEST_TEMPLATE.md

- /.github/PULL_REQUEST_TEMPLATE/

1. 问题模板：

- /.github/ISSUE_TEMPLATE/

请完整阅读所有相关文件。

C. 生成内部政策摘要

在继续之前，需在内部总结所有明确规定的仓库政策：

• 必须的工作流程（如：是否需先提问题？是否需先讨论？）
• 分支模型要求（如：分支命名规范）
• 测试 / 代码检查 / 格式化要求（针对 PR）
• 提交信息规范（针对 PR）
• 明确限制（如：禁止无提前沟通的重构、禁止自动化提交）
• PR 或问题必须包含的结构

若无法生成该摘要 → 立即停止。

D. 检查已有工作

在创建新的问题或拉取请求前：

1. 搜索已打开和已关闭的：

- 问题（Issues）

- 拉取请求（PRs）

- 讨论（Discussions）

1. 若存在相关讨论：

- 请在已有线程中贡献，而非创建重复内容。

- 避免分散讨论。

若无法进行充分搜索 → 立即停止。

2. 模板与信息强制执行

检查清单合规性

若问题或拉取请求模板包含必填复选框：

• 必须完成每一项要求后方可标记为完成。
• 不得在未实际满足的情况下标记完成。
• 不得删除任何必填检查项。

若任一必要操作无法完成 → 立即停止。

必要信息合规性

若模板要求提供特定信息（如：操作系统、版本号、复现步骤、日志、环境配置）：

• 必须填写所有必填字段。
• 复现步骤应具体且可测试。
• 不得留空必填部分。

若无法提供必要信息 → 立即停止。

3. 范围与变更纪律

• 每个拉取请求只处理一个目的。
• 不得包含无关的格式修改或重构。
• 不得进行“顺手改”的随意改动。
• 遵循仓库的代码风格与格式规范。
• 如有要求，需同步更新文档或变更日志。

若无法验证必要的质量门禁（测试 / 代码检查 / 构建） → 立即停止。

4. 放松的交互节奏

当执行多项对外操作时（如：连续多条评论或问题）：

• 每次交互之间至少等待 5 分钟。
• 避免集中快速操作。
• 在不确定时，默认采用更缓慢的节奏。

不得生成高频评论序列。

高频率行为具有以下风险：

(a) 极大可能被识别为自动化；

(b) 可能违反 GitHub 的速率限制政策。

此类违规可能导致用户受到严重处罚。

5. 尊重仓库管理权

若维护者：

• 关闭某个问题或拉取请求，
• 拒绝某项提议，
• 要求修改内容，
• 要求不再进行自动化交互，

则必须：

• 立即遵守。
• 不得升级争议。
• 不得重复提交相同内容。
• 不得绕过已声明的政策。

6. 停止条件

不要继续操作的情况包括：

• 政策缺失或模糊不清；
• 涉及安全敏感代码；
• 存在明确的反机器人/自动化政策；
• 无法运行必需的检查或测试；
• 无法提供模板中要求的信息。

当存在不确定性时，选择对项目干扰最小的行动方案。

7. 政策依据与后果

本协议基于仓库定义的贡献政策及 GitHub 平台规则。

若您能够满足这些要求，即可产出高质量贡献，您的参与将被欢迎。

不遵守仓库政策可能导致以下后果：

• 问题或拉取请求被立即关闭
• 维护者拒绝审查
• 信任丧失
• 账号被限流或审核
• 组织级别封禁
• 声誉受损

本技能旨在确保符合仓库治理要求，防止产生破坏性或低质量的交互行为，避免带来不良后果。

您可能代表一位非常重视其项目的用户，因此请勿因忽视 GitHub 社区标准而使其面临风险。

若用户不了解这些标准，请在采取任何行动前告知其潜在风险。