1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | wiki-architect-microsoft-skills |
| 作者/维护者 | Microsoft（官方仓库 microsoft/skills，主要提交者 Govind Kamtamneni，另有 Larry Osterman、Scott Addie 等具名工程师参与维护） |
| 来源链接 | https://github.com/microsoft/skills/tree/main/.github/plugins/deep-wiki/skills/wiki-architect |
| 许可证 | MIT（数据来自 GitHub API 与 SKILL.md 声明） |
| GitHub Stars | 合集仓库整体 2,818（数据来自 GitHub API，2026-07-26）；该数字属整个 microsoft/skills 仓库，不代表本技能自身热度 |
| Forks | 合集仓库整体 317（数据来自 GitHub API） |
| 最新版本 | 1.0.0（SKILL.md metadata 声明；仓库未创建对应 GitHub Release） |
| 安装方式 | GitHub Copilot CLI 插件市场一条命令安装；其他兼容 Agent Skills 规范的工具可直接复制 SKILL.md 文件 |
2. 功能介绍与亮点
wiki-architect 分析代码仓库的文件树、README 与构建文件，识别所用语言、框架与架构模式，划分表现层、业务逻辑层、数据访问层、基础设施层等分层结构，产出一份带真实文件引用的分层 JSON 目录（catalogue），作为后续逐页文档生成的蓝图。
核心亮点是内置的四受众入职指南架构：同一次分析会分别产出面向新贡献者（语言/框架基础对比 + 领域模型讲解）、资深工程师（核心架构洞察 + Mermaid 架构图 + 设计取舍记录）、高管（能力地图、风险评估、成本模型，不含代码片段）、产品经理（用户旅程图、功能地图、已知限制，零工程术语）四份定制内容，一次分析覆盖四类不同背景的读者，且要求所有标题必须来自真实代码库内容，禁止通用占位符。
技能纯粹基于提示词与只读 git 命令运作，不依赖额外解析引擎或外部 API；产出的目录可直接接力给同一插件内的 wiki-page-writer（逐页撰写）、wiki-vitepress（打包成站）等姊妹技能，组成完整文档生成流水线。
3. 适用场景
所属分类：内容创作与知识管理
- 接手陌生大型代码库、需要快速搭建结构化文档框架的工程师
- 需要向新员工、资深工程师、管理层、产品经理分别讲清同一个项目架构的团队负责人
- 开源项目维护者，希望给贡献者提供一份有条理的“从零到一”文档骨架
- 需要为 VitePress 等文档站点预先规划好目录结构的技术写作者
4. 跨 Agent 兼容性
- Claude Code：技能文件本身遵循通用 Agent Skills 规范（YAML front matter + Markdown 指令），可直接复制安装；但仓库的
.claude-plugin/marketplace.json存在已知路径配置问题，2026-03-12 有用户在 issue #189 报告通过 Claude Code 插件市场安装该仓库时收到 “Failed to add Marketplace” 报错，另一位用户在跟帖中说明改用第三方技能安装工具后可正常使用——判定为需适配。 - Codex / OpenClaw / Hermes Agent：未验证。README 与 SKILL.md 均未提及针对这三者的专门测试或安装说明。
5. 推荐理由
它把“给代码库写文档”从一次性、笼统的任务变成结构化、可复用的分层蓝图生成过程——内置的四受众入职指南设计，直接解决了同一份代码库文档“工程师看不懂业务背景、管理层看不懂技术细节”的老问题。技能零配置、零外部依赖，纯粹依托宿主 Agent 自身的文件读取能力完成，安全面清爽，适合初中级用户在拿到一个新代码库时第一时间跑一遍、快速建立全局认知。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 7 | 该子目录自身有多条第三方 PR/issue 互动（含外部贡献者 2026-07-21 提交的界面修复 PR、多位具名用户在安装讨论中的往来），显示真实社区触达；母仓库整体星数体现的是 microsoft/skills 全库热度，不代表该子目录本身 |
| 可用性 | 8 | 单文件复制即用，SKILL.md 含完整流程说明与产出结构示例，无付费依赖；仓库整体在 2026-07-24 仍有推送，该插件相关 PR 在 2026-07-21 仍有社区互动，维护活跃 |
| 安全性 | 9 | 见下方检查清单，全部指标良好，无一票否决因素 |
| 综合 | 8.0 | 三项均值 |
安全检查清单：① Shell 命令——仅执行两条只读 git 命令（获取远程地址、默认分支），无写入或系统级操作；② 联网外发——无，全部分析基于本地文件读取；③ API Key/凭据——不需要；④ 可疑指令——SKILL.md 正文未见越权指令或隐蔽外发迹象；⑤ 作者信誉——Microsoft 官方仓库，多名具名工程师参与；⑥ License——MIT，明确；⑦ 最近维护——插件相关 PR 在 2026-07-21 仍有社区互动，仓库整体 2026-07-24 有推送。
7. 跟同类 Skills 相比的优势
| 对比对象 | 定位 | 与 wiki-architect 的差异 |
|---|---|---|
| ai-doc-gen（企业官方出品） | 面向单份 README 与 CLAUDE.md/AGENTS.md 等 AI 助手配置文件生成，多个子 agent 并行分析代码库 | 产出物是单篇 README + 配置文件，不生成分层多页 wiki 结构，也没有分受众定制的入职指南设计 |
| obsidian-wiki | 面向长期研究场景的跨会话知识库框架，强调笔记随时间持续积累与复用 | 关注点是“知识随时间沉淀”而非“针对某个代码库一次性生成结构化架构文档”；不产出 Mermaid 架构图，也没有面向高管/产品经理等非工程角色的定制内容 |
8. 用户评价
GitHub 用户 thevman 在仓库 issue #189（2026-03-12）中记录了尝试通过 Claude Code 插件市场安装 deep-wiki 家族技能的过程；另一位用户 thenewnano 在跟帖中说明已改用第三方技能安装工具 npx skills add 成功用上该技能。这条讨论线显示该技能已被 Claude Code 生态的真实用户实际尝试安装使用，但目前尚未见到聚焦具体使用效果的评价文字。
9. 其他补充
wiki-architect 所在的 deep-wiki 插件还包含 wiki-page-writer、wiki-onboarding、wiki-researcher、wiki-qa 等 9 个姊妹技能，组合安装可形成“目录生成 → 逐页写作 → 打包成站”的完整文档生成工作流；插件同时提供对应的 /deep-wiki:* slash command 供 Copilot CLI 用户直接调用，功能等价。
10. 安装使用方式
GitHub Copilot CLI（官方原生渠道）：
/plugin marketplace add microsoft/skills
/plugin install deep-wiki@skills安装后在对话中提出“帮我建一份 wiki”“生成这个项目的文档”等请求即可自动触发，也可用 /deep-wiki:catalogue 直接调用同名 slash command。
其他兼容 Agent Skills 规范的工具（含 Claude Code 手动安装）：将以下文件另存为技能目录下的 SKILL.md 即可：
https://raw.githubusercontent.com/microsoft/skills/main/.github/plugins/deep-wiki/skills/wiki-architect/SKILL.md安装后无需重启 Agent；首次运行会询问目标仓库是本地专属还是有远程地址，用于决定输出中的引用链接格式（远程仓库用可点击的 文件:行号 超链接，本地仓库用纯文本路径）。
11. 注意事项
- 通过 Copilot CLI 插件市场安装会连带装入整个 deep-wiki 插件（10 个技能 + 13 个 slash command + 3 个自定义 agent）；只想用 wiki-architect 单个技能时需手动复制对应 SKILL.md 文件
- 仓库的
.claude-plugin/marketplace.json存在已知路径配置问题，通过 Claude Code 插件市场直接安装该仓库可能遇到 “Failed to add Marketplace” 报错，需改用手动复制 SKILL.md 或第三方技能安装工具规避 - 生成的文档质量高度依赖宿主 Agent 自身的代码检索与理解能力，技能本身不包含独立的静态分析引擎
- 版本号固定为 SKILL.md 声明的 1.0.0，仓库未建立正式 GitHub Release，版本追踪需以提交历史为准