[search] Expand azure-search-documents skill with full release workflow

[hizixin]

The existing skill on main covered only the post-regeneration _patch.py audit (SKILL.md + customizations.md). This commit expands it into the full release workflow (Phase 0-7: scope, generate, sync, test, lint, changelog, samples, version) and reorganizes the customization material so each file has a single concern.

• SKILL.md: rewritten as the workflow backbone; _patch.py reconciliation is now Phase 2 of a larger pipeline.

• references/architecture.md (new): source layout, branching strategy, CHANGELOG conventions.

• references/testing.md (new): unit and live test workflow.

• references/customizations.md: Generated-vs-Handwritten rules, _patch.py map, Patterns Reference, per-file inventory (lifted out of SKILL.md tail and architecture material).

• scripts/run-in-venv.ps1 (new): portable per-call wrapper that resolves the package .venv from any CWD.

Description

Please add an informative description that covers that changes made by the pull request and link all relevant issues.

If an SDK is being regenerated based on a new API spec, a link to the pull request containing these API spec changes should be included above.

All SDK Contribution checklist:

• The pull request does not introduce [breaking changes]
• CHANGELOG is updated for new features, bug fixes or other significant changes.
• I have read the contribution guidelines.

General Guidelines and Best Practices

• Title of the pull request is clear and informative.
• There are a small number of commits, each of which have an informative message. This means that previously merged commits do not appear in the history of the PR. For more information on cleaning up the commits in your PR, see this page.

Testing Guidelines

• Pull request includes test coverage for the included changes.

[Copilot]

Pull request overview

Expands the azure-search-documents GitHub skill from a post-regeneration _patch.py audit into a full end-to-end release workflow, and splits supporting guidance into focused reference documents plus a helper script for running commands inside the package venv.

Changes:

• Rewrites SKILL.md into a phased (0–7) release workflow covering generation, reconciliation, testing, lint/checks, changelog, samples, and versioning.
• Adds reference docs for architecture/release conventions and testing workflow; reorganizes customization documentation into a comprehensive catalog.
• Adds run-in-venv.ps1 helper to run commands inside the package .venv without manual activation.

Reviewed changes

Copilot reviewed 5 out of 5 changed files in this pull request and generated 7 comments.

Show a summary per file

File	Description
sdk/search/azure-search-documents/.github/skills/azure-search-documents/SKILL.md	New workflow-oriented skill entrypoint; adds venv wrapper guidance and phased release steps.
sdk/search/azure-search-documents/.github/skills/azure-search-documents/references/architecture.md	New release/branching/source-layout and CHANGELOG conventions reference.
sdk/search/azure-search-documents/.github/skills/azure-search-documents/references/testing.md	New unit/live testing + recording workflow reference.
sdk/search/azure-search-documents/.github/skills/azure-search-documents/references/customizations.md	Reorganized customization catalog with _patch.py map, patterns, and per-file inventory.
sdk/search/azure-search-documents/.github/skills/azure-search-documents/scripts/run-in-venv.ps1	New PowerShell wrapper to execute commands within the package .venv.

[hizixin]

I'll merge this skill for now so we can start using it. There will be a shared create-package-skill #46523 that all packages can use, which should resolve most of the comments raised here.