SuperAPI AI 工具集

arkweb-code-analysis

编程与开发

查看项目

更新于 10-15 18:03

技能介绍

用途

arkweb-code-analysis 用于分析 ArkWeb 代码仓库并生成代码索引。它可作为独立 subagent 被 arkweb-architect 调用,也可在主 session 中直接调用,帮助理解仓库结构、定位相关代码,并输出结构化索引文档供后续 design-doc 和 spec-review 调用。触发词:分析代码仓库、生成代码索引、理解仓库结构。

运行模式

模式 A:Subagent 模式(推荐):作为独立 subagent 被 arkweb-architect 调用时,从 task 描述中获取需求关键词和知识库证据包,结合 DeepWiki 在线索引与本地分析文档,输出结构化代码索引。输入从 task 描述中解析,包含需求关键词、分析范围(如 ace_engine 的 Web 组件相关代码、web_webview 的 NWeb API 相关代码、chromium_src 的内核相关代码)以及知识库证据包。输出为分析文档(保存到指定路径)并回复关键发现。

模式 B:交互模式:在主 session 中直接调用,由用户指定仓库和分析目标。

分析数据源

数据源按优先级分层:

  1. oh-chromium-knowledge 知识库:读取流程有严格顺序,必须先读 index.json(全局路由入口,含 14 个仓库索引),再依次读取 search/by_feature.json(按需求类型定位,35 个功能特性)、search/by_module.json(20 个模块)、repos/chromium_src/arkweb_adapter/routing_table.json(代码路径映射,29 个需求类型)、repos/chromium_src/modules/components.json(17 个核心组件)、repos/chromium_src/arkweb_adapter/ohos_dirs.json(OHOS 适配目录,43 个)、repos/chromium_src/arkweb_adapter/nweb_service.json(NWeb 接口映射)、repos/{repo}/architecture.md(各仓库架构文档)。禁止一次性读取所有 repos/ 下文件、禁止跳过 Step 1、禁止把知识库当源码。覆盖范围包括 Tier 1(chromium_src、chromium_cef、chromium_third_party、chromium_chrome、chromium_v8、chromium_third_party_skia)、Tier 2(ffmpeg、angle、devtools_frontend、webrtc、blink_webtests、dawn、pdfium)、Tier 3(chromium_arkweb)。

  2. oh-ai-full-design 知识库:仓库 openharmony-ai-design/oh-ai-full-design(GitCode 私有),用于鸿蒙组件体系检索(子系统/部件/API/SystemCapability),与 oh-chromium-knowledge 互补。读取流程为 index.json、search/by_keyword.json、subsystems/{subsystem}.json、components//.json、apis//.json(按需)。私有仓库无权限时跳过。

  3. DeepWiki MCP(在线索引增强):通过 OpenCode MCP 调用 DeepWiki API,无需浏览器渲染。MCP 配置需在 opencode.json 中设置 remote 类型及 url https://mcp.deepwiki.com/mcp。提供 3 个工具:read_wiki_structure(获取仓库文档主题列表,参数 repoName)、read_wiki_contents(查看仓库文档内容,参数 repoName + topic)、ask_question(AI 问答,参数 repoName + question)。覆盖仓库包括 openharmony/arkui_ace_engine、openharmony/web_webview、OpenHarmony-TPC/chromium_src、OpenHarmony-TPC/chromium_cef、OpenHarmony-TPC/chromium_third_party。调用策略为先用 read_wiki_structure 获取主题概览,再用 read_wiki_contents 读取详细文档,最后用 ask_question 精准搜索类定义、方法签名、调用链路等;对 chromium_src 优先搜 Blink 命名空间的类。MCP 不可用时降级为浏览器方式(使用 agent-browser skill 打开 DeepWiki 页面)。

  4. 本地分析文档(复用):包括 analysis/arkweb-ace-engine-analysis.md(Web 组件完整索引)、analysis/web-webview-analysis.md(NWeb API 索引)、analysis/chromium-arkweb-analysis.md(内核分析)、analysis/chromium-cef-analysis.md(CEF 层分析)。使用方式为 grep 检索关键词。

  5. 克隆仓库(兜底):当 DeepWiki 和本地文档都无法覆盖时,使用 git clone --depth=1 命令克隆,路径为 {DOCS_REPO}/tmp/{repo}。

使用方式

流程分为 7 步:Step 1 进行 oh-chromium-knowledge 知识库检索(读 index.json、匹配 by_feature.json、获取推荐文件列表、读 routing_table.json 路径映射,涉及 OHOS 适配时读 ohos_dirs.json 和 nweb_service.json,涉及特定组件时读 components.json);Step 2 进行 DeepWiki MCP 查询(确定仓库、调 read_wiki_structure、read_wiki_contents、ask_question,对多关键词重复查询并合并);Step 3 本地文档补充(搜索关键词、补充文件路径与行号等细节);Step 4 合并分析;Step 5 证据包持久化(强制 Write 到 {DOCS_REPO}/tmp/,须包含每个数据源的原始检索结果而非仅摘要);Step 6 生成分析文档;Step 7 输出。

生成的分析文档结构包含:数据源、相关文件清单(文件/路径/职责/与本需求的关系)、关键类和接口(类-结构/文件/方法-字段/说明)、调用链路、现有相关逻辑、技术可行性评估(方案/涉及的现有代码/可行性/风险点)。

产出物与适用场景

产出物路径为 {DOCS_REPO}/analysis/YYYY-MM-DD-{feature}-analysis.md。Subagent 模式回复格式包含完成标记、文档路径、数据源统计和关键发现摘要(相关文件数、核心类数、关键接口、调用链路、潜在风险)。适用于 OpenHarmony ArkWeb 相关代码仓库分析、代码索引生成和仓库结构理解场景。

限制

本 skill 的具体收费、价格、平台限制等事实资料未提供;知识库为索引性质,具体实现需查看实际代码仓库;oh-ai-full-design 为私有仓库,无权限时跳过;DeepWiki MCP 不可用时需降级为浏览器方式。