build-error-analyzer

Extract and classify OpenHarmony build errors from last_error.log.

31|6|Updated Jan 29, 2026
One-click install
npx skills add https://github.com/openharmonyinsight/openharmony-skills --skill build-error-analyzer-openharmonyinsight
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: build-error-analyzer
Source: https://github.com/openharmonyinsight/openharmony-skills/tree/main/skills/build-error-analyzer
Command: npx skills add https://github.com/openharmonyinsight/openharmony-skills --skill build-error-analyzer-openharmonyinsight

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

It helps you diagnose OpenHarmony build failures by extracting the latest error block into last_error.log and then mapping common error patterns to concrete, file-specific remediation steps.

Core Features & Use Cases

  • Latest log extraction workflow: Ensures analysis is based only on out/<product>/last_error.log (or out/sdk/last_error.log for SDK builds), avoiding stale errors from older logs.
  • Error pattern classification: Categorizes failures into linker errors (undefined symbols), compiler errors (CXX/CC), and build system (GN/Ninja) issues.
  • Historical case matching: Recommends fixes using the skill’s curated examples (e.g., missing .cpp in BUILD.gn/ace_core_ng_source_set, ACE_FORCE_EXPORT + libace.map export gaps, forward declaration/incomplete type issues).
  • Use Case: You just hit a SOLINK “undefined symbol” during ace_engine build and need to know whether the missing fix is adding sources to the correct BUILD.gn location, exporting symbols, or addressing template/visibility rules.

Quick Start

Provide your AI request as: Analyze last_error.log and recommend the exact code/build-system changes needed to fix the OpenHarmony build error without modifying files automatically.

Frequently Asked Questions about build-error-analyzer

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I analyze OpenHarmony build failures and find the root cause?

To analyze OpenHarmony build failures, the Skill extracts the latest error block from your build logs into last_error.log and classifies the root cause using known error signatures and historical cases. It identifies whether the issue stems from linker errors, compilation errors, or GN/Ninja build-system failures.

What causes undefined symbol linker errors during OpenHarmony ace_engine builds?

Undefined symbol linker errors during ace_engine builds are typically caused by missing .cpp files in BUILD.gn ace_core_ng_source_set, ACE_FORCE_EXPORT and libace.map export gaps, or template visibility issues. The Skill matches these historical patterns to recommend targeted file-path fixes.

How do I fix GN build configuration errors in OpenHarmony product builds?

To fix GN build configuration errors, the Skill maps the extracted error patterns from out/<product>/last_error.log to concrete remediation steps. It provides targeted file-path guidance for OpenHarmony build configuration adjustments without automatically modifying your files.

Does this OpenHarmony log analysis tool support SDK builds?

Yes, the log analysis workflow supports SDK builds by extracting errors specifically from out/sdk/last_error.log. It ensures analysis is based only on the latest error block, avoiding stale errors from older logs in both normal product builds and special SDK builds.

Why is my OpenHarmony build still failing after fixing the first reported error?

OpenHarmony builds may continue failing if older stale errors are analyzed instead of the latest error block. The Skill enforces strict log-source discipline by exclusively extracting the most recent error block into last_error.log to ensure accurate pattern-to-case matching and fix recommendations.

When do I need to update ACE_FORCE_EXPORT and libace.map for OpenHarmony build symbol exports?

You need to update ACE_FORCE_EXPORT and libace.map when the Skill detects linker errors related to symbol export gaps. It recognizes these specific historical cases and recommends the exact build-system changes needed to resolve the undefined symbol issues in your OpenHarmony build.