arkweb-spec-review

Review ArkWeb design documents for structural completeness and technical feasibility.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes assets (resource) components.

What problem does it solve?

ArkWeb 设计文档容易因结构不完整、术语不一致、接口与图表联动缺失、可行性不足而反复返工;该 Skill 将文档按固定标准做系统评审,帮助尽早发现阻塞项并输出可落地的修改清单。

Core Features & Use Cases

  • 完整性/一致性/技术可行性/DFX/规范与接口设计的结构化评审(含 33 项 Checklist 检视)
  • 支持多种运行模式:Subagent 模式(推荐)、交互模式、最小化检视闭环(检视→修改→复审→提 PR)
  • 通过交叉验证(设计文档与 ace_engine/web-webview 的分析结果、类名/接口签名/文件路径)降低遗漏与偏差
  • 生成统一评审报告与产出物(用于推动设计文档修改闭环)
  • 适用场景:ArkWeb 需求/Spec 评审、架构与接口设计一致性检查、上线前质量门禁与提 PR 依据沉淀

Quick Start

运行 arkweb-spec-review 并在 task 中提供待评审文档路径、代码分析结果路径与参考资料路径以生成评审报告并给出“通过/需修改/不通过”的结论。

Frequently Asked Questions about arkweb-spec-review

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

FAQPage Schema
How do I review OpenHarmony ArkWeb design documents for structural completeness and consistency?▼

Reviewing OpenHarmony ArkWeb design documents requires a checklist-based gatekeeping process to validate structural completeness, cross-document consistency, and technical feasibility. This generates a detailed checklist result table, identifies blocking items, and produces a saved review report.

What is cross-document consistency validation in ArkWeb spec reviews?▼

Cross-document consistency validation in ArkWeb spec reviews ensures design documents align with ace_engine and web-webview analyses. It cross-validates class names, interface signatures, and file paths to reduce omissions and deviations across related requirement and design artifacts.

How do I run an ArkWeb spec validation workflow to check technical feasibility and DFX requirements?▼

Running an ArkWeb spec validation workflow involves providing the design document path, code analysis results path, and reference materials path. It applies a 33-item checklist covering feasibility and DFX, ultimately outputting a pass, needs-modification, or fail conclusion.

Can I use a design review checklist to establish a quality gate before submitting an ArkWeb PR?▼

A design review checklist can establish a quality gate before submitting an ArkWeb PR by running a minimized review loop of inspection, modification, and re-inspection. This ensures documents meet interface design and DFX standards, providing concrete justification for PR submission.

Why does my ArkWeb design document need repeated revisions for missing interface and chart linkages?▼

ArkWeb design documents need repeated revisions when structural completeness, terminology consistency, and interface-chart linkages are insufficient. Applying a systematic 33-item spec validation checklist identifies these blocking items early to minimize rework loops.

What is the best way to perform an OpenHarmony ArkWeb requirement and design review?▼

Performing an OpenHarmony ArkWeb requirement and design review is best handled via a Subagent mode that systematically evaluates structural completeness and technical feasibility. It produces a unified review report to drive the design document modification loop.