From a40a28b3add5b8621d70cd231d07acf2bee327ff Mon Sep 17 00:00:00 2001 From: jennypng <63012604+JennyPng@users.noreply.github.com> Date: Mon, 1 Dec 2025 10:04:35 -0800 Subject: [PATCH 1/4] prompt improvement --- .../instructions/azsdk-tools/verify-setup.instructions.md | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/eng/common/instructions/azsdk-tools/verify-setup.instructions.md b/eng/common/instructions/azsdk-tools/verify-setup.instructions.md index be401efcd406..710be64a4ac8 100644 --- a/eng/common/instructions/azsdk-tools/verify-setup.instructions.md +++ b/eng/common/instructions/azsdk-tools/verify-setup.instructions.md @@ -14,6 +14,8 @@ Your goal is to identify the project repo root, and pass in the `packagePath` to The user can specify multiple languages to check. If the user wants to check all languages, pass in ALL supported languages. Passing in no languages will only check the core requirements. ## Output -Display results in a user-friendly and concise format, highlighting any missing dependencies that need to be addressed and how to resolve them. +Display results in an informative and concise step-by-step instructional format, highlighting any missing dependencies that need to be addressed and how to resolve them. Organize requirements by language category. + +Based on the user's shell environment, enhance the tool instructions with shell-specific commands for setting environment variables or installing dependencies. When Python tool requirements fail, inform the user about the `AZSDKTOOLS_PYTHON_VENV_PATH` environment variable if they have setup issues. The verify-setup tool can only check Python requirements within the virtual environment specified by this environment variable. From 4a1d16068ef24f3d1ef2b4ce8e0e5bb5b221ddf6 Mon Sep 17 00:00:00 2001 From: jennypng <63012604+JennyPng@users.noreply.github.com> Date: Mon, 1 Dec 2025 10:09:56 -0800 Subject: [PATCH 2/4] minor --- .../instructions/azsdk-tools/verify-setup.instructions.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/eng/common/instructions/azsdk-tools/verify-setup.instructions.md b/eng/common/instructions/azsdk-tools/verify-setup.instructions.md index 710be64a4ac8..1251e471bbeb 100644 --- a/eng/common/instructions/azsdk-tools/verify-setup.instructions.md +++ b/eng/common/instructions/azsdk-tools/verify-setup.instructions.md @@ -16,6 +16,6 @@ The user can specify multiple languages to check. If the user wants to check all ## Output Display results in an informative and concise step-by-step instructional format, highlighting any missing dependencies that need to be addressed and how to resolve them. Organize requirements by language category. -Based on the user's shell environment, enhance the tool instructions with shell-specific commands for setting environment variables or installing dependencies. +Based on the user's shell environment, enhance the tool instructions with shell-specific commands for resolving missing dependencies. When Python tool requirements fail, inform the user about the `AZSDKTOOLS_PYTHON_VENV_PATH` environment variable if they have setup issues. The verify-setup tool can only check Python requirements within the virtual environment specified by this environment variable. From 9a42609035a72adaf05761f6b83418c5b3421595 Mon Sep 17 00:00:00 2001 From: jennypng <63012604+JennyPng@users.noreply.github.com> Date: Thu, 4 Dec 2025 09:49:20 -0800 Subject: [PATCH 3/4] test making copilot install for you --- .../instructions/azsdk-tools/verify-setup.instructions.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/eng/common/instructions/azsdk-tools/verify-setup.instructions.md b/eng/common/instructions/azsdk-tools/verify-setup.instructions.md index 1251e471bbeb..fe13bf5eea00 100644 --- a/eng/common/instructions/azsdk-tools/verify-setup.instructions.md +++ b/eng/common/instructions/azsdk-tools/verify-setup.instructions.md @@ -16,6 +16,6 @@ The user can specify multiple languages to check. If the user wants to check all ## Output Display results in an informative and concise step-by-step instructional format, highlighting any missing dependencies that need to be addressed and how to resolve them. Organize requirements by language category. -Based on the user's shell environment, enhance the tool instructions with shell-specific commands for resolving missing dependencies. +Based on the user's shell environment, enhance the tool instructions with shell-specific commands for resolving missing dependencies. First output a summary of all missing requirements, and then begin trying to install each one for the user. When Python tool requirements fail, inform the user about the `AZSDKTOOLS_PYTHON_VENV_PATH` environment variable if they have setup issues. The verify-setup tool can only check Python requirements within the virtual environment specified by this environment variable. From 7b8824de0041593837102c8da83045d60cecd18e Mon Sep 17 00:00:00 2001 From: jennypng <63012604+JennyPng@users.noreply.github.com> Date: Tue, 9 Dec 2025 17:01:12 -0800 Subject: [PATCH 4/4] minor --- .../instructions/azsdk-tools/verify-setup.instructions.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/eng/common/instructions/azsdk-tools/verify-setup.instructions.md b/eng/common/instructions/azsdk-tools/verify-setup.instructions.md index fe13bf5eea00..54fc60f4ad52 100644 --- a/eng/common/instructions/azsdk-tools/verify-setup.instructions.md +++ b/eng/common/instructions/azsdk-tools/verify-setup.instructions.md @@ -5,7 +5,7 @@ description: 'Verify Setup' ## Goal This tool verifies the developer's environment for SDK development and release tasks. It returns what requirements are missing for the specified languages and repo, or success if all requirements are satisfied. -Your goal is to identify the project repo root, and pass in the `packagePath` to the Verify Setup tool. For a language repo, pass in the language of the repo. +Your goal is to identify the project repo root, and pass in the `packagePath` to the Verify Setup tool. For a language repo, pass in the language of the repo. ## Examples - in `azure-sdk-for-js`, run `azsdk_verify_setup` with `(langs=javascript, packagePath=/azure-sdk-for-js)`. @@ -14,8 +14,8 @@ Your goal is to identify the project repo root, and pass in the `packagePath` to The user can specify multiple languages to check. If the user wants to check all languages, pass in ALL supported languages. Passing in no languages will only check the core requirements. ## Output -Display results in an informative and concise step-by-step instructional format, highlighting any missing dependencies that need to be addressed and how to resolve them. Organize requirements by language category. +Display clear, step-by-step instructions on how to resolve any missing requirements identified. Explain why the requirement is necessary if it has a `reason` field. Organize requirements into categorical sections. -Based on the user's shell environment, enhance the tool instructions with shell-specific commands for resolving missing dependencies. First output a summary of all missing requirements, and then begin trying to install each one for the user. +Based on the user's shell environment, enhance the tool instructions with shell-specific commands for resolving missing dependencies. When Python tool requirements fail, inform the user about the `AZSDKTOOLS_PYTHON_VENV_PATH` environment variable if they have setup issues. The verify-setup tool can only check Python requirements within the virtual environment specified by this environment variable.