贡献到AgentScope

我们的社区因其成员的多样化思想和贡献而兴旺发展。无论是修复一个错误,添加一个新功能,改进文档,还是添加示例,我们都欢迎您的帮助。以下是您做出贡献的方法:

报告错误和提出新功能

当您发现一个错误或者有一个功能请求,请首先检查问题跟踪器,查看它是否已经被报告。如果没有,随时可以开设一个新的问题。请包含尽可能多的细节:

  • 简明扼要的标题

  • 清晰地描述问题

  • 提供重现问题的步骤

  • 提供所使用的AgentScope版本

  • 提供所有相关代码片段或错误信息

对代码库做出贡献

Fork和Clone仓库

要处理一个问题或新功能,首先要Fork AgentScope仓库,然后将你的Fork克隆到本地。

git clone https://github.com/your-username/agentscope.git
cd agentscope

创建一个新分支

为您的工作创建一个新分支。这有助于保持拟议更改的组织性,并与main分支分离。

git checkout -b your-feature-branch-name

做出修改

创建您的新分支后就可以对代码进行修改了。请注意如果您正在解决多个问题或实现多个功能,最好为每个问题或功能创建单独的分支和拉取请求。

我们提供了一个开发者版本,与官方版本相比,它附带了额外的pre-commit钩子以执行格式检查:

# 安装开发者版本
pip install -e .[dev]
# 安装 pre-commit 钩子
pre-commit install

提交您的修改

修改完成之后就是提交它们的时候了。请提供清晰而简洁的提交信息,以解释您的修改内容。

git add -U
git commit -m "修改内容的简要描述"

运行时您可能会收到 pre-commit 给出的错误信息。请根据错误信息修改您的代码然后再次提交。

提交 Pull Request

当您准备好您的修改分支后,向AgentScope的 main 分支提交一个Pull Request。在您的Pull Request描述中,解释您所做的修改以及其他相关的信息。

我们将审查您的Pull Request。这个过程可能涉及一些讨论以及额外的代码修改。

代码审查

等待我们审核您的Pull Request。我们可能会提供一些更改或改进建议。请留意您的GitHub通知,并对反馈做出响应。

[Return to the top]