ArkWeb Vulnerability Intake

用于 arkweb-security-patch-issue-analyzer。

When to use this skill

Use this skill to parse local Chromium issue HTML/MHTML archives, issue links, CVE/security advisory text, Gerrit CLs, PRs, or commit messages into auditable issue analysis artifacts.

输入

• context.requirements 中的 issue / CVE / Chromium bug / Gerrit CL / PR / 安全公告链接。
• 已有 .ace-outputs/{runId} 报告或 .ace-outputs/{runId}/{issue_id}/ 目录。
• 本地 issue HTML/MHTML 归档目录，由 context.requirements 指定；未指定时可使用当前工作流给出的默认输入目录。

输出

写入每个 issue 独立目录：

• .ace-outputs/{runId}/{issue_id}/01_issue_analysis.md
• .ace-outputs/{runId}/{issue_id}/01_issue_analysis.json

如果一次处理多个 issue，必须从本阶段开始就拆成多个 {issue_id} 目录。根目录不得写任何文件；不得生成 01_issue_analysis.index.md/json，也不得生成根级 01_issue_analysis.md/json。

Detailed output structure is in references/issue-analysis-output.md.

字段归属边界：

• 本阶段必须填：Issue 基础字段、原始描述、上游修复 PR/CL 链接、修复事件审计、初步问题/修复摘要。
• 本阶段不得填最终值：修改文件列表、patch 本地路径、ArkWeb affected/unaffected 结论、责任田、特性树影响、是否建议保留。

Fix link extraction

Use semantic review of issue comments. Do not just regex all URLs. The extraction and deduplication rules are in references/fix-link-extraction.md.

Scripts

优先使用内置脚本解析本地 HTML/MHTML 归档，不要在运行时重新生成临时 Python 脚本：

python3 skills/arkweb-security-patch-intake/scripts/parse_local_issue_archive.py \
  --archive-dir <local_issue_archive_dir> \
  --project-root <context.codebase> \
  --output-root <context.projectRoot>/.ace-outputs/<runId>

脚本能力：

• 只读扫描 .html、.htm、.mhtml、.mht，并可读取 issue.zip 里的同类文件到输出目录临时区；
• 强制输出目录只能是 <context.projectRoot>/.ace-outputs/<runId>，不能写到 ~/.aceharness/runs/<runId>/outputs/.ace-outputs；context.projectRoot 是工作流输出根，真实 ArkWeb 源码根使用 context.codebase；
• 从 MHTML 中提取 HTML 正文，生成每个 issue 独立目录下的 01_issue_analysis.md/json；
• 按 fix-link 规则审计代码链接，区分 accepted fix、bug-introducing candidate 和普通 noise 链接；
• 只向 {issue_id} 子目录写产物，stdout 输出批量摘要，便于 agent 再做人工复核和补充。

如果脚本输出的 upstream_fix_prs[] 为空或 decision=review 较多，agent 再基于原始归档和审计表做语义复核；不要把脚本当成最终判断的唯一来源。

规则

• 不要臆造 CVE、commit 或文件路径。
• 对每个关键结论标注来源链接或来源文本。
• 无法访问外网时，明确写出阻塞原因和建议人工补充项。
• 本地 HTML/MHTML 原始文件只读，不要修改归档目录。
• 责任田和特性树只在本阶段读取作背景，不在本阶段做最终归属判定。