<一句话说清『这个 skill 做什么 + 何时调用』。把最关键的触发场景放最前面。结尾给 2-3 个用户会说的关键词。>
The English summary is being prepared. Showing the original description.
amoslee2026/Babel49Updated Aug 4, 2026
FreePublished on GitHub
bb-spec-review
对规格文档（PRD + arch_spec + MAS）做对抗性评审：完整性 / 一致性 / 可实现性 / 验证覆盖。默认 role=ruthless（规格阶段错误成本最高）。在 MAS frozen 前调用。
触发场景：(1) bba-architect 写完 MAS；(2) 显式 /bb-spec-review。
The English summary is being prepared. Showing the original description.
See how to installFiles included (5)
- SKILL.md2.9 KB
- references/spec_review_dimensions.md917 B
- scripts/build_prompt.py960 B
- scripts/parse_spec_review.py782 B
- scripts/run_review.py1.1 KB
SKILL.md (original)
Review the instructions the agent will receive before you install.
bb-spec-review
职责
跨文档检查 PRD ↔ arch_spec ↔ MAS 一致性、可实现性、验证覆盖；输出严重程度分级 issues。
- 调用者：
bba-architect - 关联：
bb-challenge-code（通用） - 禁止使用：Task / Agent / Skill
Input Args
| arg | type | required | 默认 | 说明 |
|---|---|---|---|---|
| prd_path | path | true | — | PRD.md |
| arch_spec_dir | path | true | — | arch_spec 目录 |
| mas_dir | path | true | — | spec_mas/（directory containing MAS markdown files） |
| role | enum | false | ruthless | ruthless|linus|balanced |
| focus | string | false | feasibility,consistency,coverage | — |
| design_name | string | true | — | — |
| stamp | string | false | <auto> | — |
Output Contract
| field | 值 |
|---|---|
artifact_path | designs/<name>/spec_review_<stamp>.md |
issues_found | int |
severity_summary | {critical,high,medium,low} |
consistency_issues | list[str] |
feasibility_issues | list[str] |
coverage_issues | list[str] |
pass | bool（critical==0 && high≤2） |
valid | bool |
4-Phase 执行
Phase 1 — build_prompt
prd = open(prd_path).read()
arch = {p.name: p.read_text() for p in Path(arch_spec_dir).glob("*.md")}
mas = {p.name: p.read_text() for p in Path(mas_dir).glob("*.md")}
prompt = render_spec_review_prompt(role, focus, prd, arch, mas)
Phase 2 — run_review
claude --print "<prompt>" > <artifact_path> 或 agent 内部生成。15 min timeout（文档可能很长）。
Phase 3 — parse_spec_review
scripts/parse_spec_review.py：
- 提
## Consistency/## Feasibility/## Coverage段 - 计 severity
pass = (critical == 0 && high <= 2)
Phase 4 — return
返回 JSON。pass=false → bba-architect 修 MAS（≤2 iter），仍失败 → escalate 用户。
维度
| 维度 | 检查 |
|---|---|
| consistency | PRD FR ↔ arch module ↔ MAS FSM 三层一致 |
| feasibility | 频率/面积/PDK 能力匹配 |
| coverage | verif_plan_seed 完整、corner 覆盖 |
| ambiguity | 模糊描述、边界缺失 |
通过标准
| 级别 | 通过 |
|---|---|
| critical | == 0 |
| high | ≤ 2 |
收敛 / 失败
| 状态 | 行动 |
|---|---|
| pass=true | frozen MAS + 开 ready-for-rtl |
| pass=false & iter<2 | bba-architect 修 MAS 重评 |
| iter≥2 | escalate 用户 |
资源索引
scripts/build_prompt.py、scripts/run_review.py、scripts/parse_spec_review.pyreferences/spec_review_dimensions.md
Reviews
No reviews yet. Tell others what you thought.
Comments
No login needed. Share how it worked for you, ask a question, or note where it did not run.
No comments yet. Be the first to write one.
More skills from this repository
bb-arch
Free从粗略 idea 设计芯片或功能模块架构，输出专业架构文档到 spec_arch 目录。Trigger: 芯片架构设计, IC架构, 电路模块设计, 硬件架构. Generate IC/Chip architecture specification from rough ideas.
The English summary is being prepared. Showing the original description.
amoslee2026/Babel49Updated Aug 4, 2026
bb-check-cdc
Free基于 AST 检查 CDC/RDC 违例：对比 MAS clock_domains 找跨域信号，检查是否被 2ff-sync CBB 保护。触发场景：(1) bba-guru-synthesis 综合前；(2) 显式 /bb-check-cdc。
The English summary is being prepared. Showing the original description.
amoslee2026/Babel49Updated Aug 4, 2026
bb-check-lint
Free调用 babel-lsp / verible-verilog-lint 检查 SV 源码。src 必须可综合（零 syntax error），tb 允许 verification constructs。发现 src error 时自动修复重检（max 3 iter）。触发：(1) bba-guru-rtl 生成后；(2) RTL 修复重检；(3) 显式 /bb-check-lint。
The English summary is being prepared. Showing the original description.
amoslee2026/Babel49Updated Aug 4, 2026
bb-close-issue
FreeBabel internal issue protocol — close a handoff after downstream agent picked it up or user signed off. Moves designs/<name>/.handoff/<label>.md to .handoff/closed/ (using mv per CLAUDE.md), appends to handoff_log.jsonl.
The English summary is being prepared. Showing the original description.
amoslee2026/Babel49Updated Aug 4, 2026
bb-code-review
Free对抗性代码评审：代码质量 / 可维护性 / 时序风险 / 综合友好度 / MAS 对齐度。默认 ruthless 模式，找 EVERY flaw。触发场景：(1) RTL lint 后；(2) 显式 /bb-code-review。
The English summary is being prepared. Showing the original description.
amoslee2026/Babel49Updated Aug 4, 2026