spec-app-consistency-audit
审查移动 App 在 PRD、Figma、本地 source、路由、架构、analytics 和 i18n 之间的一致性。
ASCII 链路图
Codebase -> Spec -> Plan -> Tasks -> Code -> Review -> Knowledge
|
v
spec-app-consistency-audit
entry: spec-app-consistency-audit
type: workflow command基本信息
| 字段 | 内容 |
|---|---|
| Skill | spec-app-consistency-audit |
| 类型 | workflow command |
| 研发链路位置 | Review |
| 当前入口 | spec-app-consistency-audit |
| 兼容别名 | /spec:app-consistency-audit、$spec-app-consistency-audit |
| Source | skills/spec-app-consistency-audit/SKILL.md |
| Governance | src/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/agents 或 references/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。
