Wiki 代码库研究员
跨文件追踪真实代码路径，生成有证据支撑的深度系统分析。
技能要求先确认仓库来源、区分远程与本地引用，并强调基于实际代码和事实/推断分离，降低误引和范围漂移风险；但未说明敏感数据处理、权限最小化、外部副作用、回滚或依赖安全，因此扣分。
流程、迭代视角和失败边界描述较清楚，要求在未知处明确说明；但依赖Git及可解析的仓库上下文，未定义Git不可用、远程不可达、分支不存在或跨文件追踪失败时的具体诊断和恢复方式，且静态审查上限限制为10分以内。
触发场景明确，适合跨文件架构、数据流和模式研究，并声明聚焦具体主题；但未充分说明不适用场景、输入输出契约、语义排除条件，也没有中文输出或中国大陆网络可达性的支持说明，因此扣分。
SKILL.md具有清晰的激活条件、核心不变量、证据标准和五阶段结构，并声明MIT许可、作者和1.0版本；但缺少安装/依赖说明、示例输出、FAQ、已知限制、变更记录和明确维护更新路径，因此扣分。
对需要深度代码库研究的任务提供了可直接采用的研究框架，包含代码路径、证据、影响、置信度和开放问题；但强制五轮、每轮图表等要求可能增加成本，且没有可验证的代表性最终输出，静态证据不足以支持高于7分。
要求文件路径、函数名、调用链、证据引用及事实/推断区分，具备较好的审计意图；但技能自身没有针对关键路径的测试或第三方复现证据，当前仅能静态阅读，故不超过5分。
- 执行前必须依赖Git仓库上下文和用户回答；技能未提供远程不可达、Git缺失或分支解析失败时的具体降级流程。
- 强制五轮研究、每轮Mermaid图和结构化表格，可能使简单问题产生不必要的时间和上下文成本。
- 未定义敏感代码、凭据或私有仓库内容的处理边界，也未提供中文输出规范或中国大陆网络适配说明。
这个 Skill 能做什么，适合哪些场景？
Wiki Researcher 面向需要深入理解代码库、复杂系统或跨文件模式的开发者。它要求先确认源代码仓库上下文，再进行五轮研究：架构、数据流、集成、模式与综合建议。输出强调实际代码路径、文件引用、Mermaid 图和结构化表格。它适合深度研究，不是通用代码生成或快速问答技能。
首先检查 Git 远程仓库并确定当前分支，要求用户确认仓库是本地专用还是有源仓库 URL。随后按五个视角研究代码库，追踪入口、调用链、数据流、依赖和集成关系，生成 Mermaid 架构或流程图、结构化表格、文件与行号引用、风险和建议，并标记未探索范围、证据强度和开放问题。
- 后端开发者需要解释一个功能如何跨多个文件执行时，用它追踪完整调用链。
- 架构师需要绘制真实系统边界、组件关系和外部集成时，用它整理证据。
- 新加入项目的工程师需要建立复杂代码库的系统认知时，用它生成带引用的研究材料。
- 技术写作者需要为代码库编写 wiki、架构页面或入门文档时，用它提取可核验事实。
这个 Skill 有哪些优点和局限？
- 明确要求读取真实实现并追踪完整调用链。
- 五轮研究覆盖架构、数据流、依赖、模式和综合建议。
- 要求使用文件引用、Mermaid 图、表格、置信度和开放问题。
- MIT 许可，可从微软 Agent Skills 集合安装。
- 必须先完成源仓库上下文确认，不能直接开始研究。
- 依赖 Git、文件系统访问和可能的网络访问。
- 提供的 SKILL.md 没有测试套件、具体输出模板或失败恢复实现证据。
- 研究深度和结果质量取决于可访问的代码与引用信息。
如何安装这个 Skill？
使用集合安装命令：npx skills add microsoft/skills。在向导中选择需要的技能，并将其安装到所选 Agent 的目录，例如 GitHub Copilot 使用的 .github/skills/。README 未提供仅安装 wiki-researcher 的独立命令。
如何使用这个 Skill？
在已安装该技能的代码库中提出深度研究请求，例如：请深入分析 X 如何跨多个文件工作，追踪实际代码路径并提供文件引用、Mermaid 图和开放问题。 研究开始前需要确认源仓库上下文；未解决前不会继续。