💎 Custom Prompt
Overview¶
The custom_prompt tool scans the PR code changes, and automatically generates suggestions for improving the PR code.
It shares similarities with the improve tool, but with one main difference: the custom_prompt tool will only propose suggestions that follow specific guidelines defined by the prompt in: pr_custom_prompt.prompt configuration.
The tool can be triggered automatically every time a new PR is opened, or can be invoked manually by commenting on a PR.
When commenting, use the following template:
/custom_prompt --pr_custom_prompt.prompt="
The code suggestions should focus only on the following:
- ...
- ...
"
With a configuration file, use the following template:
Remember - with this tool, you are the prompter. Be specific, clear, and concise in the instructions. Specify relevant aspects that you want the model to focus on. \ You might benefit from several trial-and-error iterations, until you get the correct prompt for your use case.
Example usage¶
Here is an example of a possible prompt, defined in the configuration file:
[pr_custom_prompt]
prompt="""\
The code suggestions should focus only on the following:
- look for edge cases when implementing a new function
- make sure every variable has a meaningful name
- make sure the code is efficient
"""
(The instructions above are just an example. We want to emphasize that the prompt should be specific and clear, and be tailored to the needs of your project)
Results obtained with the prompt above:
Configuration options¶
prompt: the prompt for the tool. It should be a multi-line string.
num_code_suggestions: number of code suggestions provided by the 'custom_prompt' tool. Default is 4.
enable_help_text: if set to true, the tool will display a help text in the comment. Default is true.