From 64821ca8a0e5348b037155933941f867fd2e5086 Mon Sep 17 00:00:00 2001 From: AI Config Sync Bot Date: Sat, 23 May 2026 02:36:51 +0000 Subject: [PATCH] chore: sync AI configuration from ai-base Languages: csharp,superpowers AI Systems: copilot,claude,junie AI Base Version: main --- .claude/agents/dotnet-developer.md | 2 +- .../azure-devops-markdown-guidance.md | 173 ++++++++ .../references/considerations.md | 6 +- .../references/github-basic-formatting.md | 153 +++++++ .../references/markdown-extended-syntax.md | 133 ++++++ .claude/skills/create-readme/SKILL.md | 10 +- .../references/github-admonition-syntax.md | 60 +++ .../references/run-on-output-readme.md | 146 +++++++ .../serverless-chat-langchainjs-readme.md | 280 +++++++++++++ .../serverless-recipes-javascript-readme.md | 162 ++++++++ .../create-readme/references/smoke-readme.md | 366 +++++++++++++++++ .claude/skills/dotnet-aspnet/SKILL.md | 384 ++---------------- .../skills/dotnet-aspnet/references/auth.md | 26 ++ .../references/error-handling.md | 44 ++ .../dotnet-aspnet/references/middleware.md | 38 ++ .../references/model-binding-validation.md | 71 ++++ .../references/openapi-and-cross-cutting.md | 100 +++++ .../references/project-and-endpoints.md | 92 +++++ .claude/skills/dotnet-fundamentals/SKILL.md | 41 ++ .../references/configuration.md | 79 ++++ .../references/dependency-injection.md | 81 ++++ .../references/modern-patterns.md | 87 ++++ .../references/options-pattern.md | 89 ++++ .claude/skills/dotnet-inspect/SKILL.md | 235 +++++++++++ .claude/skills/dotnet-reviewer/SKILL.md | 138 +++++++ .../references/report-format.md | 78 ++++ .../review-checklist-architecture.md | 37 ++ .../review-checklist-code-quality.md | 57 +++ .../references/review-checklist-net10.md | 30 ++ .../review-checklist-performance.md | 44 ++ .../references/review-checklist-security.md | 61 +++ .../references/severity-taxonomy.md | 52 +++ .../dotnet-reviewer/scripts/collect-diff.sh | 110 +++++ .../scripts/detect-dotnet-version.sh | 119 ++++++ .../dotnet-reviewer/scripts/run-checks.sh | 103 +++++ .claude/skills/dotnet-sdk-builder/SKILL.md | 35 +- .../references/project-setup.md | 4 +- .claude/skills/dotnet-tester/SKILL.md | 22 +- .claude/skills/dotnet-xmldocs/SKILL.md | 41 ++ .../references/member-documentation-rules.md | 41 ++ .claude/skills/dotnet/SKILL.md | 46 +++ .claude/skills/ef-core/SKILL.md | 20 +- .claude/skills/implementer/SKILL.md | 163 ++++++++ .../implementer/references/REFERENCE.md | 326 +++++++++++++++ .claude/skills/nuget-manager/SKILL.md | 16 + .claude/skills/refactoring/SKILL.md | 4 +- .claude/skills/writing-skills/SKILL.md | 4 +- .../anthropic-best-practices.md | 8 +- .../assets/agent-skills-bundling-content.png | Bin 0 -> 1080341 bytes .../agent-skills-executable-scripts.png | Bin 0 -> 620845 bytes .../assets/agent-skills-simple-file.png | Bin 0 -> 519972 bytes .../references/agentskills-specification.md | 193 +++++++++ .../references/context-windows.md | 66 +++ .github/agents/dotnet-developer.md | 2 +- .github/copilot-instructions.md | 38 +- .github/instructions/csharp.instructions.md | 130 ++---- .../azure-devops-markdown-guidance.md | 173 ++++++++ .../references/considerations.md | 6 +- .../references/github-basic-formatting.md | 153 +++++++ .../references/markdown-extended-syntax.md | 133 ++++++ .github/skills/create-readme/SKILL.md | 10 +- .../references/github-admonition-syntax.md | 60 +++ .../references/run-on-output-readme.md | 146 +++++++ .../serverless-chat-langchainjs-readme.md | 280 +++++++++++++ .../serverless-recipes-javascript-readme.md | 162 ++++++++ .../create-readme/references/smoke-readme.md | 366 +++++++++++++++++ .github/skills/dotnet-aspnet/SKILL.md | 384 ++---------------- .../skills/dotnet-aspnet/references/auth.md | 26 ++ .../references/error-handling.md | 44 ++ .../dotnet-aspnet/references/middleware.md | 38 ++ .../references/model-binding-validation.md | 71 ++++ .../references/openapi-and-cross-cutting.md | 100 +++++ .../references/project-and-endpoints.md | 92 +++++ .github/skills/dotnet-fundamentals/SKILL.md | 41 ++ .../references/configuration.md | 79 ++++ .../references/dependency-injection.md | 81 ++++ .../references/modern-patterns.md | 87 ++++ .../references/options-pattern.md | 89 ++++ .github/skills/dotnet-inspect/SKILL.md | 235 +++++++++++ .github/skills/dotnet-reviewer/SKILL.md | 138 +++++++ .../references/report-format.md | 78 ++++ .../review-checklist-architecture.md | 37 ++ .../review-checklist-code-quality.md | 57 +++ .../references/review-checklist-net10.md | 30 ++ .../review-checklist-performance.md | 44 ++ .../references/review-checklist-security.md | 61 +++ .../references/severity-taxonomy.md | 52 +++ .../dotnet-reviewer/scripts/collect-diff.sh | 110 +++++ .../scripts/detect-dotnet-version.sh | 119 ++++++ .../dotnet-reviewer/scripts/run-checks.sh | 103 +++++ .github/skills/dotnet-sdk-builder/SKILL.md | 35 +- .../references/project-setup.md | 4 +- .github/skills/dotnet-tester/SKILL.md | 22 +- .github/skills/dotnet-xmldocs/SKILL.md | 41 ++ .../references/member-documentation-rules.md | 41 ++ .github/skills/dotnet/SKILL.md | 46 +++ .github/skills/ef-core/SKILL.md | 20 +- .github/skills/implementer/SKILL.md | 163 ++++++++ .../implementer/references/REFERENCE.md | 326 +++++++++++++++ .github/skills/nuget-manager/SKILL.md | 16 + .github/skills/refactoring/SKILL.md | 4 +- .github/skills/writing-skills/SKILL.md | 4 +- .../anthropic-best-practices.md | 8 +- .../assets/agent-skills-bundling-content.png | Bin 0 -> 1080341 bytes .../agent-skills-executable-scripts.png | Bin 0 -> 620845 bytes .../assets/agent-skills-simple-file.png | Bin 0 -> 519972 bytes .../references/agentskills-specification.md | 193 +++++++++ .../references/context-windows.md | 66 +++ .junie/guidelines.md | 168 +++----- CLAUDE.md | 168 +++----- 110 files changed, 8720 insertions(+), 1136 deletions(-) create mode 100644 .claude/skills/convert-plaintext-to-md/references/azure-devops-markdown-guidance.md create mode 100644 .claude/skills/convert-plaintext-to-md/references/github-basic-formatting.md create mode 100644 .claude/skills/convert-plaintext-to-md/references/markdown-extended-syntax.md create mode 100644 .claude/skills/create-readme/references/github-admonition-syntax.md create mode 100644 .claude/skills/create-readme/references/run-on-output-readme.md create mode 100644 .claude/skills/create-readme/references/serverless-chat-langchainjs-readme.md create mode 100644 .claude/skills/create-readme/references/serverless-recipes-javascript-readme.md create mode 100644 .claude/skills/create-readme/references/smoke-readme.md create mode 100644 .claude/skills/dotnet-aspnet/references/auth.md create mode 100644 .claude/skills/dotnet-aspnet/references/error-handling.md create mode 100644 .claude/skills/dotnet-aspnet/references/middleware.md create mode 100644 .claude/skills/dotnet-aspnet/references/model-binding-validation.md create mode 100644 .claude/skills/dotnet-aspnet/references/openapi-and-cross-cutting.md create mode 100644 .claude/skills/dotnet-aspnet/references/project-and-endpoints.md create mode 100644 .claude/skills/dotnet-fundamentals/SKILL.md create mode 100644 .claude/skills/dotnet-fundamentals/references/configuration.md create mode 100644 .claude/skills/dotnet-fundamentals/references/dependency-injection.md create mode 100644 .claude/skills/dotnet-fundamentals/references/modern-patterns.md create mode 100644 .claude/skills/dotnet-fundamentals/references/options-pattern.md create mode 100644 .claude/skills/dotnet-inspect/SKILL.md create mode 100644 .claude/skills/dotnet-reviewer/SKILL.md create mode 100644 .claude/skills/dotnet-reviewer/references/report-format.md create mode 100644 .claude/skills/dotnet-reviewer/references/review-checklist-architecture.md create mode 100644 .claude/skills/dotnet-reviewer/references/review-checklist-code-quality.md create mode 100644 .claude/skills/dotnet-reviewer/references/review-checklist-net10.md create mode 100644 .claude/skills/dotnet-reviewer/references/review-checklist-performance.md create mode 100644 .claude/skills/dotnet-reviewer/references/review-checklist-security.md create mode 100644 .claude/skills/dotnet-reviewer/references/severity-taxonomy.md create mode 100644 .claude/skills/dotnet-reviewer/scripts/collect-diff.sh create mode 100644 .claude/skills/dotnet-reviewer/scripts/detect-dotnet-version.sh create mode 100644 .claude/skills/dotnet-reviewer/scripts/run-checks.sh create mode 100644 .claude/skills/dotnet-xmldocs/SKILL.md create mode 100644 .claude/skills/dotnet-xmldocs/references/member-documentation-rules.md create mode 100644 .claude/skills/dotnet/SKILL.md create mode 100644 .claude/skills/implementer/SKILL.md create mode 100644 .claude/skills/implementer/references/REFERENCE.md create mode 100644 .claude/skills/writing-skills/assets/agent-skills-bundling-content.png create mode 100644 .claude/skills/writing-skills/assets/agent-skills-executable-scripts.png create mode 100644 .claude/skills/writing-skills/assets/agent-skills-simple-file.png create mode 100644 .claude/skills/writing-skills/references/agentskills-specification.md create mode 100644 .claude/skills/writing-skills/references/context-windows.md create mode 100644 .github/skills/convert-plaintext-to-md/references/azure-devops-markdown-guidance.md create mode 100644 .github/skills/convert-plaintext-to-md/references/github-basic-formatting.md create mode 100644 .github/skills/convert-plaintext-to-md/references/markdown-extended-syntax.md create mode 100644 .github/skills/create-readme/references/github-admonition-syntax.md create mode 100644 .github/skills/create-readme/references/run-on-output-readme.md create mode 100644 .github/skills/create-readme/references/serverless-chat-langchainjs-readme.md create mode 100644 .github/skills/create-readme/references/serverless-recipes-javascript-readme.md create mode 100644 .github/skills/create-readme/references/smoke-readme.md create mode 100644 .github/skills/dotnet-aspnet/references/auth.md create mode 100644 .github/skills/dotnet-aspnet/references/error-handling.md create mode 100644 .github/skills/dotnet-aspnet/references/middleware.md create mode 100644 .github/skills/dotnet-aspnet/references/model-binding-validation.md create mode 100644 .github/skills/dotnet-aspnet/references/openapi-and-cross-cutting.md create mode 100644 .github/skills/dotnet-aspnet/references/project-and-endpoints.md create mode 100644 .github/skills/dotnet-fundamentals/SKILL.md create mode 100644 .github/skills/dotnet-fundamentals/references/configuration.md create mode 100644 .github/skills/dotnet-fundamentals/references/dependency-injection.md create mode 100644 .github/skills/dotnet-fundamentals/references/modern-patterns.md create mode 100644 .github/skills/dotnet-fundamentals/references/options-pattern.md create mode 100644 .github/skills/dotnet-inspect/SKILL.md create mode 100644 .github/skills/dotnet-reviewer/SKILL.md create mode 100644 .github/skills/dotnet-reviewer/references/report-format.md create mode 100644 .github/skills/dotnet-reviewer/references/review-checklist-architecture.md create mode 100644 .github/skills/dotnet-reviewer/references/review-checklist-code-quality.md create mode 100644 .github/skills/dotnet-reviewer/references/review-checklist-net10.md create mode 100644 .github/skills/dotnet-reviewer/references/review-checklist-performance.md create mode 100644 .github/skills/dotnet-reviewer/references/review-checklist-security.md create mode 100644 .github/skills/dotnet-reviewer/references/severity-taxonomy.md create mode 100644 .github/skills/dotnet-reviewer/scripts/collect-diff.sh create mode 100644 .github/skills/dotnet-reviewer/scripts/detect-dotnet-version.sh create mode 100644 .github/skills/dotnet-reviewer/scripts/run-checks.sh create mode 100644 .github/skills/dotnet-xmldocs/SKILL.md create mode 100644 .github/skills/dotnet-xmldocs/references/member-documentation-rules.md create mode 100644 .github/skills/dotnet/SKILL.md create mode 100644 .github/skills/implementer/SKILL.md create mode 100644 .github/skills/implementer/references/REFERENCE.md create mode 100644 .github/skills/writing-skills/assets/agent-skills-bundling-content.png create mode 100644 .github/skills/writing-skills/assets/agent-skills-executable-scripts.png create mode 100644 .github/skills/writing-skills/assets/agent-skills-simple-file.png create mode 100644 .github/skills/writing-skills/references/agentskills-specification.md create mode 100644 .github/skills/writing-skills/references/context-windows.md diff --git a/.claude/agents/dotnet-developer.md b/.claude/agents/dotnet-developer.md index 08f9656..04bfb9f 100644 --- a/.claude/agents/dotnet-developer.md +++ b/.claude/agents/dotnet-developer.md @@ -22,6 +22,6 @@ Use the following skills based on the task at hand: | Testing | [dotnet-tester](../../skills/csharp/dotnet-tester/SKILL.md) | Write and execute unit tests using xUnit, FakeItEasy, and AwesomeAssertions | | Data Access | [ef-core](../../skills/csharp/ef-core/SKILL.md) | Entity Framework Core best practices, DbContext design, migrations, and queries | | Package Management | [nuget-manager](../../skills/csharp/nuget-manager/SKILL.md) | Add, remove, and update NuGet packages via dotnet CLI | -| Documentation | [csharp-docs](../../skills/csharp/csharp-docs/SKILL.md) | C# XML documentation comments following Microsoft standards | +| Documentation | [dotnet-xmldocs](../../skills/csharp/dotnet-xmldocs/SKILL.md) | C# XML documentation comments following Microsoft standards | | Code Review | [code-review](../../skills/general/code-review/SKILL.md) | Structured code reviews covering quality, security, and performance | | Refactoring | [refactoring](../../skills/general/refactoring/SKILL.md) | Improve code structure and maintainability without changing behavior | diff --git a/.claude/skills/convert-plaintext-to-md/references/azure-devops-markdown-guidance.md b/.claude/skills/convert-plaintext-to-md/references/azure-devops-markdown-guidance.md new file mode 100644 index 0000000..5963161 --- /dev/null +++ b/.claude/skills/convert-plaintext-to-md/references/azure-devops-markdown-guidance.md @@ -0,0 +1,173 @@ +# Azure DevOps Markdown Guidance + +This reference describes Markdown syntax supported by Azure DevOps features including Wiki pages, README files, dashboards, and pull requests. + +## Supported Features + +| Markdown type | Definition of Done | Widget | Pull Requests | README | Wiki | +|---|---|---|---|---|---| +| Headings | Yes | Yes | Yes | Yes | Yes | +| Paragraphs/line breaks | Yes | Yes | Yes | Yes | Yes | +| Blockquotes | Yes | Yes | Yes | Yes | Yes | +| Horizontal rules | Yes | Yes | Yes | Yes | Yes | +| Emphasis (bold, italic) | Yes | Yes | Yes | Yes | Yes | +| Tables | No | Yes | Yes | Yes | Yes | +| Lists (ordered, unordered) | Yes | Yes | Yes | Yes | Yes | +| Links | Yes | Yes | Yes | Yes | Yes | +| Images | No | Yes | Yes | Yes | Yes | +| Code highlighting | No | Yes | Yes | Yes | Yes | +| Math notation | No | No | Yes | Yes | Yes | +| Checklists/task lists | No | No | Yes | Yes | Yes | +| Mermaid diagrams | No | No | No | No | Yes | + +> **Note:** Markdown in Azure DevOps doesn't support JavaScript or iframes. + +## Headings + +```markdown +# Heading 1 +## Heading 2 +### Heading 3 +#### Heading 4 +##### Heading 5 +###### Heading 6 +``` + +## Paragraphs and Line Breaks + +Use a blank line for new paragraphs. Use two spaces at line end or `
` for line breaks within a paragraph. + +## Blockquotes + +```markdown +> Single blockquote +>> Nested blockquote +``` + +## Horizontal Rules + +Use three or more hyphens, asterisks, or underscores on a line by themselves. + +## Emphasis + +```markdown +*Italic* or _Italic_ +**Bold** or __Bold__ +***Bold italic*** +~~Strikethrough~~ +``` + +## Code Highlighting + +**Inline:** Use single backticks `` `code` `` + +**Block:** Use triple backticks with optional language identifier: + +````markdown +```javascript +const x = 1; +``` +```` + +Supported languages include: ActionScript, Apex, Bash, C, C#, C++, CSS, Dart, Go, Groovy, Haskell, HTML, Java, JavaScript, JSON, Kotlin, Lua, Markdown, Objective-C, Perl, PHP, PowerShell, Python, R, Ruby, Rust, Scala, Shell, SQL, Swift, TypeScript, XML, YAML, and more. + +## Tables + +```markdown +| Header 1 | Header 2 | +|----------|----------| +| Cell 1 | Cell 2 | +``` + +Alignment with colons: `:---` (left), `:---:` (center), `---:` (right). + +## Lists + +**Ordered:** + +```markdown +1. First item +2. Second item +``` + +**Unordered:** + +```markdown +- Item 1 +- Item 2 +``` + +**Nested:** Indent with spaces. + +## Links + +```markdown +[Link text](URL) +[Link text](URL "Title") +``` + +**Anchor links:** Link to headings within the same page using `#section-name`. + +## Images + +```markdown +![Alt text](image-url) +![Alt text](image-url =WIDTHxHEIGHT) +``` + +Azure DevOps supports image resizing with `=WIDTHxHEIGHT` syntax. + +## Checklists / Task Lists + +```markdown +- [ ] Incomplete task +- [x] Completed task +``` + +## Mathematical Notation + +**Inline:** `$` delimiters: `$e^{i\pi} = -1$` + +**Block:** `$$` delimiters: + +```markdown +$$ +\sum_{i=1}^{n} x_i +$$ +``` + +Uses KaTeX for rendering. + +## Mermaid Diagrams (Wiki only) + +````markdown +```mermaid +graph TD; + A-->B; + B-->C; +``` +```` + +Supports: flowcharts, sequence diagrams, Gantt charts, and more. + +## Collapsible Sections + +```html +
+ Click to expand + + Content here (leave blank line after summary tag). +
+``` + +## Emoji + +Use standard emoji shortcodes: `:smile:`, `:thumbsup:`, etc. + +## Special Characters + +Escape special Markdown characters with backslash: `\*`, `\#`, `\[`, etc. + +## HTML Tags + +Supported HTML tags in Wiki include: `
`, ``, ``, `
`, ``, ``, `
`, ``, ``, ``, ``, `
`, `
`, `