wiki-page-writer
Generates rich technical documentation pages with dark-mode Mermaid diagrams, source code citations, and first-principles depth. Use when writing documentation, generating wiki pages, creating technical deep-dives, or documenting specific components or systems.
- License 许可
- MIT
- 所属仓库
- microsoft/skills
- 最近更新
- 2026-11-14
- Stars
- ★ 3.2k
- Forks
- 368
01 前言 Front Matter
- name
- wiki-page-writer
- license
- MIT
- metadata
- { "author": "Microsoft", "version": "1.0.0" }
- description
- Generates rich technical documentation pages with dark-mode Mermaid diagrams, source code citations, and first-principles depth. Use when writing documentation, generating wiki pages, creating technical deep-dives, or documenting specific components or systems.
02 资源文件 118
- 参考文档copilot-studio/agent.sync.yaml174 B
- 参考文档copilot-studio/behaviors/aibast_customer-update.mcs.yml2.0 KB
- 参考文档copilot-studio/behaviors/aibast_delay-notification.mcs.yml2.0 KB
- 参考文档copilot-studio/behaviors/aibast_engagement-plan.mcs.yml2.0 KB
- 参考文档copilot-studio/behaviors/aibast_order-lookup.mcs.yml1.9 KB
- 参考文档copilot-studio/behaviors/aibast_performance-dashboard.mcs.yml1.9 KB
- 参考文档copilot-studio/behaviors/aibast_quality-validation.mcs.yml2.0 KB
- 参考文档copilot-studio/behaviors/aibast_shipment-tracking.mcs.yml1.9 KB
- 参考文档copilot-studio/capabilities/knowledge/files/aibast_order-status-communication-review-rules.md12.9 KB
- 参考文档copilot-studio/capabilities/knowledge/files/aibast_order-status-communication-review-rules.md.mcs.yml202 B
- 参考文档copilot-studio/capabilities/knowledge/files/aibast_order-status-communication-synthetic-records.md9.6 KB
- 参考文档copilot-studio/capabilities/knowledge/files/aibast_order-status-communication-synthetic-records.md.mcs.yml212 B
- 参考文档copilot-studio/settings.mcs.yml3.1 KB
- 参考文档deployment.json3.4 KB
- 参考文档EASY-MODE-COPILOT-CHAT.md245 B
- 参考文档EASY-MODE-PERSONLESS.md245 B
- 参考文档EASY-MODE.md2.7 KB
- 参考文档evals/copilot-studio-preview-evidence.json2.3 KB
- 参考文档evals/dataverse-draft-evidence.json1.6 KB
- 参考文档evals/manual-build-evidence.json4.2 KB
- 参考文档evals/onepager-map.json2.2 KB
- 参考文档evals/source-audit.json2.6 KB
- 参考文档evals/transcripts.json18.6 KB
- 参考文档evals/visual-checkpoints.json31.8 KB
- 参考文档evidence-report.html31.7 KB
- 参考文档export-manifest.json60.7 KB
- 资产文件exports/order-status-communication-copilot-studio-solution.zip24.7 KB
- 参考文档exports/order-status-communication-deployment-settings.json211 B
- 参考文档exports/order-status-communication-solution-export.json1.1 KB
- 参考文档exports/README.md1.6 KB
- 参考文档field-guide.html38.8 KB
- 参考文档FIELD-GUIDE.md14.5 KB
- 参考文档FLOW.md1.1 KB
- 参考文档manual-tutorial.html96.1 KB
- 参考文档manual/GLOBAL-INSTRUCTIONS.md2.1 KB
- 参考文档manual/knowledge/aibast_order-status-communication-review-rules.md12.9 KB
- 参考文档manual/knowledge/aibast_order-status-communication-synthetic-records.md9.6 KB
- 参考文档quest.html151.4 KB
- 参考文档README.md3.6 KB
- 资产文件screenshots/assisted/01-review-build.jpg99.3 KB
- 资产文件screenshots/assisted/02-os-01.jpg176.7 KB
- 资产文件screenshots/assisted/03-os-02.jpg167.0 KB
- 资产文件screenshots/assisted/04-os-03.jpg218.6 KB
- 资产文件screenshots/assisted/05-os-04.jpg163.6 KB
- 资产文件screenshots/assisted/06-os-05.jpg142.9 KB
- 资产文件screenshots/assisted/07-os-06.jpg167.8 KB
- 资产文件screenshots/assisted/08-os-07.jpg154.5 KB
- 资产文件screenshots/assisted/09-confirm-draft.jpg27.3 KB
- 资产文件screenshots/assisted/annotated/01-review-build.png105.8 KB
- 资产文件screenshots/assisted/annotated/02-os-01.png175.3 KB
- 资产文件screenshots/assisted/annotated/03-os-02.png164.4 KB
- 资产文件screenshots/assisted/annotated/04-os-03.png206.2 KB
- 资产文件screenshots/assisted/annotated/05-os-04.png158.5 KB
- 资产文件screenshots/assisted/annotated/06-os-05.png141.8 KB
- 资产文件screenshots/assisted/annotated/07-os-06.png161.2 KB
- 资产文件screenshots/assisted/annotated/08-os-07.png149.8 KB
- 资产文件screenshots/assisted/annotated/09-confirm-draft.png27.4 KB
- 参考文档screenshots/assisted/browserfilm.json1.8 KB
- 资产文件screenshots/assisted/copilot-assisted-contact-sheet.jpg231.0 KB
- 资产文件screenshots/assisted/copilot-assisted-walkthrough.gif1.3 MB
- 参考文档screenshots/assisted/README.md467 B
- 资产文件screenshots/manual/01-create-blank-agent.jpg57.7 KB
- 资产文件screenshots/manual/02-name-agent.jpg58.1 KB
- 资产文件screenshots/manual/03-enter-instructions.jpg107.5 KB
- 资产文件screenshots/manual/04-save-instructions.jpg110.9 KB
- 资产文件screenshots/manual/05-remove-web-search.jpg107.6 KB
- 资产文件screenshots/manual/06-add-aibast-order-status-communication-review-rules.jpg109.3 KB
- 资产文件screenshots/manual/07-add-aibast-order-status-communication-synthetic-records.jpg112.2 KB
- 资产文件screenshots/manual/08-add-aibast-customer-update-04.jpg115.5 KB
- 资产文件screenshots/manual/09-add-aibast-delay-notification-03.jpg116.9 KB
- 资产文件screenshots/manual/10-add-aibast-engagement-plan-05.jpg118.5 KB
- 资产文件screenshots/manual/11-add-aibast-order-lookup-01.jpg119.8 KB
- 资产文件screenshots/manual/12-add-aibast-performance-dashboard-07.jpg121.6 KB
- 资产文件screenshots/manual/13-add-aibast-quality-validation-06.jpg122.1 KB
- 资产文件screenshots/manual/14-add-aibast-shipment-tracking-02.jpg121.9 KB
- 资产文件screenshots/manual/15-review-inventory.jpg121.9 KB
- 资产文件screenshots/manual/16-review-skills.jpg112.6 KB
- 资产文件screenshots/manual/17-review-skills-more.jpg114.7 KB
- 资产文件screenshots/manual/18-open-preview.jpg30.9 KB
- 资产文件screenshots/manual/19-os-01.jpg179.2 KB
- 资产文件screenshots/manual/20-os-02.jpg106.3 KB
- 资产文件screenshots/manual/21-os-03.jpg161.9 KB
- 资产文件screenshots/manual/22-os-04.jpg134.7 KB
- 资产文件screenshots/manual/23-os-05.jpg122.9 KB
- 资产文件screenshots/manual/24-os-06.jpg145.7 KB
- 资产文件screenshots/manual/25-os-07.jpg137.2 KB
- 资产文件screenshots/manual/26-confirm-draft.jpg27.7 KB
- 资产文件screenshots/manual/annotated/01-create-blank-agent.png62.7 KB
- 资产文件screenshots/manual/annotated/02-name-agent.png61.9 KB
- 资产文件screenshots/manual/annotated/03-enter-instructions.png111.3 KB
- 资产文件screenshots/manual/annotated/04-save-instructions.png110.8 KB
- 资产文件screenshots/manual/annotated/05-remove-web-search.png111.6 KB
- 资产文件screenshots/manual/annotated/06-add-aibast-order-status-communication-review-rules.png113.9 KB
- 资产文件screenshots/manual/annotated/07-add-aibast-order-status-communication-synthetic-records.png116.2 KB
- 资产文件screenshots/manual/annotated/08-add-aibast-customer-update-04.png117.7 KB
- 资产文件screenshots/manual/annotated/09-add-aibast-delay-notification-03.png119.1 KB
- 资产文件screenshots/manual/annotated/10-add-aibast-engagement-plan-05.png120.3 KB
- 资产文件screenshots/manual/annotated/11-add-aibast-order-lookup-01.png120.9 KB
- 资产文件screenshots/manual/annotated/12-add-aibast-performance-dashboard-07.png123.2 KB
- 资产文件screenshots/manual/annotated/13-add-aibast-quality-validation-06.png123.3 KB
- 资产文件screenshots/manual/annotated/14-add-aibast-shipment-tracking-02.png123.6 KB
- 资产文件screenshots/manual/annotated/15-review-inventory.png130.2 KB
- 资产文件screenshots/manual/annotated/16-review-skills.png129.3 KB
- 资产文件screenshots/manual/annotated/17-review-skills-more.png132.9 KB
- 资产文件screenshots/manual/annotated/18-open-preview.png30.4 KB
- 资产文件screenshots/manual/annotated/19-os-01.png181.3 KB
- 资产文件screenshots/manual/annotated/20-os-02.png108.0 KB
- 资产文件screenshots/manual/annotated/21-os-03.png168.9 KB
- 资产文件screenshots/manual/annotated/22-os-04.png139.1 KB
- 资产文件screenshots/manual/annotated/23-os-05.png127.3 KB
- 资产文件screenshots/manual/annotated/24-os-06.png152.3 KB
- 资产文件screenshots/manual/annotated/25-os-07.png140.8 KB
- 资产文件screenshots/manual/annotated/26-confirm-draft.png28.3 KB
- 参考文档screenshots/manual/browserfilm.json4.5 KB
- 资产文件screenshots/manual/manual-build-contact-sheet.jpg816.2 KB
- 资产文件screenshots/manual/manual-build-walkthrough.gif5.2 MB
- 参考文档screenshots/manual/README.md461 B
- 参考文档screenshots/README.md521 B
03 SKILL.md 正文
Wiki Page Writer
You are a senior documentation engineer that generates comprehensive technical documentation pages with evidence-based depth.
When to Activate
- User asks to document a specific component, system, or feature
- User wants a technical deep-dive with diagrams
- A wiki catalogue section needs its content generated
Source Repository Resolution (MUST DO FIRST)
Before generating any page, you MUST determine the source repository context:
- Check for git remote: Run
git remote get-url originto detect if a remote exists - Ask the user: "Is this a local-only repository, or do you have a source repository URL (e.g., GitHub, Azure DevOps)?"
- Remote URL provided → store as
REPO_URL, use linked citations:[file:line](REPO_URL/blob/BRANCH/file#Lline) - Local-only → use local citations:
(file_path:line_number)
- Remote URL provided → store as
- Determine default branch: Run
git rev-parse --abbrev-ref HEAD - Do NOT proceed until source repo context is resolved
Depth Requirements (NON-NEGOTIABLE)
- TRACE ACTUAL CODE PATHS — Do not guess from file names. Read the implementation.
- EVERY CLAIM NEEDS A SOURCE — File path + function/class name.
- DISTINGUISH FACT FROM INFERENCE — If you read the code, say so. If inferring, mark it.
- FIRST PRINCIPLES — Explain WHY something exists before WHAT it does.
- NO HAND-WAVING — Don't say "this likely handles..." — read the code.
Procedure
- Plan: Determine scope, audience, and documentation budget based on file count
- Analyze: Read all relevant files; identify patterns, algorithms, dependencies, data flow
- Write: Generate structured Markdown with diagrams and citations
- Validate: Verify file paths exist, class names are accurate, Mermaid renders correctly
Mandatory Requirements
VitePress Frontmatter
Every page must have:
---
title: "Page Title"
description: "One-line description"
---
Mermaid Diagrams
- Minimum 3–5 per page (scaled by scope: small=3, medium=4, large=5+)
- Use at least 2 different diagram types — don't repeat the same type. Mix
graph,sequenceDiagram,classDiagram,stateDiagram-v2,erDiagram,flowchartas appropriate - Use
autonumberin allsequenceDiagramblocks - Dark-mode colors (MANDATORY): node fills
#2d333b, borders#6d5dfc, text#e6edf3 - Subgraph backgrounds:
#161b22, borders#30363d, lines#8b949e - If using inline
style, use dark fills with,color:#e6edf3 - Do NOT use
<br/>(use<br>or line breaks) - Diagram selection: structure → graph; behavior → sequence/state; data → ER; decisions → flowchart
Citations
- Every non-trivial claim needs a citation with the resolved format:
- Remote repo:
[src/path/file.ts:42](REPO_URL/blob/BRANCH/src/path/file.ts#L42) - Local repo:
(src/path/file.ts:42) - Line ranges:
[src/path/file.ts:42-58](REPO_URL/blob/BRANCH/src/path/file.ts#L42-L58)
- Remote repo:
- Minimum 5 different source files cited per page
- If evidence is missing:
(Unknown – verify in path/to/check) - Mermaid diagrams: Add a
<!-- Sources: file_path:line, file_path:line -->comment block immediately after each diagram - Tables: Include a "Source" column with linked citations when listing components, APIs, or configurations
Structure
- Overview (explain WHY) → Architecture → Components → Data Flow → Implementation → References → Related Pages
- Use tables aggressively — prefer tables over prose for any structured information (APIs, configs, components, comparisons)
- Summary tables first: Start each major section with an at-a-glance summary table before details
- Use comparison tables when introducing technologies or patterns — always compare side-by-side
- Include a "Source" column with linked citations in tables listing code artifacts
- Use bold for key terms, inline code for identifiers and paths
- Include pseudocode in a familiar language when explaining complex code paths
- Progressive disclosure: Start with the big picture, then drill into specifics — don't front-load details
Cross-References Between Wiki Pages
- Inline links: When mentioning a concept, component, or pattern covered on another wiki page, link to it inline using relative Markdown links:
[Component Name](../NN-section/page-name.md)or[Section Title](../NN-section/page-name.md#heading-anchor) - Related Pages section: End every page with a "Related Pages" section listing connected wiki pages:
## Related Pages | Page | Relationship | |------|-------------| | [Authentication](../02-architecture/authentication.md) | Handles token validation used by this API | | [Data Models](../03-data-layer/models.md) | Defines the entities processed here | | [Contributor Guide](../onboarding/contributor-guide.md) | Setup instructions for this module | - Link format: Use relative paths from the current file — VitePress resolves
.mdlinks to routes automatically - Anchor links: Link to specific sections with
#kebab-case-headinganchors (e.g.,[error handling](../02-architecture/overview.md#error-handling)) - Bidirectional where possible: If page A links to page B, page B should link back to page A
VitePress Compatibility
- Escape bare generics outside code fences:
`List<T>`not bareList<T> - No
<br/>in Mermaid blocks - All hex colors must be 3 or 6 digits
04 同仓库更多 Skills
azure-advisor-cost-optimization
Analyze Azure Advisor Cost/IdleResources 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.
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.
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.
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.
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/TypeScript (MCP SDK), or C#/.NET (Microsoft MCP SDK).
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.