[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M69B1W50C4MV2XD3E9N8F1EB":3,"skill-same:01M69B1W50C4MV2XD3E9N8F1EB":89},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":26,"publishedAt":48,"linkOnly":49,"markdownContent":50,"markdownBody":51,"frontMatter":52,"refName":55,"commitSha":56,"skillDirectory":57,"forksCount":58,"repositoryHtmlUrl":59,"repositoryHomepageUrl":60,"ownerHtmlUrl":61,"ownerBlogUrl":62,"ownerDescription":63,"updatedAt":64,"install":65,"resources":78},"01M69B1W50C4MV2XD3E9N8F1EB","wiki-agents-md",null,"Generates AGENTS.md files for repository folders — coding agent context files with build commands, testing instructions, code style, project structure, and boundaries. Only generates where AGENTS.md is missing.","microsoft\u002Fskills","microsoft","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F6154722?v=4","01M698VYDXZ6JW5WH3CRV650R8","Microsoft","01M69AJYYW4E1RMSYCQDJ4FJSH",3204,"MIT","https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fskills\u002Fblob\u002Fmain\u002F.github\u002Fplugins\u002Fdeep-wiki\u002Fskills\u002Fwiki-agents-md\u002FSKILL.md",[18,23],{"categoryNo":19,"categoryName":20,"taxonomyType":21,"taxonomyTypeDesc":22},"01JBSEEDCAT000000000000008","测试与质量","SCENARIO","使用场景",{"categoryNo":24,"categoryName":25,"taxonomyType":21,"taxonomyTypeDesc":22},"01JBSEEDCAT000000000000023","Skill与智能体开发",[27,28,29,30,31,32,33,34,35,36,37,38,39,40,41,42,43,44,45,46,9,47],"wiki agents md","wiki","agents md","context","for","with","missing","style","context files","commands","project","structure","files","only","testing","coding","repository","code","code style","project structure","coding agent","2026-11-10 10:12:30",false,"---\nname: wiki-agents-md\ndescription: Generates AGENTS.md files for repository folders — coding agent context files with build commands, testing instructions, code style, project structure, and boundaries. Only generates where AGENTS.md is missing.\nlicense: MIT\nmetadata:\n  author: Microsoft\n  version: \"1.0.0\"\n---\n\n# AGENTS.md Generator\n\nGenerate high-quality `AGENTS.md` files for repository folders. Each file provides coding agents with project-specific context — build commands, testing instructions, code style, structure, and operational boundaries.\n\n## What is AGENTS.md\n\n`AGENTS.md` complements `README.md`. README is for humans; AGENTS.md is for coding agents.\n\n- **Predictable location** — Agents look for `AGENTS.md` in the current directory, then walk up the tree\n- **Nested files** — Subfolders can have their own `AGENTS.md` that takes precedence over the root one\n- **Separate from README** — Keeps READMEs concise; agent-specific details (exact commands, boundaries, conventions) go here\n- **NOT the same as `.github\u002Fagents\u002F*.agent.md`** — Those are agent persona definitions (who the agent is). `AGENTS.md` is project context (what the agent should know about this code)\n\n## Critical Guard: Only Generate If Missing\n\n> **This is the single most important rule.**\n\n**NEVER overwrite an existing AGENTS.md.**\n\nBefore generating for ANY folder:\n\n```bash\n# Check if AGENTS.md already exists\nls AGENTS.md 2>\u002Fdev\u002Fnull\n```\n\n- If it exists → **skip** and report: `\"AGENTS.md already exists at \u003Cpath> — skipping\"`\n- If it does not exist → proceed with generation\n- This check applies to **every folder independently**\n\n## Pertinent Folder Detection\n\nIdentify which folders should have an `AGENTS.md`:\n\n### Always generate for:\n\n- **Repository root** (`\u002F`)\n- **Wiki folder** (`wiki\u002F`) — if generated by deep-wiki (has `package.json` with VitePress)\n\n### Generate if they exist:\n\n- `tests\u002F`, `src\u002F`, `lib\u002F`, `app\u002F`, `api\u002F`\n- Monorepo packages: `packages\u002F*\u002F`, `apps\u002F*\u002F`, `services\u002F*\u002F`\n- Any folder with its own build manifest:\n  - `package.json`\n  - `pyproject.toml`\n  - `Cargo.toml`\n  - `*.csproj` \u002F `*.fsproj`\n  - `go.mod`\n  - `pom.xml` \u002F `build.gradle`\n- `.github\u002F` — only if it contains workflows or actions\n\n### Always skip:\n\n- `node_modules\u002F`, `.git\u002F`, `dist\u002F`, `build\u002F`, `out\u002F`, `target\u002F`\n- `vendor\u002F`, `.venv\u002F`, `venv\u002F`, `__pycache__\u002F`\n- Any directory that is generated output or third-party dependencies\n\n## The Six Core Areas\n\nEvery good AGENTS.md covers these areas, tailored to what actually exists in the folder. Do not invent sections for things the project doesn't have.\n\n### a) Build & Run Commands — PUT FIRST\n\nAgents reference these constantly. Use exact commands with flags, not just tool names.\n\n```markdown\n## Build & Run\n\nnpm install          # Install dependencies\nnpm run dev          # Start dev server (port 3000)\nnpm run build        # Production build\nnpm run lint         # Run ESLint\n```\n\nRead these sources to find real commands:\n- `package.json` → `scripts` section\n- `Makefile` → targets\n- `pyproject.toml` → `[tool.poetry.scripts]` or `[project.scripts]`\n- `Cargo.toml` → standard cargo commands\n- CI configs → `.github\u002Fworkflows\u002F*.yml`, `Jenkinsfile`, `.gitlab-ci.yml`\n\n### b) Testing Instructions\n\n```markdown\n## Testing\n\npytest tests\u002F -v                    # Run all tests\npytest tests\u002Ftest_auth.py -v        # Run single file\npytest -k \"test_login\" -v           # Run single test by name\npytest --cov=src --cov-report=term  # With coverage\n```\n\nInclude:\n- Test framework and how it's configured\n- How to run all tests, a single file, a single test\n- Expected behavior before commits (e.g., \"all tests must pass\")\n\n### c) Project Structure\n\n```markdown\n## Project Structure\n\nsrc\u002F\n├── api\u002F          # FastAPI route handlers\n├── models\u002F       # Pydantic data models\n├── services\u002F     # Business logic\n└── utils\u002F        # Shared utilities\n\ntests\u002F            # Mirrors src\u002F structure\n```\n\nInclude:\n- Key directories and what they contain\n- Entry points (e.g., `src\u002Fmain.py`, `src\u002Findex.ts`)\n- Where to add new features\n\n### d) Code Style & Conventions\n\nOne real code example beats three paragraphs of description.\n\n```markdown\n## Code Style\n\n- snake_case for functions and variables\n- PascalCase for classes\n- Type hints on all function signatures\n- Async\u002Fawait for I\u002FO operations\n\n### Example\n\n```python\nasync def get_user_by_id(user_id: str) -> User:\n    \"\"\"Fetch a user by their unique identifier.\"\"\"\n    async with get_db_session() as session:\n        return await session.get(User, user_id)\n```\n```\n\nDetect conventions by reading existing code:\n- Naming patterns (camelCase, snake_case, PascalCase)\n- Import organization (stdlib → third-party → local)\n- Module structure patterns\n\n### e) Git Workflow\n\n```markdown\n## Git Workflow\n\n- Branch naming: `feature\u002F`, `fix\u002F`, `chore\u002F`\n- Commit messages: conventional commits (`feat:`, `fix:`, `docs:`)\n- Run `npm test && npm run lint` before committing\n- PR titles follow conventional commit format\n```\n\nOnly include if the repo has evidence of conventions (e.g., commitlint config, PR templates, contributing guides).\n\n### f) Boundaries\n\nUse a three-tier system:\n\n```markdown\n## Boundaries\n\n- ✅ **Always do:** Run tests before committing. Write tests for new features. Use type hints.\n- ⚠️ **Ask first:** Adding new dependencies. Changing database schemas. Modifying CI\u002FCD configs. Changing public API signatures.\n- ? **Never do:** Commit secrets or credentials. Modify `vendor\u002F` or `node_modules\u002F`. Push directly to `main`. Delete migration files.\n```\n\nTailor boundaries to the project:\n- Backend projects: schema changes, API contracts\n- Frontend projects: breaking component APIs, design system changes\n- Infrastructure: production configs, IAM permissions\n\n## Generation Process\n\nWhen generating an AGENTS.md for a specific folder:\n\n### Step 1: Check existence\n\n```bash\nls \u003Cfolder>\u002FAGENTS.md 2>\u002Fdev\u002Fnull\n```\n\nIf it exists, **stop**. Report and move to the next folder.\n\n### Step 2: Scan the folder\n\nIdentify:\n- Primary language (Python, TypeScript, Rust, Go, Java, C#)\n- Framework (FastAPI, Next.js, Actix, Spring Boot)\n- Build tool (npm, cargo, poetry, maven, gradle)\n- Test runner (pytest, vitest, cargo test, JUnit)\n\n### Step 3: Read config files\n\nExtract real commands and settings from:\n- `package.json` scripts\n- `Makefile` \u002F `Justfile` targets\n- `pyproject.toml` scripts and tool configs\n- `Cargo.toml` metadata\n- `.github\u002Fworkflows\u002F*.yml` build\u002Ftest steps\n- `docker-compose.yml` service definitions\n- Linter configs (`.eslintrc`, `ruff.toml`, `rustfmt.toml`)\n\n### Step 4: Detect conventions\n\nRead 3-5 source files to identify:\n- Naming patterns\n- Import organization\n- Error handling style\n- Comment style\n- Module structure\n\n### Step 5: Compose the AGENTS.md\n\nUse only the sections that apply. If the folder has no tests, omit the testing section. If there's no CI config, omit git workflow.\n\n### Step 6: Validate\n\nBefore writing the file:\n- Every command references a real script, target, or tool\n- Every file path references an actual file or directory\n- No placeholder text like `\u003Cyour-project>` or `TODO`\n- No invented sections for things that don't exist\n\n## Template Structure\n\n```markdown\n# [Folder Name] — Agent Instructions\n\n## Overview\n[1-2 sentences: what this folder\u002Fproject does, its role in the larger system]\n\n## Build & Run\n[Exact commands — install, dev, build, clean]\n\n## Testing\n[Framework, run commands, single-test commands]\n\n## Project Structure\n[Key directories, entry points, where to add new things]\n\n## Code Style\n[Naming conventions + one real code example from this project]\n\n## Boundaries\n- ✅ **Always do:** [safe operations]\n- ⚠️ **Ask first:** [risky operations]\n- ? **Never do:** [dangerous operations]\n\n## Documentation\n[Only include if wiki\u002F, llms.txt, or docs\u002F exist in the repo]\n- Wiki: `wiki\u002F` — architecture, API, onboarding guides\n- LLM Context: `llms.txt` — project summary for coding agents (full version: `wiki\u002Fllms-full.txt`)\n- Onboarding: `wiki\u002Fonboarding\u002F` — guides for contributors, staff engineers, executives, PMs\n```\n\nOmit any section that doesn't apply. A 20-line AGENTS.md with real commands beats a 200-line one with generic filler.\n\n## Root vs Nested AGENTS.md\n\n### Root AGENTS.md (`\u002FAGENTS.md`)\n\nCovers the entire project:\n- Overall tech stack and architecture\n- Global conventions and coding standards\n- Dev environment setup\n- Repository-wide boundaries\n- CI\u002FCD overview\n\n### Nested AGENTS.md (e.g., `tests\u002FAGENTS.md`)\n\nCovers that specific subfolder:\n- What this folder does and why it exists\n- Folder-specific commands (e.g., `cd tests && pnpm test`)\n- Folder-specific conventions\n- Should NOT repeat root-level content\n\n### Wiki AGENTS.md (`wiki\u002FAGENTS.md`)\n\n**ALWAYS check** if `wiki\u002FAGENTS.md` exists before generating — same only-if-missing guard as all other folders. If it exists, skip it.\n\nUse this template (adapt to the actual project):\n\n```markdown\n# Wiki — Agent Instructions\n\n## Overview\nGenerated VitePress documentation site. Contains architecture docs, onboarding guides, and API references with source-linked citations and dark-mode Mermaid diagrams.\n\n## Build & Run\n- Install: `npm install`\n- Dev server: `npm run dev`\n- Build: `npm run build`\n- Preview: `npm run preview`\n\n## Wiki Structure\n- `index.md` — Landing page with project overview and navigation\n- `onboarding\u002F` — Audience-tailored guides (contributor, staff engineer, executive, product manager)\n- `{NN}-{section}\u002F` — Numbered documentation sections\n- `llms.txt` — LLM-friendly project summary (links + descriptions)\n- `llms-full.txt` — LLM-friendly full content (inlined pages)\n- `.vitepress\u002Fconfig.mts` — VitePress config with sidebar and Mermaid setup\n- `.vitepress\u002Ftheme\u002F` — Dark theme (custom.css) and zoom handlers (index.ts)\n\n## Content Conventions\n- All Mermaid diagrams use dark-mode colors (fills `#2d333b`, borders `#6d5dfc`, text `#e6edf3`)\n- Every page has VitePress frontmatter (`title`, `description`)\n- Citations link to source repository with line numbers\n- Tables include a \"Source\" column with linked citations\n- Mermaid diagrams followed by `\u003C!-- Sources: ... -->` comment blocks\n\n## Boundaries\n- ✅ **Always do:** Add new pages following existing section numbering, use dark-mode Mermaid colors\n- ⚠️ **Ask first:** Change theme CSS, modify VitePress config, restructure sections\n- ? **Never do:** Delete generated pages without understanding dependencies, use light-mode colors, remove citation links\n\n## Documentation\n- Wiki: `.\u002F` — This folder is the wiki\n- LLM Context: `llms.txt` — Quick summary; `llms-full.txt` — Full content\n- Onboarding: `onboarding\u002F` — Four audience-tailored guides\n```\n\nFill in the real section names, technologies, and project-specific conventions.\n\nAgents read the nearest AGENTS.md in the directory tree. Nested files take precedence, so they should contain folder-specific details, not global ones.\n\n## CLAUDE.md Companion File\n\nWhenever you generate an `AGENTS.md` in a folder, also generate a `CLAUDE.md` in the same folder — **only if `CLAUDE.md` does not already exist**.\n\nThe `CLAUDE.md` content is always exactly:\n\n```markdown\n# CLAUDE.md\n\n\u003C!-- Generated for repository development workflows. Do not edit directly. -->\n\nBefore beginning work in this repository, read `AGENTS.md` and follow all scoped AGENTS guidance.\n```\n\nThis ensures Claude Code (and similar tools that look for `CLAUDE.md`) are redirected to the authoritative `AGENTS.md` instructions.\n\n**Same guard applies:** check if `CLAUDE.md` exists before writing. If it exists, skip it.\n\n## Quality Principles\n\n| Principle | Good | Bad |\n|-----------|------|-----|\n| **Specific** | \"React 18 with TypeScript, Vite, Tailwind CSS\" | \"React project\" |\n| **Executable** | `pytest tests\u002F -v --tb=short` | \"run the tests\" |\n| **Grounded** | Show a real code snippet from the project | Describe the style in abstract terms |\n| **Real paths** | `src\u002Fapi\u002Froutes\u002F` | `path\u002Fto\u002Fyour\u002Fcode\u002F` |\n| **Honest** | Omit testing section if no tests exist | Invent a testing section |\n| **Concise** | 30-80 lines for most folders | 300+ lines of prose |\n\n## Anti-Patterns to Avoid\n\n- ❌ **\"You are a helpful coding assistant\"** — too vague, describes feelings not actions\n- ❌ **Generic boilerplate** — content that could apply to any project provides no value\n- ❌ **Invented commands\u002Fpaths** — every command and path must reference something real\n- ❌ **Duplicating README.md** — AGENTS.md complements README, doesn't copy it\n- ❌ **Including secrets** — never put credentials, API keys, or tokens in AGENTS.md\n- ❌ **Overwriting existing files** — if AGENTS.md exists, do not touch it\n- ❌ **Padding empty sections** — if there are no tests, don't write a testing section\n- ❌ **Describing what agents should \"think\" or \"feel\"** — describe what they should DO\n","# AGENTS.md Generator\n\nGenerate high-quality `AGENTS.md` files for repository folders. Each file provides coding agents with project-specific context — build commands, testing instructions, code style, structure, and operational boundaries.\n\n## What is AGENTS.md\n\n`AGENTS.md` complements `README.md`. README is for humans; AGENTS.md is for coding agents.\n\n- **Predictable location** — Agents look for `AGENTS.md` in the current directory, then walk up the tree\n- **Nested files** — Subfolders can have their own `AGENTS.md` that takes precedence over the root one\n- **Separate from README** — Keeps READMEs concise; agent-specific details (exact commands, boundaries, conventions) go here\n- **NOT the same as `.github\u002Fagents\u002F*.agent.md`** — Those are agent persona definitions (who the agent is). `AGENTS.md` is project context (what the agent should know about this code)\n\n## Critical Guard: Only Generate If Missing\n\n> **This is the single most important rule.**\n\n**NEVER overwrite an existing AGENTS.md.**\n\nBefore generating for ANY folder:\n\n```bash\n# Check if AGENTS.md already exists\nls AGENTS.md 2>\u002Fdev\u002Fnull\n```\n\n- If it exists → **skip** and report: `\"AGENTS.md already exists at \u003Cpath> — skipping\"`\n- If it does not exist → proceed with generation\n- This check applies to **every folder independently**\n\n## Pertinent Folder Detection\n\nIdentify which folders should have an `AGENTS.md`:\n\n### Always generate for:\n\n- **Repository root** (`\u002F`)\n- **Wiki folder** (`wiki\u002F`) — if generated by deep-wiki (has `package.json` with VitePress)\n\n### Generate if they exist:\n\n- `tests\u002F`, `src\u002F`, `lib\u002F`, `app\u002F`, `api\u002F`\n- Monorepo packages: `packages\u002F*\u002F`, `apps\u002F*\u002F`, `services\u002F*\u002F`\n- Any folder with its own build manifest:\n  - `package.json`\n  - `pyproject.toml`\n  - `Cargo.toml`\n  - `*.csproj` \u002F `*.fsproj`\n  - `go.mod`\n  - `pom.xml` \u002F `build.gradle`\n- `.github\u002F` — only if it contains workflows or actions\n\n### Always skip:\n\n- `node_modules\u002F`, `.git\u002F`, `dist\u002F`, `build\u002F`, `out\u002F`, `target\u002F`\n- `vendor\u002F`, `.venv\u002F`, `venv\u002F`, `__pycache__\u002F`\n- Any directory that is generated output or third-party dependencies\n\n## The Six Core Areas\n\nEvery good AGENTS.md covers these areas, tailored to what actually exists in the folder. Do not invent sections for things the project doesn't have.\n\n### a) Build & Run Commands — PUT FIRST\n\nAgents reference these constantly. Use exact commands with flags, not just tool names.\n\n```markdown\n## Build & Run\n\nnpm install          # Install dependencies\nnpm run dev          # Start dev server (port 3000)\nnpm run build        # Production build\nnpm run lint         # Run ESLint\n```\n\nRead these sources to find real commands:\n- `package.json` → `scripts` section\n- `Makefile` → targets\n- `pyproject.toml` → `[tool.poetry.scripts]` or `[project.scripts]`\n- `Cargo.toml` → standard cargo commands\n- CI configs → `.github\u002Fworkflows\u002F*.yml`, `Jenkinsfile`, `.gitlab-ci.yml`\n\n### b) Testing Instructions\n\n```markdown\n## Testing\n\npytest tests\u002F -v                    # Run all tests\npytest tests\u002Ftest_auth.py -v        # Run single file\npytest -k \"test_login\" -v           # Run single test by name\npytest --cov=src --cov-report=term  # With coverage\n```\n\nInclude:\n- Test framework and how it's configured\n- How to run all tests, a single file, a single test\n- Expected behavior before commits (e.g., \"all tests must pass\")\n\n### c) Project Structure\n\n```markdown\n## Project Structure\n\nsrc\u002F\n├── api\u002F          # FastAPI route handlers\n├── models\u002F       # Pydantic data models\n├── services\u002F     # Business logic\n└── utils\u002F        # Shared utilities\n\ntests\u002F            # Mirrors src\u002F structure\n```\n\nInclude:\n- Key directories and what they contain\n- Entry points (e.g., `src\u002Fmain.py`, `src\u002Findex.ts`)\n- Where to add new features\n\n### d) Code Style & Conventions\n\nOne real code example beats three paragraphs of description.\n\n```markdown\n## Code Style\n\n- snake_case for functions and variables\n- PascalCase for classes\n- Type hints on all function signatures\n- Async\u002Fawait for I\u002FO operations\n\n### Example\n\n```python\nasync def get_user_by_id(user_id: str) -> User:\n    \"\"\"Fetch a user by their unique identifier.\"\"\"\n    async with get_db_session() as session:\n        return await session.get(User, user_id)\n```\n```\n\nDetect conventions by reading existing code:\n- Naming patterns (camelCase, snake_case, PascalCase)\n- Import organization (stdlib → third-party → local)\n- Module structure patterns\n\n### e) Git Workflow\n\n```markdown\n## Git Workflow\n\n- Branch naming: `feature\u002F`, `fix\u002F`, `chore\u002F`\n- Commit messages: conventional commits (`feat:`, `fix:`, `docs:`)\n- Run `npm test && npm run lint` before committing\n- PR titles follow conventional commit format\n```\n\nOnly include if the repo has evidence of conventions (e.g., commitlint config, PR templates, contributing guides).\n\n### f) Boundaries\n\nUse a three-tier system:\n\n```markdown\n## Boundaries\n\n- ✅ **Always do:** Run tests before committing. Write tests for new features. Use type hints.\n- ⚠️ **Ask first:** Adding new dependencies. Changing database schemas. Modifying CI\u002FCD configs. Changing public API signatures.\n- ? **Never do:** Commit secrets or credentials. Modify `vendor\u002F` or `node_modules\u002F`. Push directly to `main`. Delete migration files.\n```\n\nTailor boundaries to the project:\n- Backend projects: schema changes, API contracts\n- Frontend projects: breaking component APIs, design system changes\n- Infrastructure: production configs, IAM permissions\n\n## Generation Process\n\nWhen generating an AGENTS.md for a specific folder:\n\n### Step 1: Check existence\n\n```bash\nls \u003Cfolder>\u002FAGENTS.md 2>\u002Fdev\u002Fnull\n```\n\nIf it exists, **stop**. Report and move to the next folder.\n\n### Step 2: Scan the folder\n\nIdentify:\n- Primary language (Python, TypeScript, Rust, Go, Java, C#)\n- Framework (FastAPI, Next.js, Actix, Spring Boot)\n- Build tool (npm, cargo, poetry, maven, gradle)\n- Test runner (pytest, vitest, cargo test, JUnit)\n\n### Step 3: Read config files\n\nExtract real commands and settings from:\n- `package.json` scripts\n- `Makefile` \u002F `Justfile` targets\n- `pyproject.toml` scripts and tool configs\n- `Cargo.toml` metadata\n- `.github\u002Fworkflows\u002F*.yml` build\u002Ftest steps\n- `docker-compose.yml` service definitions\n- Linter configs (`.eslintrc`, `ruff.toml`, `rustfmt.toml`)\n\n### Step 4: Detect conventions\n\nRead 3-5 source files to identify:\n- Naming patterns\n- Import organization\n- Error handling style\n- Comment style\n- Module structure\n\n### Step 5: Compose the AGENTS.md\n\nUse only the sections that apply. If the folder has no tests, omit the testing section. If there's no CI config, omit git workflow.\n\n### Step 6: Validate\n\nBefore writing the file:\n- Every command references a real script, target, or tool\n- Every file path references an actual file or directory\n- No placeholder text like `\u003Cyour-project>` or `TODO`\n- No invented sections for things that don't exist\n\n## Template Structure\n\n```markdown\n# [Folder Name] — Agent Instructions\n\n## Overview\n[1-2 sentences: what this folder\u002Fproject does, its role in the larger system]\n\n## Build & Run\n[Exact commands — install, dev, build, clean]\n\n## Testing\n[Framework, run commands, single-test commands]\n\n## Project Structure\n[Key directories, entry points, where to add new things]\n\n## Code Style\n[Naming conventions + one real code example from this project]\n\n## Boundaries\n- ✅ **Always do:** [safe operations]\n- ⚠️ **Ask first:** [risky operations]\n- ? **Never do:** [dangerous operations]\n\n## Documentation\n[Only include if wiki\u002F, llms.txt, or docs\u002F exist in the repo]\n- Wiki: `wiki\u002F` — architecture, API, onboarding guides\n- LLM Context: `llms.txt` — project summary for coding agents (full version: `wiki\u002Fllms-full.txt`)\n- Onboarding: `wiki\u002Fonboarding\u002F` — guides for contributors, staff engineers, executives, PMs\n```\n\nOmit any section that doesn't apply. A 20-line AGENTS.md with real commands beats a 200-line one with generic filler.\n\n## Root vs Nested AGENTS.md\n\n### Root AGENTS.md (`\u002FAGENTS.md`)\n\nCovers the entire project:\n- Overall tech stack and architecture\n- Global conventions and coding standards\n- Dev environment setup\n- Repository-wide boundaries\n- CI\u002FCD overview\n\n### Nested AGENTS.md (e.g., `tests\u002FAGENTS.md`)\n\nCovers that specific subfolder:\n- What this folder does and why it exists\n- Folder-specific commands (e.g., `cd tests && pnpm test`)\n- Folder-specific conventions\n- Should NOT repeat root-level content\n\n### Wiki AGENTS.md (`wiki\u002FAGENTS.md`)\n\n**ALWAYS check** if `wiki\u002FAGENTS.md` exists before generating — same only-if-missing guard as all other folders. If it exists, skip it.\n\nUse this template (adapt to the actual project):\n\n```markdown\n# Wiki — Agent Instructions\n\n## Overview\nGenerated VitePress documentation site. Contains architecture docs, onboarding guides, and API references with source-linked citations and dark-mode Mermaid diagrams.\n\n## Build & Run\n- Install: `npm install`\n- Dev server: `npm run dev`\n- Build: `npm run build`\n- Preview: `npm run preview`\n\n## Wiki Structure\n- `index.md` — Landing page with project overview and navigation\n- `onboarding\u002F` — Audience-tailored guides (contributor, staff engineer, executive, product manager)\n- `{NN}-{section}\u002F` — Numbered documentation sections\n- `llms.txt` — LLM-friendly project summary (links + descriptions)\n- `llms-full.txt` — LLM-friendly full content (inlined pages)\n- `.vitepress\u002Fconfig.mts` — VitePress config with sidebar and Mermaid setup\n- `.vitepress\u002Ftheme\u002F` — Dark theme (custom.css) and zoom handlers (index.ts)\n\n## Content Conventions\n- All Mermaid diagrams use dark-mode colors (fills `#2d333b`, borders `#6d5dfc`, text `#e6edf3`)\n- Every page has VitePress frontmatter (`title`, `description`)\n- Citations link to source repository with line numbers\n- Tables include a \"Source\" column with linked citations\n- Mermaid diagrams followed by `\u003C!-- Sources: ... -->` comment blocks\n\n## Boundaries\n- ✅ **Always do:** Add new pages following existing section numbering, use dark-mode Mermaid colors\n- ⚠️ **Ask first:** Change theme CSS, modify VitePress config, restructure sections\n- ? **Never do:** Delete generated pages without understanding dependencies, use light-mode colors, remove citation links\n\n## Documentation\n- Wiki: `.\u002F` — This folder is the wiki\n- LLM Context: `llms.txt` — Quick summary; `llms-full.txt` — Full content\n- Onboarding: `onboarding\u002F` — Four audience-tailored guides\n```\n\nFill in the real section names, technologies, and project-specific conventions.\n\nAgents read the nearest AGENTS.md in the directory tree. Nested files take precedence, so they should contain folder-specific details, not global ones.\n\n## CLAUDE.md Companion File\n\nWhenever you generate an `AGENTS.md` in a folder, also generate a `CLAUDE.md` in the same folder — **only if `CLAUDE.md` does not already exist**.\n\nThe `CLAUDE.md` content is always exactly:\n\n```markdown\n# CLAUDE.md\n\n\u003C!-- Generated for repository development workflows. Do not edit directly. -->\n\nBefore beginning work in this repository, read `AGENTS.md` and follow all scoped AGENTS guidance.\n```\n\nThis ensures Claude Code (and similar tools that look for `CLAUDE.md`) are redirected to the authoritative `AGENTS.md` instructions.\n\n**Same guard applies:** check if `CLAUDE.md` exists before writing. If it exists, skip it.\n\n## Quality Principles\n\n| Principle | Good | Bad |\n|-----------|------|-----|\n| **Specific** | \"React 18 with TypeScript, Vite, Tailwind CSS\" | \"React project\" |\n| **Executable** | `pytest tests\u002F -v --tb=short` | \"run the tests\" |\n| **Grounded** | Show a real code snippet from the project | Describe the style in abstract terms |\n| **Real paths** | `src\u002Fapi\u002Froutes\u002F` | `path\u002Fto\u002Fyour\u002Fcode\u002F` |\n| **Honest** | Omit testing section if no tests exist | Invent a testing section |\n| **Concise** | 30-80 lines for most folders | 300+ lines of prose |\n\n## Anti-Patterns to Avoid\n\n- ❌ **\"You are a helpful coding assistant\"** — too vague, describes feelings not actions\n- ❌ **Generic boilerplate** — content that could apply to any project provides no value\n- ❌ **Invented commands\u002Fpaths** — every command and path must reference something real\n- ❌ **Duplicating README.md** — AGENTS.md complements README, doesn't copy it\n- ❌ **Including secrets** — never put credentials, API keys, or tokens in AGENTS.md\n- ❌ **Overwriting existing files** — if AGENTS.md exists, do not touch it\n- ❌ **Padding empty sections** — if there are no tests, don't write a testing section\n- ❌ **Describing what agents should \"think\" or \"feel\"** — describe what they should DO\n",{"name":5,"license":15,"metadata":53,"description":7},{"author":12,"version":54},"1.0.0","main","3f5b461b2314e01c400564051e92469114c5b68f",".github\u002Fplugins\u002Fdeep-wiki\u002Fskills\u002Fwiki-agents-md",368,"https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fskills","https:\u002F\u002Fmicrosoft.github.io\u002Fskills\u002F","https:\u002F\u002Fgithub.com\u002Fmicrosoft","https:\u002F\u002Fopensource.microsoft.com","Open source projects and samples from Microsoft","2026-11-14 06:48:25",{"source":8,"skillName":5,"commands":66,"prompt":76,"zipAvailable":77},[67,70,73],{"tool":68,"command":69},"npx","npx skills add microsoft\u002Fskills --skill wiki-agents-md",{"tool":71,"command":72},"bunx","bunx skills add microsoft\u002Fskills --skill wiki-agents-md",{"tool":74,"command":75},"pnpm","pnpm dlx skills add microsoft\u002Fskills --skill wiki-agents-md","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fskills\u002Fblob\u002Fmain\u002F.github\u002Fplugins\u002Fdeep-wiki\u002Fskills\u002Fwiki-agents-md\u002FSKILL.md",true,[79,85],{"path":80,"resourceType":81,"resourceTypeDesc":82,"sizeBytes":83,"sourceHtmlUrl":84},"templates\u002Fadr-template.md","REFERENCE","参考文档",5356,"https:\u002F\u002Fgithub.com\u002Fshengdabai\u002FTony-Claude-Code-Skills\u002Fblob\u002Fmain\u002Fskills\u002F_collections\u002Frsmdt-the-startup\u002Fplugins\u002Fteam\u002Fskills\u002Fdevelopment\u002Ftechnical-writing\u002Ftemplates\u002Fadr-template.md",{"path":86,"resourceType":81,"resourceTypeDesc":82,"sizeBytes":87,"sourceHtmlUrl":88},"templates\u002Fsystem-doc-template.md",11721,"https:\u002F\u002Fgithub.com\u002Fshengdabai\u002FTony-Claude-Code-Skills\u002Fblob\u002Fmain\u002Fskills\u002F_collections\u002Frsmdt-the-startup\u002Fplugins\u002Fteam\u002Fskills\u002Fdevelopment\u002Ftechnical-writing\u002Ftemplates\u002Fsystem-doc-template.md",[90,98,121,159,186,206],{"skillNo":91,"name":92,"nameZh":6,"description":93,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":94,"categories":95,"keywords":96,"publishedAt":97},"01M741JBE1VH8A2Y3FXX2P7386","azure-advisor-cost-optimization","Analyze Azure Advisor Cost\u002FIdleResources findings and prevalidate deletion safety, including Service Groups. WHEN: \"find unused Azure resources\", \"what resources am I paying for but no longer using\", \"idle-resource savings\", \"historical idle-resource savings\", \"are these idle resources safe to delete\". Generic Cost, other subcategories, and cross-category requests use azure-advisor.","https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fskills\u002Fblob\u002Fmain\u002F.github\u002Fplugins\u002Fazure-advisor\u002Fskills\u002Fazure-advisor-cost-optimization\u002FSKILL.md",[],[],"2026-11-11 15:11:14",{"skillNo":99,"name":100,"nameZh":6,"description":101,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":102,"categories":103,"keywords":105,"publishedAt":48},"01M69B4JCRQV5SPXAFCKXQRV0H","skill-creator","Guide for creating effective skills for AI coding agents working with Azure SDKs and Microsoft Foundry services. Use when creating new skills or updating existing skills.","https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fskills\u002Fblob\u002Fmain\u002F.github\u002Fskills\u002Fskill-creator\u002FSKILL.md",[104],{"categoryNo":24,"categoryName":25,"taxonomyType":21,"taxonomyTypeDesc":22},[106,107,108,109,9,110,111,112,42,113,31,114,115,116,117,118,119,32,120],"skill creator","creator","ai coding agents","coding agents","azure","foundry","microsoft foundry","guide","use","Existing","services","new","when","sdks","ai coding",{"skillNo":122,"name":123,"nameZh":6,"description":124,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":125,"categories":126,"keywords":137,"publishedAt":48},"01M69B4FD57V1MYKRWAJJECTZ7","podcast-generation","Generate AI-powered podcast-style audio narratives using Azure OpenAI's GPT Realtime Mini model via WebSocket. Use when building text-to-speech features, audio narrative generation, podcast creation from content, or integrating with Azure OpenAI Realtime API for real audio output. Covers full-stack implementation from React frontend to Python FastAPI backend with WebSocket streaming.","https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fskills\u002Fblob\u002Fmain\u002F.github\u002Fskills\u002Fpodcast-generation\u002FSKILL.md",[127,130,133,136],{"categoryNo":128,"categoryName":129,"taxonomyType":21,"taxonomyTypeDesc":22},"01JBSEEDCAT000000000000009","前端开发",{"categoryNo":131,"categoryName":132,"taxonomyType":21,"taxonomyTypeDesc":22},"01JBSEEDCAT000000000000010","后端与接口",{"categoryNo":134,"categoryName":135,"taxonomyType":21,"taxonomyTypeDesc":22},"01JBSEEDCAT000000000000016","图像与多媒体",{"categoryNo":24,"categoryName":25,"taxonomyType":21,"taxonomyTypeDesc":22},[138,139,140,141,110,142,143,144,145,146,147,148,149,150,151,118,152,153,154,155,156,157,158],"podcast generation","generation","podcast","frontend","azure openai","realtime","react","python","Audio","creation","model","fastapi backend","python fastapi","fastapi","api","streaming","text","narrative","stack","generate","features",{"skillNo":160,"name":161,"nameZh":6,"description":162,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":163,"categories":164,"keywords":166,"publishedAt":48},"01M69B4CYPM5SESY5ZWEFDXEQZ","microsoft-docs","Understand Microsoft technologies by querying official documentation. Use whenever the user asks how something works, wants tutorials, needs configuration options, limits, quotas, or best practices for any Microsoft technology (Azure, .NET, M365, Windows, Power Platform, etc.)—even if they don't mention \"docs.\" If the question is about understanding a concept rather than writing code, this is the right skill.","https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fskills\u002Fblob\u002Fmain\u002F.github\u002Fskills\u002Fmicrosoft-docs\u002FSKILL.md",[165],{"categoryNo":24,"categoryName":25,"taxonomyType":21,"taxonomyTypeDesc":22},[167,9,168,169,170,171,172,110,173,174,175,176,177,178,179,180,31,181,68,182,114,183,184,185],"microsoft docs","docs","documentation","windows","official","cli","MCP","writing","power platform","mcp server","back","concept","power","platform","technology","question","learn mcp","learn","best practices",{"skillNo":187,"name":188,"nameZh":6,"description":189,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":190,"categories":191,"keywords":193,"publishedAt":48},"01M69B49C3YPD1ZJ3NC0HPCY58","mcp-builder","Guide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP), Node\u002FTypeScript (MCP SDK), or C#\u002F.NET (Microsoft MCP SDK).","https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fskills\u002Fblob\u002Fmain\u002F.github\u002Fskills\u002Fmcp-builder\u002FSKILL.md",[192],{"categoryNo":24,"categoryName":25,"taxonomyType":21,"taxonomyTypeDesc":22},[194,173,195,196,197,9,145,198,199,148,200,118,201,202,203,113,30,204,31,205,114,32],"mcp builder","builder","llms","sdk","typescript","model context protocol","building mcp servers","node","integrate","Tools","fastmcp","mcp sdk",{"skillNo":207,"name":208,"nameZh":6,"description":209,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":210,"categories":211,"keywords":224,"publishedAt":48},"01M69B467A7CDMFQ0T6Q0ZA12Q","kql","KQL language expertise for writing correct, efficient Kusto Query Language queries. Covers syntax gotchas, join patterns, dynamic types, datetime pitfalls, regex patterns, serialization, memory management, result-size discipline, and advanced functions (geo, vector, graph). USE THIS SKILL whenever writing, debugging, or reviewing KQL queries — even simple ones — because the gotchas section prevents the most common errors that waste tool calls and cause expensive retry cascades. Trigger on: KQL, Kusto, ADX, Azure Data Explorer, Fabric Real-Time Intelligence, EventHouse, Log Analytics, log analysis, data exploration, time series, anomaly detection, summarize, where clause, join, extend, project, let statement, parse operator, extract function, any mention of pipe-forward query syntax.","https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fskills\u002Fblob\u002Fmain\u002F.github\u002Fskills\u002Fkql\u002FSKILL.md",[212,215,216,221],{"categoryNo":213,"categoryName":214,"taxonomyType":21,"taxonomyTypeDesc":22},"01JBSEEDCAT000000000000018","写作与文案",{"categoryNo":24,"categoryName":25,"taxonomyType":21,"taxonomyTypeDesc":22},{"categoryNo":217,"categoryName":218,"taxonomyType":219,"taxonomyTypeDesc":220},"01JBSEEDCAT000000000000033","数据分析师","PROFESSION","适用职业",{"categoryNo":222,"categoryName":223,"taxonomyType":219,"taxonomyTypeDesc":220},"01JBSEEDCAT000000000000036","内容创作者",[208,110,174,225,226,227,228,229,37,230,231,232,233,234,235,236,237,238,239,31,240,241,242],"analytics","memory","summarize","exploration","parse","time","vector","join","log","pipe","datetime","discipline","time series","regex","anomaly","section","tool","geo"]