## ADDED Requirements ### Requirement: 提供标准化 GitHub Issue 模板 项目 SHALL 在 `.github/ISSUE_TEMPLATE/` 下提供至少两个 Issue 模板:Bug 报告模板和功能请求模板,引导贡献者提供必要信息。 #### Scenario: Bug 报告模板包含必要字段 - **WHEN** 用户在 GitHub 上新建 Issue 并选择「Bug 报告」 - **THEN** 模板 SHALL 包含:问题描述、复现步骤、预期行为、实际行为、环境信息(Python 版本、操作系统) #### Scenario: 功能请求模板包含场景描述 - **WHEN** 用户选择「功能请求」模板 - **THEN** 模板 SHALL 包含:问题/需求背景、期望的解决方案、替代方案考虑 ### Requirement: 提供 Pull Request 模板 项目 SHALL 在 `.github/pull_request_template.md` 提供 PR 模板,引导贡献者说明变更范围和测试情况。 #### Scenario: PR 模板包含变更说明和测试确认 - **WHEN** 贡献者在 GitHub 上发起 Pull Request - **THEN** 模板 SHALL 包含:变更类型(Bug Fix / Feature / Docs / Refactor)、变更描述、测试说明、相关 Issue 引用 ### Requirement: 包含行为准则文件 项目根目录 SHALL 包含 `CODE_OF_CONDUCT.md`,采用 Contributor Covenant v2.1 中文版,明确社区行为规范和违规处理方式。 #### Scenario: 行为准则文件可访问 - **WHEN** 贡献者查看项目根目录 - **THEN** `CODE_OF_CONDUCT.md` SHALL 存在,包含社区行为规范、适用范围、执行说明、联系方式 ### Requirement: 包含安全漏洞报告政策 项目根目录 SHALL 包含 `SECURITY.md`,说明如何负责任地披露安全漏洞、支持的版本范围和响应时间承诺。 #### Scenario: 安全政策文件包含报告方式 - **WHEN** 安全研究者发现漏洞 - **THEN** `SECURITY.md` SHALL 提供私下联系方式(邮件或 GitHub Security Advisory),不要求通过公开 Issue 上报