diff --git a/.github/skills/README.md b/.github/skills/README.md index 934af3e10a5..44d81be6be0 100644 --- a/.github/skills/README.md +++ b/.github/skills/README.md @@ -17,7 +17,7 @@ to match and distribute them to all subscribed language SDK repos. | Skill | Triggers | Description | | ----- | -------- | ----------- | -| [azsdk-common-generate-sdk-locally](azsdk-common-generate-sdk-locally/SKILL.md) | "generate SDK locally", "build SDK", "run SDK tests" | Generate, build, and test Azure SDKs locally from TypeSpec | +| [azsdk-common-generate-sdk-locally](azsdk-common-generate-sdk-locally/SKILL.md) | "generate SDK locally", "build SDK", "run SDK tests", "run CI checks", "passes all checks" | Generate, build, and test Azure SDKs locally from TypeSpec | | [azsdk-common-prepare-release-plan](azsdk-common-prepare-release-plan/SKILL.md) | "create release plan", "link SDK PR to plan" | Create and manage release plan work items | | [azsdk-common-apiview-feedback-resolution](azsdk-common-apiview-feedback-resolution/SKILL.md) | "APIView comments", "resolve API review feedback" | Retrieve and resolve APIView review feedback | | [azsdk-common-pipeline-troubleshooting](azsdk-common-pipeline-troubleshooting/SKILL.md) | "pipeline failed", "build failure", "CI check failing" | Diagnose and resolve SDK CI and generation pipeline failures | diff --git a/.github/skills/azsdk-common-generate-sdk-locally/SKILL.md b/.github/skills/azsdk-common-generate-sdk-locally/SKILL.md index 8f23faadd8c..c5972212f05 100644 --- a/.github/skills/azsdk-common-generate-sdk-locally/SKILL.md +++ b/.github/skills/azsdk-common-generate-sdk-locally/SKILL.md @@ -4,7 +4,7 @@ license: MIT metadata: version: "1.1.0" distribution: shared -description: "Generate, build, and test Azure SDKs locally from TypeSpec with automatic customization. WHEN: \"generate SDK locally\", \"build SDK\", \"run SDK tests\", \"update changelog\", \"fix SDK build errors\", \"fix breaking changes\", \"resolve SDK generation errors\", \"customize TypeSpec\", \"rename SDK client\", \"rename SDK model\", \"hide operation from SDK\", \"fix analyzer errors\", \"resolve customization drift\", \"create subclient\", \"update metadata\", \"update version\". DO NOT USE FOR: publishing to package registries, CI pipeline configuration, API design review. INVOKES: azsdk_verify_setup, azsdk_package_generate_code, azsdk_package_build_code, azsdk_package_run_check, azsdk_package_run_tests, azsdk_customized_code_update, azsdk_package_update_changelog_content, azsdk_package_update_metadata, azsdk_package_update_version." +description: "Generate, build, and test Azure SDKs locally from TypeSpec with automatic customization. WHEN: \"generate SDK locally\", \"build SDK\", \"run SDK tests\", \"run CI checks\", \"validate CI checks\", \"passes all checks\", \"run all checks\", \"validate package\", \"update changelog\", \"fix SDK build errors\", \"fix breaking changes\", \"resolve SDK generation errors\", \"customize TypeSpec\", \"rename SDK client\", \"rename SDK model\", \"hide operation from SDK\", \"fix analyzer errors\", \"resolve customization drift\", \"create subclient\", \"update metadata\", \"update version\". DO NOT USE FOR: publishing to package registries, CI pipeline YAML configuration, API design review. INVOKES: azsdk_verify_setup, azsdk_package_generate_code, azsdk_package_build_code, azsdk_package_run_check, azsdk_package_run_tests, azsdk_customized_code_update, azsdk_package_update_changelog_content, azsdk_package_update_metadata, azsdk_package_update_version." compatibility: requires: "azure-sdk-mcp server, local azure-sdk-for-{language} clone, language build tools" --- @@ -29,6 +29,8 @@ Prerequisites: azure-sdk-mcp server must be running. Without MCP, use `npx tsp-c ## Steps +> **CI checks only** (build + validate + test without regeneration): If the user asks to "run CI checks", "validate" or "check if a package passes all checks", skip to step 6. CI checks = build (`azsdk_package_build_code`) + validate (`azsdk_package_run_check`) + test (`azsdk_package_run_tests`). + 1. **Select language** — Confirm target language: .NET, Java, JavaScript, Python, Go, or Rust. 2. **Verify repo** — Ensure the user has a local clone of the correct [SDK repo](references/sdk-repos.md). If not cloned, instruct user to clone it. 3. **Identify config file** — Determine the path to the TypeSpec configuration file. See [config file details](references/detailed-workflow.md). @@ -60,6 +62,9 @@ Prerequisites: azure-sdk-mcp server must be running. Without MCP, use `npx tsp-c - "Update the changelog for this SDK package" - "Update the package version" - "Update the package metadata and ci.yml" +- "Can you run the CI checks for Azure.Health.Deidentification" +- "Can you validate Azure.Search.Documents passes all checks?" +- "Run all checks for the Azure.Storage.Blobs package" ## Troubleshooting diff --git a/plugins/azure-sdk-tools/skills/README.md b/plugins/azure-sdk-tools/skills/README.md index 9f4e0565727..9e529b789d9 100644 --- a/plugins/azure-sdk-tools/skills/README.md +++ b/plugins/azure-sdk-tools/skills/README.md @@ -15,7 +15,7 @@ Shared skills (those distributed to other Azure SDK repositories) are identified | Skill | Triggers | Description | | ----- | -------- | ----------- | -| [generate-sdk-locally](generate-sdk-locally/SKILL.md) | "generate SDK locally", "build SDK", "run SDK tests" | Generate, build, and test Azure SDKs locally from TypeSpec | +| [generate-sdk-locally](generate-sdk-locally/SKILL.md) | "generate SDK locally", "build SDK", "run SDK tests", "run CI checks", "passes all checks" | Generate, build, and test Azure SDKs locally from TypeSpec | | [prepare-release-plan](prepare-release-plan/SKILL.md) | "create release plan", "link SDK PR to plan" | Create and manage release plan work items | | [apiview-feedback-resolution](apiview-feedback-resolution/SKILL.md) | "APIView comments", "resolve API review feedback" | Retrieve and resolve APIView review feedback | | [pipeline-troubleshooting](pipeline-troubleshooting/SKILL.md) | "pipeline failed", "build failure", "CI check failing" | Diagnose and resolve SDK CI and generation pipeline failures | diff --git a/plugins/azure-sdk-tools/skills/generate-sdk-locally/SKILL.md b/plugins/azure-sdk-tools/skills/generate-sdk-locally/SKILL.md index aaef5ba0791..ff913d0db55 100644 --- a/plugins/azure-sdk-tools/skills/generate-sdk-locally/SKILL.md +++ b/plugins/azure-sdk-tools/skills/generate-sdk-locally/SKILL.md @@ -4,7 +4,7 @@ license: MIT metadata: version: "1.1.0" distribution: shared -description: "Generate, build, and test Azure SDKs locally from TypeSpec with automatic customization. WHEN: \"generate SDK locally\", \"build SDK\", \"run SDK tests\", \"update changelog\", \"fix SDK build errors\", \"fix breaking changes\", \"resolve SDK generation errors\", \"customize TypeSpec\", \"rename SDK client\", \"rename SDK model\", \"hide operation from SDK\", \"fix analyzer errors\", \"resolve customization drift\", \"create subclient\", \"update metadata\", \"update version\". DO NOT USE FOR: publishing to package registries, CI pipeline configuration, API design review. INVOKES: azsdk_verify_setup, azsdk_package_generate_code, azsdk_package_build_code, azsdk_package_run_check, azsdk_package_run_tests, azsdk_customized_code_update, azsdk_package_update_changelog_content, azsdk_package_update_metadata, azsdk_package_update_version." +description: "Generate, build, and test Azure SDKs locally from TypeSpec with automatic customization. WHEN: \"generate SDK locally\", \"build SDK\", \"run SDK tests\", \"run CI checks\", \"validate CI checks\", \"passes all checks\", \"run all checks\", \"validate package\", \"update changelog\", \"fix SDK build errors\", \"fix breaking changes\", \"resolve SDK generation errors\", \"customize TypeSpec\", \"rename SDK client\", \"rename SDK model\", \"hide operation from SDK\", \"fix analyzer errors\", \"resolve customization drift\", \"create subclient\", \"update metadata\", \"update version\". DO NOT USE FOR: publishing to package registries, CI pipeline YAML configuration, API design review. INVOKES: azsdk_verify_setup, azsdk_package_generate_code, azsdk_package_build_code, azsdk_package_run_check, azsdk_package_run_tests, azsdk_customized_code_update, azsdk_package_update_changelog_content, azsdk_package_update_metadata, azsdk_package_update_version." compatibility: requires: "azure-sdk-mcp server, local azure-sdk-for-{language} clone, language build tools" --- @@ -29,6 +29,8 @@ Prerequisites: azure-sdk-mcp server must be running. Without MCP, use `npx tsp-c ## Steps +> **CI checks only** (build + validate + test without regeneration): If the user asks to "run CI checks", "validate" or "check if a package passes all checks", skip to step 6. CI checks = build (`azsdk_package_build_code`) + validate (`azsdk_package_run_check`) + test (`azsdk_package_run_tests`). + 1. **Select language** — Confirm target language: .NET, Java, JavaScript, Python, Go, or Rust. 2. **Verify repo** — Ensure the user has a local clone of the correct [SDK repo](references/sdk-repos.md). If not cloned, instruct user to clone it. 3. **Identify config file** — Determine the path to the TypeSpec configuration file. See [config file details](references/detailed-workflow.md). @@ -60,6 +62,9 @@ Prerequisites: azure-sdk-mcp server must be running. Without MCP, use `npx tsp-c - "Update the changelog for this SDK package" - "Update the package version" - "Update the package metadata and ci.yml" +- "Can you run the CI checks for Azure.Health.Deidentification" +- "Can you validate Azure.Search.Documents passes all checks?" +- "Run all checks for the Azure.Storage.Blobs package" ## Troubleshooting