Skip to content

feat(LLMs): include package skills and registration docs - #1321

Merged
ArgoZhang merged 14 commits into
masterfrom
chore-llms
Nov 17, 2026
Merged

ArgoZhang merged 14 commits into
masterfrom
chore-llms

Conversation

@ArgoZhang

@ArgoZhang ArgoZhang commented Nov 17, 2026 •

Copy link
Copy Markdown
Member

Link issues

fixes #1320

Summary By Copilot

Add 69 package-specific skills with references generated and included during NuGet packing. Pin the local generator tool to 11.0.4 and ignore generated references.

Document public, non-obsolete Add*/TryAdd* registration extensions separately from injectable services, preserving source signatures, defaults, and generic constraints. Update both generator READMEs.

Regression?

  • Yes
  • No

Existing component generation passed a targeted smoke check.

Risk

  • High
  • Medium
  • Low

Packing now restores the pinned tool and regenerates the selected skill's references directory. Tool/feed availability can affect packaging. Registration receivers are matched by type name, without loading dependency metadata.

Verification

  • Manual (required)
  • Automated

All commands ran from the repository root:

  • git diff --check origin/master...HEAD — passed.
  • dotnet build .\tools\BootstrapBlazor.LLMsDocsGenerator -c Release --no-restore — passed, zero warnings/errors.
  • dotnet pack .\tools\BootstrapBlazor.LLMsDocsGenerator -c Release --no-build --no-restore — passed.
  • dotnet run --project .\tools\BootstrapBlazor.LLMsDocsGenerator -c Release --no-build -- --project .\src\components\BootstrapBlazor.Holiday --output C:\Users\Argo\.copilot\session-state\42f2aa45-c903-41dd-b364-22e6aada3eef\files\holiday-docs — passed; one registration extension, no components/services.
  • dotnet run --project .\tools\BootstrapBlazor.LLMsDocsGenerator -c Release --no-build -- --project .\src\components\BootstrapBlazor.DriverJs --output C:\Users\Argo\.copilot\session-state\42f2aa45-c903-41dd-b364-22e6aada3eef\files\driverjs-docs — passed; three components.
  • dotnet pack .\src\components\BootstrapBlazor.Holiday -c Release --no-restore -p:TargetFrameworks=net11.0 -o C:\Users\Argo\.copilot\session-state\42f2aa45-c903-41dd-b364-22e6aada3eef\files\skill-packages — passed with NU5128 warnings from restricting a restored multi-target project to net11.0.
  • dotnet pack .\src\components\BootstrapBlazor.DriverJs -c Release --no-restore -p:TargetFrameworks=net11.0 -o C:\Users\Argo\.copilot\session-state\42f2aa45-c903-41dd-b364-22e6aada3eef\files\skill-packages — passed with the same NU5128 warnings.

Inspected both archives: each contains SKILL.md, references/llms.txt, and referenced type documents; all links from their skill files resolve within the package.

The documented tools\BootstrapBlazor.LLMsDocsGenerator\tests\Verify-SingleProject.ps1 is absent, so it was not run. Full multi-target builds and runtime unit suites were not run.

Packaging changes reviewed?

  • Yes
  • No
  • N/A

Validated representative component and registration-only packages on net11.0. Generator version is 11.0.4; component package versions are unchanged.

☑️ Self Check before Merge

⚠️ Please check all items below before review. ⚠️

  • Doc is updated/provided or not needed
  • Demo is updated/provided or not needed
  • Merge the latest code from the main branch

Summary by Sourcery

Distribute package-specific LLM skills with generated API and registration references in NuGet packages.

New Features:

  • Add package-specific skills that provide AI-oriented API and service-registration references for 69 component and extension packages.
  • Include generated references and resolved API links in NuGet packages for use alongside each package skill.

Enhancements:

  • Document public non-obsolete Add*/TryAdd* registration extensions separately from injectable services while preserving their public signatures, defaults, and generic constraints.
  • Update the LLM documentation generators and package integration to generate skill references during packing.

Build:

  • Pin the local .NET tool manifest to generator version 11.0.4 and configure package builds to regenerate skill references.
  • Ignore generated skill reference output in source control.

Documentation:

  • Add package-level SKILL.md guidance and generator README documentation for component and service registration references.

Tests:

  • Validate representative component and registration-only packages, including generated skill contents and internal link resolution.

@bb-auto bb-auto Bot added the enhancement New feature or request label Nov 17, 2026
@bb-auto bb-auto Bot added this to the v11.0.0 milestone Nov 17, 2026

@bb-auto bb-auto Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

Auto approved by bb-auto

@sourcery-ai

sourcery-ai Bot commented Nov 17, 2026

Copy link
Copy Markdown

Sorry @ArgoZhang, you've used your own review budget of 250,000 diff characters for the last 7 days.

You can request another review in 1 day and 2 hours by commenting @sourcery-ai review. Upgrade to get a review now.

bb-auto[bot]
bb-auto Bot previously approved these changes Nov 17, 2026

@bb-auto bb-auto Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

Auto approved by bb-auto

@sourcery-ai

sourcery-ai Bot commented Nov 17, 2026 •

Copy link
Copy Markdown

Linked issues

Checked at commit 3c490ce

#1320 feat(LLMs): include package skills and registration docs · 5 of 5 met

# Requirement Status Notes
1 Add 69 package-specific skills and generate their references during NuGet packing ✅ Met Package skills are added across the component and extension projects; PackageSkills.targets generates references before package files are collected and includes the skill directory in the package.
2 Pin the local documentation tool to 11.0.4 ✅ Met The tool manifest pins llms-docs to 11.0.4.
3 Document public IServiceCollection registration extensions with complete source signatures, separately from injectable services ✅ Met The generator discovers public, non-obsolete Add*/TryAdd* registration methods, renders their source declarations, and lists registration-extension types separately from services.
4 Ignore generated references and include them in NuGet packages ✅ Met Generated references are ignored by Git, and the packaging target includes the generated skill files in the package.
5 Update both generator READMEs ✅ Met Both the English and Chinese READMEs describe registration-extension discovery and its analysis limitations.

@bb-auto bb-auto Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

Auto approved by bb-auto

@ArgoZhang
ArgoZhang merged commit bcf78a8 into master Nov 17, 2026
3 checks passed
@ArgoZhang
ArgoZhang deleted the chore-llms branch November 17, 2026 03:59
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

enhancement New feature or request

Projects

None yet

Development

Successfully merging this pull request may close these issues.

feat(LLMs): include package skills and registration docs

1 participant