Wiki Architect
将代码仓库分析为分层文档目录和循序渐进的上手指南。
技能限定为扫描仓库并生成文档，要求先解析仓库来源并使用本地或链接引用，未见恶意行为、凭证处理或破坏性默认操作，因此保留较高分；但未明确权限范围、敏感数据处理、外部链接安全、用户确认、回滚或数据流披露，扣8分。
步骤顺序、触发条件和输出字段较清晰，且仓库提供通用测试基础设施；但本技能没有专属测试或示例，强制执行git命令在非Git环境中的失败反馈未定义，且未说明扫描异常、超大仓库或缺失README时如何处理，扣13分；静态评估上限为10分。
触发场景明确，目标是架构理解、Wiki、目录和入门文档；但未声明不适用范围、输入边界或语义冲突处理，也没有中文输出支持说明。其核心功能不依赖海外服务，未因网络可达性扣分，扣5分。
具有名称、描述、MIT许可证、作者和1.0.0版本元数据，结构包含触发条件、流程、约束和输出要求；但缺少安装/依赖说明、参数稳定性说明、示例、FAQ、已知限制、变更记录及明确维护责任和更新路径，扣7分。
目标输出包含分层目录、四类入门指南和文件引用，理论上可直接形成文档规划；但没有完整schema示例或代表性产物，部分要求（40+术语表、图表、成本模型等）可能造成过度生成，且静态读取无法证明结果正确性，扣9分；静态评估上限为7分。
技能要求引用实际文件，仓库存在CI、评估工作流和测试代码，提供一定可审计性；但给定材料未证明该技能路径有专属场景、测试覆盖或第三方可复现实例，扣6分；静态评估上限为5分。
- 强制要求先运行git remote get-url origin和git rev-parse，未定义命令失败或非Git仓库时的可诊断处理。
- 未规定敏感信息、私有仓库内容和外部引用链接的处理边界。
- 输出要求很重，可能生成超出用户实际需要的多层指南；没有示例schema或最小输出样例。
- CI和测试材料是仓库级证据，并非该技能路径的专属验证。
它能做什么 & 适用场景
Wiki Architect 是 Microsoft Agent Skills 仓库中 deep-wiki 插件的一项文档架构技能。它面向需要创建 wiki、规划文档、梳理代码库结构或理解高层架构的用户。技能会先确认源代码仓库上下文，再分析文件树、README、项目类型、技术栈和架构层次。最终产出包含入门指南、Getting Started 和 Deep Dive 的分层文档目录。
先运行 Git 命令检查 origin 远程地址和当前分支，并确认仓库是本地仓库还是有源代码仓库 URL；随后扫描文件树和 README，识别语言、框架、关键技术及展示层、业务逻辑、数据访问和基础设施层；最后生成最多四层、每节最多八个子项的 JSON 文档目录，包含 Contributor、Staff Engineer、Executive 和 Product Manager 四类 onboarding 指南，并要求各节提示引用具体文件。
- 新贡献者需要一条从语言基础到代码导航、测试和贡献流程的上手路径时。
- 技术负责人需要用目录、架构图、领域模型和设计取舍规划深度文档时。
- 团队准备为一个中大型代码仓库创建 wiki 和高层架构地图时。
- 产品或管理人员需要从同一仓库文档中获得不含代码的能力、风险和使用概览时.
优缺点一览
- 明确覆盖仓库扫描、架构识别、文档分层和 onboarding 规划。
- 为不同读者定义了 Contributor、Staff Engineer、Executive 和 Product Manager 四种指南。
- 要求引用具体文件，并限制目录深度和单节子项数量。
- 必须先解决源仓库上下文，缺少远程地址或本地仓库确认时不能继续。
- 技能本身没有提供测试场景或验收标准；README 的测试统计针对集合，未证明该技能单独有测试覆盖。
- 输出依赖可访问的代码仓库文件树和 README；源材料未说明对缺失或不可读文件的处理方式。
如何安装
该技能位于 .github/plugins/deep-wiki/skills/wiki-architect/SKILL.md。README 提供的集合安装命令是：npx skills add microsoft/skills，然后在向导中选择需要的技能；也可以在 Copilot CLI 中运行 /plugin marketplace add microsoft/skills 和 /plugin install deep-wiki@skills。源材料未说明 wiki-architect 的独立安装命令。
如何使用
将技能安装到代理配置目录后，使用类似“create a wiki for this repository”“document this repo”“map the codebase structure”或“create an onboarding guide”的请求触发。技能要求先确认源仓库上下文，并在获得远程 URL或确认本地仓库后再继续。