bb-spec-review

Review PRD, arch_spec, and MAS documents for consistency and feasibility gaps.

41|9|Updated May 22, 2026
One-click install
npx skills add https://github.com/amoslee2026/Babel --skill bb-spec-review
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: bb-spec-review
Source: https://github.com/amoslee2026/Babel/tree/main/.claude/skills/bb-spec-review
Command: npx skills add https://github.com/amoslee2026/Babel --skill bb-spec-review

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

跨文档规格评审,确保 PRD、arch_spec、MAS 之间的一致性、完整性与实现可行性,降低设计阶段的风险与返工成本。

Core Features & Use Cases

  • 跨文档对抗性评审,揭示矛盾、缺失需求与边界不清的问题。
  • 输出带严重性等级的问题清单,并确保追溯到对应的需求和阶段。
  • 用例:架构师在 MAS 草案完成后,使用 bb-spec-review 进行对照检查,确保文档的一致性和可验证性。

Quick Start

在 Claude Code 中提供 PRD.md、arch_spec 目录与 MAS 目录作为输入,然后触发 bb-spec-review 以获取完整的评审报告。

Frequently Asked Questions about bb-spec-review

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

FAQPage Schema
How do I check consistency between a PRD and architecture spec?

Adversarial spec review identifies completeness, consistency, and feasibility gaps by cross-validating your PRD and architecture spec, ensuring traceability and alignment with acceptance criteria across design stages.

What is cross-document spec review for traceability?

Cross-document spec review validates that requirement IDs flow correctly across PRD, arch_spec, and MAS documents, ensuring traceability and alignment with acceptance criteria and verification plans.

How do I perform an adversarial review of PRD and MAS documents?

Provide PRD, arch_spec, and MAS directories as inputs to trigger an adversarial review that outputs a severity-ranked issue list, revealing missing requirements and unclear boundaries for architecture refinement.

Does spec review work for architecture refinement and verification planning?

Spec review supports architecture refinement and verification planning by applying adversarial checks across design stages, ensuring documents remain consistent, complete, and verifiable against acceptance criteria.

What is the best way to find missing requirements in an arch_spec?

The best way to find missing requirements in an arch_spec is to run an adversarial review against the PRD and MAS, which outputs actionable issues with severity levels to highlight incomplete or untraceable design gaps.

Why do I need adversarial review for software design documents?

You need adversarial review for software design documents to lower design phase risks and rework costs by proactively identifying contradictions, missing requirements, and boundary ambiguities before implementation begins.