From d6635abe59f249795221083eefa583456341b268 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 e22f457aac9ecdcf61ead155d21d166be0bd3d3b 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 ef19b218db3a8792d0079eb605ed465c1e62a639 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 341f3e1729b9591f0aabd2ac7ca0cbd3162ea866 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.