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.