Context
This tracks the Java rollout for Azure/azure-sdk-tools#16348
Before enabling the shared language-repository eval pipeline, add current-format Vally coverage for the Java-specific Agent Skills. Shared azsdk-common-* skills already carry centrally synced evals and should not be duplicated or independently modified here.
Use these sources of truth:
Do not copy the eval-authoring-* meta-skills into this repository.
Skill eval work
Add or update Vally coverage for every Java-owned skill under .github/skills/:
agentic-workflows
.github/skills/azsdk-java-patch-mergeback (use the canonical skill name from its SKILL.md in graders and tags)
create-package-skill
find-package-skill
management-autopr-review
For each skill:
- Read its
SKILL.md, especially its activation boundaries, guardrails, and invoked tools or commands.
- Put new routing and capability coverage in
.github/skills/<skill>/evals/eval.yaml. Split into additional <behavior>.eval.yaml files only when coverage is genuinely large.
- Add at least three realistic triggers and three anti-triggers using
skill-invocation.
- For a boundary prompt, mount the closest competing skill, require that skill, and disallow the skill under test.
- Add capability or guardrail stimuli using
tool-calls and deterministic output, file, or command graders where applicable.
- Supply concrete Maven coordinates, repository paths, PR details, patch branch names, or other identifiers needed to complete the request.
- Use hermetic fixtures and the mock MCP. Do not use secrets, network-dependent writes, or production targets.
- Set
tags.area to the exact canonical skill name, use defaults:, and set scoring.threshold: 0.8.
Cover meaningful boundaries, including:
create-package-skill versus find-package-skill and ordinary package modification.
- Patch merge-back versus triggering a release, starting a patch cycle, or general SDK generation.
management-autopr-review versus APIView feedback resolution, implementation, and general pipeline repair.
agentic-workflows versus Java SDK CI, package, or release workflows.
Audit the existing management-autopr-review/evals/ suite (trigger, true-negatives, findings, and orchestration) against the current four-layer guidance. Preserve its useful fixtures and behavior coverage. Reconcile its nested .vally.yaml with the new repository-level configuration so local commands and CI use one clear environment contract.
Repository configuration
Add .github/skills/.vally.yaml following the tools-repo layout:
- Register every local and synced skill eval directory, including the existing management review suite.
- Define
azsdk-mcp-mock using ../../artifacts/mcp/mock/azsdk-mock.dll.
- Set
cwd: . for the MCP server so paths remain stable in Vally trial workspaces.
- Add
.github/skills/.gitignore for Vally results and caches.
Pipeline
Add eng/pipelines/skill-eval.yml as a thin entrypoint extending:
/eng/common/pipelines/templates/stages/archetype-eval.yml
Required configuration:
- Declare
Azure/azure-sdk-tools as repository resource azure-sdk-tools, using endpoint Azure and refs/heads/main.
- Use
/eng/common/pipelines/templates/steps/eval-mcp-setup.yml.
- Set
TestType: mock and toolsRepo: azure-sdk-tools.
- Set
vallyRoot: .github/skills.
- Discover both
*/evals/eval.yaml and */evals/*.eval.yaml so local and synced suites run.
- Use
threshold: 0.8, failOnFailedTests: false, and shardTimeoutInMinutes: 20.
- Reference
/eng/pipelines/templates/variables/image.yml and AzSDK_Eval_Variable_group.
- Start manual/scheduled on
main with trigger: none and pr: none. Add selective PR triggers or blocking only after the pilot is stable.
Do not copy or customize shared eng/common framework files in this repository. Framework fixes belong in azure-sdk-tools and must arrive through the normal sync.
Register the YAML as the java - skill eval Azure DevOps pipeline and authorize its repository resource and variable group.
Acceptance criteria
Context
This tracks the Java rollout for Azure/azure-sdk-tools#16348
Before enabling the shared language-repository eval pipeline, add current-format Vally coverage for the Java-specific Agent Skills. Shared
azsdk-common-*skills already carry centrally synced evals and should not be duplicated or independently modified here.Use these sources of truth:
Do not copy the
eval-authoring-*meta-skills into this repository.Skill eval work
Add or update Vally coverage for every Java-owned skill under
.github/skills/:agentic-workflows.github/skills/azsdk-java-patch-mergeback(use the canonical skill name from itsSKILL.mdin graders and tags)create-package-skillfind-package-skillmanagement-autopr-reviewFor each skill:
SKILL.md, especially its activation boundaries, guardrails, and invoked tools or commands..github/skills/<skill>/evals/eval.yaml. Split into additional<behavior>.eval.yamlfiles only when coverage is genuinely large.skill-invocation.tool-callsand deterministic output, file, or command graders where applicable.tags.areato the exact canonical skill name, usedefaults:, and setscoring.threshold: 0.8.Cover meaningful boundaries, including:
create-package-skillversusfind-package-skilland ordinary package modification.management-autopr-reviewversus APIView feedback resolution, implementation, and general pipeline repair.agentic-workflowsversus Java SDK CI, package, or release workflows.Audit the existing
management-autopr-review/evals/suite (trigger,true-negatives,findings, andorchestration) against the current four-layer guidance. Preserve its useful fixtures and behavior coverage. Reconcile its nested.vally.yamlwith the new repository-level configuration so local commands and CI use one clear environment contract.Repository configuration
Add
.github/skills/.vally.yamlfollowing the tools-repo layout:azsdk-mcp-mockusing../../artifacts/mcp/mock/azsdk-mock.dll.cwd: .for the MCP server so paths remain stable in Vally trial workspaces..github/skills/.gitignorefor Vally results and caches.Pipeline
Add
eng/pipelines/skill-eval.ymlas a thin entrypoint extending:/eng/common/pipelines/templates/stages/archetype-eval.ymlRequired configuration:
Azure/azure-sdk-toolsas repository resourceazure-sdk-tools, using endpointAzureandrefs/heads/main./eng/common/pipelines/templates/steps/eval-mcp-setup.yml.TestType: mockandtoolsRepo: azure-sdk-tools.vallyRoot: .github/skills.*/evals/eval.yamland*/evals/*.eval.yamlso local and synced suites run.threshold: 0.8,failOnFailedTests: false, andshardTimeoutInMinutes: 20./eng/pipelines/templates/variables/image.ymlandAzSDK_Eval_Variable_group.mainwithtrigger: noneandpr: none. Add selective PR triggers or blocking only after the pilot is stable.Do not copy or customize shared
eng/commonframework files in this repository. Framework fixes belong inazure-sdk-toolsand must arrive through the normal sync.Register the YAML as the
java - skill evalAzure DevOps pipeline and authorize its repository resource and variable group.Acceptance criteria
azsdk-common-*evals remain centrally sourced.