Refactor prompt analyzer messages for improved readability and clarity

config.yml

@@ -269,10 +269,10 @@ prompt_templates:
           * Ignore all Acceptable Differences and focus on Unacceptable Differences.
           * Suggest formal changes first, then semantic changes.
           * Provide your suggestions in a Markdown list, nothing else. Output only the suggestions related with Unacceptable Differences.
-          * Start every suggestion with [`The System Message should ...`](command:_github.copilot.openSymbolFromReferences?%5B%22The%20System%20Message%20should%20...%22%2C%5B%7B%22uri%22%3A%7B%22%24mid%22%3A1%2C%22fsPath%22%3A%22%2Fhome%2Fyale%2Fwork%2Fmeta-prompt%2Fmeta_prompt%2Fconsts.py%22%2C%22external%22%3A%22file%3A%2F%2F%2Fhome%2Fyale%2Fwork%2Fmeta-prompt%2Fmeta_prompt%2Fconsts.py%22%2C%22path%22%3A%22%2Fhome%2Fyale%2Fwork%2Fmeta-prompt%2Fmeta_prompt%2Fconsts.py%22%2C%22scheme%22%3A%22file%22%7D%2C%22pos%22%3A%7B%22line%22%3A26%2C%22character%22%3A139%7D%7D%5D%5D "Go to definition").
+          * Start every suggestion with [`The System Message should ...`].
           * Figue out the contexts of the System Message that conflict with the suggestions, and suggest modification or deletion.
-          * While the Expected Output won't be shown to the prompt developer who will read your suggestions, do not simply describe the output as being the same/similar/different from the Expected Output, such as [`the output should not use a different format and style compared to the Expected Output`](command:_github.copilot.openSymbolFromReferences?%5B%22the%20output%20should%20not%20use%20a%20different%20format%20and%20style%20compared%20to%20the%20Expected%20Output%22%2C%5B%7B%22uri%22%3A%7B%22%24mid%22%3A1%2C%22fsPath%22%3A%22%2Fhome%2Fyale%2Fwork%2Fmeta-prompt%2Fmeta_prompt%2Fconsts.py%22%2C%22external%22%3A%22file%3A%2F%2F%2Fhome%2Fyale%2Fwork%2Fmeta-prompt%2Fmeta_prompt%2Fconsts.py%22%2C%22path%22%3A%22%2Fhome%2Fyale%2Fwork%2Fmeta-prompt%2Fmeta_prompt%2Fconsts.py%22%2C%22scheme%22%3A%22file%22%7D%2C%22pos%22%3A%7B%22line%22%3A28%2C%22character%22%3A3%7D%7D%5D%5D "Go to definition") or [`the output should match the expected output exactly`](command:_github.copilot.openSymbolFromReferences?%5B%22the%20output%20should%20match%20the%20expected%20output%20exactly%22%2C%5B%7B%22uri%22%3A%7B%22%24mid%22%3A1%2C%22fsPath%22%3A%22%2Fhome%2Fyale%2Fwork%2Fmeta-prompt%2Fmeta_prompt%2Fconsts.py%22%2C%22external%22%3A%22file%3A%2F%2F%2Fhome%2Fyale%2Fwork%2Fmeta-prompt%2Fmeta_prompt%2Fconsts.py%22%2C%22path%22%3A%22%2Fhome%2Fyale%2Fwork%2Fmeta-prompt%2Fmeta_prompt%2Fconsts.py%22%2C%22scheme%22%3A%22file%22%7D%2C%22pos%22%3A%7B%22line%22%3A100%2C%22character%22%3A60%7D%7D%5D%5D "Go to definition"); instead, describe the expected characteristics specifically and suggest a detailed example.
-          * Avoiding the behavior should be explicitly requested (e.g. [`The System Message should explicitly state that the output shoud not ...`](command:_github.copilot.openSymbolFromReferences?%5B%22The%20System%20Message%20should%20explicitly%20state%20that%20the%20output%20shoud%20not%20...%22%2C%5B%7B%22uri%22%3A%7B%22%24mid%22%3A1%2C%22fsPath%22%3A%22%2Fhome%2Fyale%2Fwork%2Fmeta-prompt%2Fmeta_prompt%2Fconsts.py%22%2C%22external%22%3A%22file%3A%2F%2F%2Fhome%2Fyale%2Fwork%2Fmeta-prompt%2Fmeta_prompt%2Fconsts.py%22%2C%22path%22%3A%22%2Fhome%2Fyale%2Fwork%2Fmeta-prompt%2Fmeta_prompt%2Fconsts.py%22%2C%22scheme%22%3A%22file%22%7D%2C%22pos%22%3A%7B%22line%22%3A53%2C%22character%22%3A58%7D%7D%5D%5D "Go to definition")) in the System Message, if the behavior is: asked to be removed by the Suggestions; appeared in the Actual Output; but not mentioned in the Current System Message.
+          * While the Expected Output won't be shown to the prompt developer who will read your suggestions, do not simply describe the output as being the same/similar/different from the Expected Output, such as [`the output should not use a different format and style compared to the Expected Output`] or [`the output should match the expected output exactly`]; instead, describe the expected characteristics specifically and suggest a detailed example.
+          * Avoiding the behavior should be explicitly requested (e.g. [`The System Message should explicitly state that the output shoud not ...`]) in the System Message, if the behavior is: asked to be removed by the Suggestions; appeared in the Actual Output; but not mentioned in the Current System Message.
           * Expected Output text should not appear in System Message as an example. But it's OK to use some similar but distinct text as an example instead.
           * Ask to remove the Expected Output text or text highly similar to Expected Output from System Message, if it's present.
           * Provide format examples (but don't use Expected Output text as the example) or detected format name, if System Message does not.
@@ -534,10 +534,10 @@ prompt_templates:
           * Ignore all Acceptable Differences and focus on Unacceptable Differences.
           * Suggest formal changes first, then semantic changes.
           * Provide your suggestions in a Markdown list, nothing else. Output only the suggestions related with Unacceptable Differences.
-          * Start every suggestion with [`The System Message should ...`](command:_github.copilot.openSymbolFromReferences?%5B%22The%20System%20Message%20should%20...%22%2C%5B%7B%22uri%22%3A%7B%22%24mid%22%3A1%2C%22fsPath%22%3A%22%2Fhome%2Fyale%2Fwork%2Fmeta-prompt%2Fmeta_prompt%2Fconsts.py%22%2C%22external%22%3A%22file%3A%2F%2F%2Fhome%2Fyale%2Fwork%2Fmeta-prompt%2Fmeta_prompt%2Fconsts.py%22%2C%22path%22%3A%22%2Fhome%2Fyale%2Fwork%2Fmeta-prompt%2Fmeta_prompt%2Fconsts.py%22%2C%22scheme%22%3A%22file%22%7D%2C%22pos%22%3A%7B%22line%22%3A26%2C%22character%22%3A139%7D%7D%5D%5D "Go to definition").
+          * Start every suggestion with [`The System Message should ...`].
           * Figue out the contexts of the System Message that conflict with the suggestions, and suggest modification or deletion.
-          * While the Expected Output won't be shown to the prompt developer who will read your suggestions, do not simply describe the output as being the same/similar/different from the Expected Output, such as [`the output should not use a different format and style compared to the Expected Output`](command:_github.copilot.openSymbolFromReferences?%5B%22the%20output%20should%20not%20use%20a%20different%20format%20and%20style%20compared%20to%20the%20Expected%20Output%22%2C%5B%7B%22uri%22%3A%7B%22%24mid%22%3A1%2C%22fsPath%22%3A%22%2Fhome%2Fyale%2Fwork%2Fmeta-prompt%2Fmeta_prompt%2Fconsts.py%22%2C%22external%22%3A%22file%3A%2F%2F%2Fhome%2Fyale%2Fwork%2Fmeta-prompt%2Fmeta_prompt%2Fconsts.py%22%2C%22path%22%3A%22%2Fhome%2Fyale%2Fwork%2Fmeta-prompt%2Fmeta_prompt%2Fconsts.py%22%2C%22scheme%22%3A%22file%22%7D%2C%22pos%22%3A%7B%22line%22%3A28%2C%22character%22%3A3%7D%7D%5D%5D "Go to definition") or [`the output should match the expected output exactly`](command:_github.copilot.openSymbolFromReferences?%5B%22the%20output%20should%20match%20the%20expected%20output%20exactly%22%2C%5B%7B%22uri%22%3A%7B%22%24mid%22%3A1%2C%22fsPath%22%3A%22%2Fhome%2Fyale%2Fwork%2Fmeta-prompt%2Fmeta_prompt%2Fconsts.py%22%2C%22external%22%3A%22file%3A%2F%2F%2Fhome%2Fyale%2Fwork%2Fmeta-prompt%2Fmeta_prompt%2Fconsts.py%22%2C%22path%22%3A%22%2Fhome%2Fyale%2Fwork%2Fmeta-prompt%2Fmeta_prompt%2Fconsts.py%22%2C%22scheme%22%3A%22file%22%7D%2C%22pos%22%3A%7B%22line%22%3A100%2C%22character%22%3A60%7D%7D%5D%5D "Go to definition"); instead, describe the expected characteristics specifically and suggest a detailed example.
-          * Avoiding the behavior should be explicitly requested (e.g. [`The System Message should explicitly state that the output shoud not ...`](command:_github.copilot.openSymbolFromReferences?%5B%22The%20System%20Message%20should%20explicitly%20state%20that%20the%20output%20shoud%20not%20...%22%2C%5B%7B%22uri%22%3A%7B%22%24mid%22%3A1%2C%22fsPath%22%3A%22%2Fhome%2Fyale%2Fwork%2Fmeta-prompt%2Fmeta_prompt%2Fconsts.py%22%2C%22external%22%3A%22file%3A%2F%2F%2Fhome%2Fyale%2Fwork%2Fmeta-prompt%2Fmeta_prompt%2Fconsts.py%22%2C%22path%22%3A%22%2Fhome%2Fyale%2Fwork%2Fmeta-prompt%2Fmeta_prompt%2Fconsts.py%22%2C%22scheme%22%3A%22file%22%7D%2C%22pos%22%3A%7B%22line%22%3A53%2C%22character%22%3A58%7D%7D%5D%5D "Go to definition")) in the System Message, if the behavior is: asked to be removed by the Suggestions; appeared in the Actual Output; but not mentioned in the Current System Message.
+          * While the Expected Output won't be shown to the prompt developer who will read your suggestions, do not simply describe the output as being the same/similar/different from the Expected Output, such as [`the output should not use a different format and style compared to the Expected Output`] or [`the output should match the expected output exactly`]; instead, describe the expected characteristics specifically and suggest a detailed example.
+          * Avoiding the behavior should be explicitly requested (e.g. [`The System Message should explicitly state that the output shoud not ...`]) in the System Message, if the behavior is: asked to be removed by the Suggestions; appeared in the Actual Output; but not mentioned in the Current System Message.
           * Expected Output text should not appear in System Message as an example. But it's OK to use some similar but distinct text as an example instead.
           * Ask to remove the Expected Output text or text highly similar to Expected Output from System Message, if it's present.
           * Provide format examples (but don't use Expected Output text as the example) or detected format name, if System Message does not.
@@ -880,10 +880,10 @@ prompt_templates:
           * Ignore all Acceptable Differences and focus on Unacceptable Differences.
           * Suggest formal changes first, then semantic changes.
           * Provide your suggestions in a Markdown list, nothing else. Output only the suggestions related with Unacceptable Differences.
-          * Start every suggestion with [`The System Message should ...`](command:_github.copilot.openSymbolFromReferences?%5B%22The%20System%20Message%20should%20...%22%2C%5B%7B%22uri%22%3A%7B%22%24mid%22%3A1%2C%22fsPath%22%3A%22%2Fhome%2Fyale%2Fwork%2Fmeta-prompt%2Fmeta_prompt%2Fconsts.py%22%2C%22external%22%3A%22file%3A%2F%2F%2Fhome%2Fyale%2Fwork%2Fmeta-prompt%2Fmeta_prompt%2Fconsts.py%22%2C%22path%22%3A%22%2Fhome%2Fyale%2Fwork%2Fmeta-prompt%2Fmeta_prompt%2Fconsts.py%22%2C%22scheme%22%3A%22file%22%7D%2C%22pos%22%3A%7B%22line%22%3A26%2C%22character%22%3A139%7D%7D%5D%5D "Go to definition").
+          * Start every suggestion with [`The System Message should ...`].
           * Figue out the contexts of the System Message that conflict with the suggestions, and suggest modification or deletion.
-          * While the Expected Output won't be shown to the prompt developer who will read your suggestions, do not simply describe the output as being the same/similar/different from the Expected Output, such as [`the output should not use a different format and style compared to the Expected Output`](command:_github.copilot.openSymbolFromReferences?%5B%22the%20output%20should%20not%20use%20a%20different%20format%20and%20style%20compared%20to%20the%20Expected%20Output%22%2C%5B%7B%22uri%22%3A%7B%22%24mid%22%3A1%2C%22fsPath%22%3A%22%2Fhome%2Fyale%2Fwork%2Fmeta-prompt%2Fmeta_prompt%2Fconsts.py%22%2C%22external%22%3A%22file%3A%2F%2F%2Fhome%2Fyale%2Fwork%2Fmeta-prompt%2Fmeta_prompt%2Fconsts.py%22%2C%22path%22%3A%22%2Fhome%2Fyale%2Fwork%2Fmeta-prompt%2Fmeta_prompt%2Fconsts.py%22%2C%22scheme%22%3A%22file%22%7D%2C%22pos%22%3A%7B%22line%22%3A28%2C%22character%22%3A3%7D%7D%5D%5D "Go to definition") or [`the output should match the expected output exactly`](command:_github.copilot.openSymbolFromReferences?%5B%22the%20output%20should%20match%20the%20expected%20output%20exactly%22%2C%5B%7B%22uri%22%3A%7B%22%24mid%22%3A1%2C%22fsPath%22%3A%22%2Fhome%2Fyale%2Fwork%2Fmeta-prompt%2Fmeta_prompt%2Fconsts.py%22%2C%22external%22%3A%22file%3A%2F%2F%2Fhome%2Fyale%2Fwork%2Fmeta-prompt%2Fmeta_prompt%2Fconsts.py%22%2C%22path%22%3A%22%2Fhome%2Fyale%2Fwork%2Fmeta-prompt%2Fmeta_prompt%2Fconsts.py%22%2C%22scheme%22%3A%22file%22%7D%2C%22pos%22%3A%7B%22line%22%3A100%2C%22character%22%3A60%7D%7D%5D%5D "Go to definition"); instead, describe the expected characteristics specifically and suggest a detailed example.
-          * Avoiding the behavior should be explicitly requested (e.g. [`The System Message should explicitly state that the output shoud not ...`](command:_github.copilot.openSymbolFromReferences?%5B%22The%20System%20Message%20should%20explicitly%20state%20that%20the%20output%20shoud%20not%20...%22%2C%5B%7B%22uri%22%3A%7B%22%24mid%22%3A1%2C%22fsPath%22%3A%22%2Fhome%2Fyale%2Fwork%2Fmeta-prompt%2Fmeta_prompt%2Fconsts.py%22%2C%22external%22%3A%22file%3A%2F%2F%2Fhome%2Fyale%2Fwork%2Fmeta-prompt%2Fmeta_prompt%2Fconsts.py%22%2C%22path%22%3A%22%2Fhome%2Fyale%2Fwork%2Fmeta-prompt%2Fmeta_prompt%2Fconsts.py%22%2C%22scheme%22%3A%22file%22%7D%2C%22pos%22%3A%7B%22line%22%3A53%2C%22character%22%3A58%7D%7D%5D%5D "Go to definition")) in the System Message, if the behavior is: asked to be removed by the Suggestions; appeared in the Actual Output; but not mentioned in the Current System Message.
+          * While the Expected Output won't be shown to the prompt developer who will read your suggestions, do not simply describe the output as being the same/similar/different from the Expected Output, such as [`the output should not use a different format and style compared to the Expected Output`] or [`the output should match the expected output exactly`]; instead, describe the expected characteristics specifically and suggest a detailed example.
+          * Avoiding the behavior should be explicitly requested (e.g. [`The System Message should explicitly state that the output shoud not ...`]) in the System Message, if the behavior is: asked to be removed by the Suggestions; appeared in the Actual Output; but not mentioned in the Current System Message.
           * Expected Output text should not appear in System Message as an example. But it's OK to use some similar but distinct text as an example instead.
           * Ask to remove the Expected Output text or text highly similar to Expected Output from System Message, if it's present.
           * Provide format examples (but don't use Expected Output text as the example) or detected format name, if System Message does not.
@@ -1143,10 +1143,10 @@ prompt_templates:
           * Ignore all Acceptable Differences and focus on Unacceptable Differences.
           * Suggest formal changes first, then semantic changes.
           * Provide your suggestions in a Markdown list, nothing else. Output only the suggestions related with Unacceptable Differences.
-          * Start every suggestion with [`The System Message should ...`](command:_github.copilot.openSymbolFromReferences?%5B%22The%20System%20Message%20should%20...%22%2C%5B%7B%22uri%22%3A%7B%22%24mid%22%3A1%2C%22fsPath%22%3A%22%2Fhome%2Fyale%2Fwork%2Fmeta-prompt%2Fmeta_prompt%2Fconsts.py%22%2C%22external%22%3A%22file%3A%2F%2F%2Fhome%2Fyale%2Fwork%2Fmeta-prompt%2Fmeta_prompt%2Fconsts.py%22%2C%22path%22%3A%22%2Fhome%2Fyale%2Fwork%2Fmeta-prompt%2Fmeta_prompt%2Fconsts.py%22%2C%22scheme%22%3A%22file%22%7D%2C%22pos%22%3A%7B%22line%22%3A26%2C%22character%22%3A139%7D%7D%5D%5D "Go to definition").
+          * Start every suggestion with [`The System Message should ...`].
           * Figue out the contexts of the System Message that conflict with the suggestions, and suggest modification or deletion.
-          * While the Expected Output won't be shown to the prompt developer who will read your suggestions, do not simply describe the output as being the same/similar/different from the Expected Output, such as [`the output should not use a different format and style compared to the Expected Output`](command:_github.copilot.openSymbolFromReferences?%5B%22the%20output%20should%20not%20use%20a%20different%20format%20and%20style%20compared%20to%20the%20Expected%20Output%22%2C%5B%7B%22uri%22%3A%7B%22%24mid%22%3A1%2C%22fsPath%22%3A%22%2Fhome%2Fyale%2Fwork%2Fmeta-prompt%2Fmeta_prompt%2Fconsts.py%22%2C%22external%22%3A%22file%3A%2F%2F%2Fhome%2Fyale%2Fwork%2Fmeta-prompt%2Fmeta_prompt%2Fconsts.py%22%2C%22path%22%3A%22%2Fhome%2Fyale%2Fwork%2Fmeta-prompt%2Fmeta_prompt%2Fconsts.py%22%2C%22scheme%22%3A%22file%22%7D%2C%22pos%22%3A%7B%22line%22%3A28%2C%22character%22%3A3%7D%7D%5D%5D "Go to definition") or [`the output should match the expected output exactly`](command:_github.copilot.openSymbolFromReferences?%5B%22the%20output%20should%20match%20the%20expected%20output%20exactly%22%2C%5B%7B%22uri%22%3A%7B%22%24mid%22%3A1%2C%22fsPath%22%3A%22%2Fhome%2Fyale%2Fwork%2Fmeta-prompt%2Fmeta_prompt%2Fconsts.py%22%2C%22external%22%3A%22file%3A%2F%2F%2Fhome%2Fyale%2Fwork%2Fmeta-prompt%2Fmeta_prompt%2Fconsts.py%22%2C%22path%22%3A%22%2Fhome%2Fyale%2Fwork%2Fmeta-prompt%2Fmeta_prompt%2Fconsts.py%22%2C%22scheme%22%3A%22file%22%7D%2C%22pos%22%3A%7B%22line%22%3A100%2C%22character%22%3A60%7D%7D%5D%5D "Go to definition"); instead, describe the expected characteristics specifically and suggest a detailed example.
-          * Avoiding the behavior should be explicitly requested (e.g. [`The System Message should explicitly state that the output shoud not ...`](command:_github.copilot.openSymbolFromReferences?%5B%22The%20System%20Message%20should%20explicitly%20state%20that%20the%20output%20shoud%20not%20...%22%2C%5B%7B%22uri%22%3A%7B%22%24mid%22%3A1%2C%22fsPath%22%3A%22%2Fhome%2Fyale%2Fwork%2Fmeta-prompt%2Fmeta_prompt%2Fconsts.py%22%2C%22external%22%3A%22file%3A%2F%2F%2Fhome%2Fyale%2Fwork%2Fmeta-prompt%2Fmeta_prompt%2Fconsts.py%22%2C%22path%22%3A%22%2Fhome%2Fyale%2Fwork%2Fmeta-prompt%2Fmeta_prompt%2Fconsts.py%22%2C%22scheme%22%3A%22file%22%7D%2C%22pos%22%3A%7B%22line%22%3A53%2C%22character%22%3A58%7D%7D%5D%5D "Go to definition")) in the System Message, if the behavior is: asked to be removed by the Suggestions; appeared in the Actual Output; but not mentioned in the Current System Message.
+          * While the Expected Output won't be shown to the prompt developer who will read your suggestions, do not simply describe the output as being the same/similar/different from the Expected Output, such as [`the output should not use a different format and style compared to the Expected Output`] or [`the output should match the expected output exactly`]; instead, describe the expected characteristics specifically and suggest a detailed example.
+          * Avoiding the behavior should be explicitly requested (e.g. [`The System Message should explicitly state that the output shoud not ...`]) in the System Message, if the behavior is: asked to be removed by the Suggestions; appeared in the Actual Output; but not mentioned in the Current System Message.
           * Expected Output text should not appear in System Message as an example. But it's OK to use some similar but distinct text as an example instead.
           * Ask to remove the Expected Output text or text highly similar to Expected Output from System Message, if it's present.
           * Provide format examples (but don't use Expected Output text as the example) or detected format name, if System Message does not.