We're thrilled that you're interested in contributing to the AIBTC Agent Tools project! This document outlines the process for contributing and provides some guidelines to ensure a smooth collaboration.
-
Fork the Repository: Start by forking the agent-tools-ts repository to your GitHub account.
-
Clone the Fork: Clone your fork to your local machine:
git clone https://github.com/your-username/agent-tools-ts.git cd agent-tools-ts -
Create a Branch: Create a new branch for your feature or bug fix:
git checkout -b feature/your-feature-name -
Make Changes: Make your changes to the codebase. Be sure to follow our coding standards (see below).
-
Test Your Changes: Ensure that your changes don't break any existing functionality. Add new tests if necessary.
-
Commit Your Changes: Commit your changes with a clear and descriptive commit message:
git commit -m "Add a brief description of your changes" -
Push to Your Fork: Push your changes to your GitHub fork:
git push origin feature/your-feature-name -
Create a Pull Request: Go to the original agent-tools-ts repository on GitHub and create a new pull request from your feature branch.
- Follow the existing code style in the project.
- Use TypeScript for all new scripts.
- Write clear, commented code that others can easily understand and maintain.
- Include appropriate error handling and logging.
- Add a test file that covers the script functionality.
- Update the README.md if you're adding new features or changing existing functionality.
If you find a bug or have a suggestion for improvement:
- Check if the issue already exists in the GitHub Issues.
- If not, create a new issue, providing as much detail as possible, including steps to reproduce for bugs.
- Ensure your code adheres to the coding standards outlined above.
- Update the README.md with details of changes to the interface, if applicable.
- Your pull request will be reviewed by the maintainers. Be open to feedback and be prepared to make changes if requested.
- Once approved, your pull request will be merged into the main branch.
If you have any questions about contributing, feel free to ask in the AIBTC Discord or reach out to us on X @aibtcdev.
Thank you for contributing to AIBTC Agent Tools!