Skip to content

Add agent dev skill for search#45972

Open
xiangyan99 wants to merge 3 commits intomainfrom
search_agent_dev_skill
Open

Add agent dev skill for search#45972
xiangyan99 wants to merge 3 commits intomainfrom
search_agent_dev_skill

Conversation

@xiangyan99
Copy link
Copy Markdown
Member

Description

Add an agent dev skill for the search-documents package

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.

@xiangyan99 xiangyan99 marked this pull request as ready for review March 27, 2026 22:27
@xiangyan99 xiangyan99 requested review from a team, benbp, l0lawrence and mccoyp as code owners March 27, 2026 22:27
Copilot AI review requested due to automatic review settings March 27, 2026 22:27
Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Adds a package-specific “agent dev skill” for azure-search-documents to guide post-TypeSpec-regeneration validation and re-application of hand-authored _patch.py customizations, and registers it in the repo-wide package skill registry.

Changes:

  • Added a search-documents skill (SKILL.md) describing regeneration verification steps and customization patterns.
  • Added a references/customizations.md inventory of _patch.py customizations and their generated-code dependencies.
  • Updated the central find-package-skill registry to include azure-search-documents.

Reviewed changes

Copilot reviewed 3 out of 3 changed files in this pull request and generated 2 comments.

File Description
sdk/search/azure-search-documents/.github/skills/search-documents/references/customizations.md New checklist documenting each customization file’s defined symbols and regeneration verification points.
sdk/search/azure-search-documents/.github/skills/search-documents/SKILL.md New skill guide for post-tsp-client update regeneration verification and customization re-checks.
.github/skills/find-package-skill/SKILL.md Registers the azure-search-documents package skill in the central skill lookup table.

xiangyan99 and others added 2 commits March 27, 2026 15:57
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
@@ -0,0 +1,224 @@
---
name: search-documents-python
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Can we move these skill files to the root .github/ folder? We're aiming for a pattern where service-specific skills are at azure-sdk-for-python/.github/skills/<service> -- for example, https://github.com/Azure/azure-sdk-for-python/tree/main/.github/skills/ml

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

Status: Untriaged

Development

Successfully merging this pull request may close these issues.

3 participants