Skip to content

spec-app-consistency-audit

审查移动 App 在 PRD、Figma、本地 source、路由、架构、analytics 和 i18n 之间的一致性。

ASCII 链路图

text
Codebase -> Spec -> Plan -> Tasks -> Code -> Review -> Knowledge
                                                |
                                                v
                                                spec-app-consistency-audit
                                                entry: spec-app-consistency-audit
                                                type: workflow command

基本信息

字段内容
Skillspec-app-consistency-audit
类型workflow command
研发链路位置Review
当前入口spec-app-consistency-audit
兼容别名/spec:app-consistency-audit、$spec-app-consistency-audit
Sourceskills/spec-app-consistency-audit/SKILL.md
Governancesrc/cli/contracts/dual-host-governance/skills-governance.json(supported-host skills governance)

描述

Audit mobile App PRD/Figma/local-source consistency across page routes, KMP/Clean Architecture, components, analytics, i18n, engineering quality, and industry lenses before runtime validation; use for cross-source App consistency, not ordinary code review, PRD authoring, build/test execution, UI polish, or product-code edits.

Source 契约摘要

When To Use

Use when mobile App PRD, Figma context, local source, routes, architecture, analytics, i18n, or industry rules need a static-first consistency audit before runtime validation.

When Not To Use

Do not use for ordinary code review (spec-code-review), PRD authoring or refinement (spec-prd), pure test/lint/build/runtime execution, UI polish (spec-polish), formatting-only changes, or product-source edits.

Inputs

Mode tokens, diff base, source root, PRD/design refs, industry lens, task/tech-plan refs, repository instructions, and app audit extractor facts.

Outputs

Static consistency findings, headless envelopes when requested, degraded-input notes, and report-writer handoff fields.

Artifacts

Headless/default runs may write .spec-first/app-audit/runs/<run-id>/ artifacts; report-only mode writes no run artifacts.

Failure Modes

Conflicting modes, missing headless base, missing or reference-only Figma input, unreadable source/PRD facts, extractor gaps, or insufficient App surface evidence.

Workflow

Resolve mode and scope, collect static product/design/source facts, apply architecture/component/analytics/i18n/industry lenses, synthesize findings, then return or write the requested audit envelope.

Downstream Consumers

移动 QA planning、App implementation owner、report-writer step,以及准备 runtime validation 的人工审查者。

何时使用

  • 移动 App 运行时验证前需要静态一致性审查。
  • PRD / Figma / implementation 之间可能漂移。
  • KMP 或 Clean Architecture 边界需要复核。

工作步骤

  • 读取 diff、PR、文档、计划、task pack 或专项审查输入。
  • 按风险域选择 always-on 与 conditional reviewer personas。
  • 合并、去重和校准 findings,区分 safe_auto、gated_auto、manual 和 advisory。
  • 输出修复、残留风险或下一步处理建议。

输出

  • review findings、safe_auto fixes、residual risks、audit report 或 release checklist。
  • 当 reviewer dispatch 不可用时,输出明确的 report-only fallback 覆盖说明。

Agent 调度

  • 这是 persona agents 的主要使用层:correctness、testing、security、performance、scope、design 等按证据触发。
  • review workflow 自身负责任务边界、合成和最终判断。

本 skill 当前没有 skill-local references/agentsreferences/personas 文件;默认由 orchestrator 直接完成,或按阶段需要临时调用其他 skill 的专家。

边界

  • 不替代模拟器、真机、测试或 QA。
  • 输出 audit artifact,不默认修改业务代码。

源码校准

  • 本页由 website/scripts/generate-skill-detail-pages.js 从上游 source skill 生成。
  • 当前入口、兼容别名与宿主投递 metadata 来自 src/cli/contracts/dual-host-governance/skills-governance.json
  • 当 source skill 或 governance contract 变化后,应重新运行 npm run reference:pages 并执行 npm run content:audit