代码库问答
基于源代码证据回答代码库工作原理与导航问题。
技能限定仅基于源文件分析，并要求引用来源，未见恶意行为、凭据窃取、隐蔽外传或破坏性默认操作，因此基础信任较好。扣分在于强制运行 git remote/git branch 命令、要求用户提供仓库信息，却未说明敏感仓库信息处理、权限边界、失败恢复或数据流细节。
流程主线清晰：解析上下文、搜索文件、阅读证据并综合回答。扣分在于要求先运行命令并等待用户确认，但未定义命令失败、无远程、分离 HEAD、仓库不可访问或引用生成失败时的诊断路径；静态审查且没有针对该技能的可执行覆盖证据，故不超过10分。
触发条件明确，覆盖代码库工作原理、文件、函数和组件导航，并要求使用用户语言回答。扣分在于未明确非适用范围、输入输出边界和不同仓库托管平台的处理；远程引用依赖 GitHub/Azure DevOps 等外部地址，对网络受限环境及中文用户的可达性说明不足。
SKILL.md 具备名称、描述、MIT 许可、作者和版本元数据，章节结构易读。扣分在于没有示例、FAQ、故障排查、已知限制、变更记录或明确的技能维护责任与更新路径；输出要求较重，且未说明如何逐步披露复杂结果。
核心任务——基于源代码回答仓库问题——目标明确，且要求引用和关键文件表，理论上可形成可用答案。扣分在于强制 Mermaid、表格和特定 Markdown 格式并不适合所有问题，缺少代表性输出或结果完整性证据，且在上下文未解析时会阻塞本可直接回答的问题；静态条件下最高仅能接近7分。
规则要求只使用实际源文件并内联引用，具备一定可审计性；仓库还提供通用 CI 和测试材料。扣分在于提供的测试没有覆盖 wiki-qa 的关键路径，也没有该技能专属评测、第三方复核或执行结果；静态证据不足以支持更高分。
- 技能在解析 git 远程地址和默认分支前会阻塞回答；未定义无远程、分离 HEAD、命令失败或网络不可达时的替代流程。
- 强制远程链接引用、Mermaid 和表格可能增加中文用户及受限网络环境中的使用成本。
- 仓库级 CI 和测试不能证明该 wiki-qa 技能本身的回答正确性或引用可靠性。
这个 Skill 能做什么，适合哪些场景？
代码库问答是一个面向软件开发的 Agent Skill，用于分析代码库并回答组件、文件和函数如何工作的疑问。它要求先确认源代码仓库上下文，再搜索并读取相关文件。回答应使用提问者的语言，并附带行级来源引用。该技能适合需要理解现有代码、定位定义或生成带证据技术说明的开发者。
先运行 git remote get-url origin 检查远程仓库，并运行 git rev-parse --abbrev-ref HEAD 确定默认分支；要求确认仓库是本地仓库还是具有源代码 URL；随后搜索和读取相关源文件，分析代码证据，生成带行级引用的问答，必要时说明信息不足并建议进一步检查的文件。
- 开发者接手陌生代码库，需要了解某个组件的工作方式。
- 维护者想定位特定文件、函数或功能的定义位置。
- 团队成员询问“X 是如何工作的”，并需要源代码证据支持答案。
- 技术文档作者需要包含关键文件表格和架构图的代码库说明。
这个 Skill 有哪些优点和局限？
- 明确要求先解析仓库远程地址和分支上下文。
- 强调只依据源代码证据回答。
- 支持远程仓库行级链接引用或本地文件行号引用。
- 覆盖代码理解、文件定位和代码库导航问题。
- 依赖代理能够运行 Git 命令并读取代码库。
- 要求用户先确认仓库来源，否则流程不得继续。
- SKILL.md 未提供测试套件或具体编程语言支持范围。
- 源材料未说明如何处理无法访问远程仓库或无法获得源文件的情况。
如何安装这个 Skill？
安装整个技能集合：运行 npx skills add microsoft/skills，在向导中选择需要的技能。使用 Copilot CLI 时，也可运行 /plugin marketplace add microsoft/skills，然后运行 /plugin install deep-wiki@skills。源材料未说明如何单独安装 .github/plugins/deep-wiki/skills/wiki-qa/SKILL.md。
如何使用这个 Skill？
在已安装该技能的代码代理中提出具体代码库问题，例如：“这个代码库中的认证流程是如何工作的？相关函数在哪里定义？”首次回答前，需要提供源代码仓库 URL，或确认这是本地-only 仓库。