bb-search-cbb

name	bb-search-cbb
description	在 wiki/cbb/ 搜索可复用 Common Building Block（sync-fifo / 2ff-sync / clock-gate 等），返回匹配模板路径。bba-architect 在 MAS 中识别复用组件时调用。触发场景：(1) bba-architect 拆分子模块识别 CBB；(2) 显式 /bb-search-cbb。
user-invocable	true

bb-search-cbb

职责

按 pattern 搜索 wiki/cbb/ 目录，输出可复用 CBB 列表。调用方据匹配进一步获取接口模板。

• 调用者：bba-architect
• 关联：bb-get-interface-template（获取详细接口）
• 禁止使用：Task / Agent / Skill

Input Args

arg	type	required	默认	说明
pattern	string	true	—	CBB 关键词（sync-fifo / 2ff / clock-gate）
max_results	int	false	10	最多返回条数

Output Contract

field	值
artifact_path	—
matches	[{cbb_name:str, file:path}]
count	int
valid	bool

4-Phase 执行

Phase 1 — render_search_cmd

rg -i "<pattern>" wiki/cbb/ --include="*.md" -l --max-count=<max_results>

Phase 2 — run_search

scripts/run_search.py：timeout 30 bash -c "<cmd>" > <out> 2>&1

Phase 3 — parse_cbb_list

scripts/parse_cbb_list.py：

• 每行一条文件路径 → 提取 basename 去 .md 作为 cbb_name
• 排序去重

Phase 4 — return

返回 JSON。bba-architect 据 cbb_name 调 bb-get-interface-template 取接口表。

收敛 / 失败

状态	行动
count>0	调用方进入接口模板提取
count==0	该子模块在 MAS 中标 reuse: none，需从头实现

MVP CBB 覆盖

wiki/cbb/
├── sync-fifo.md
├── 2ff-sync.md
└── clock-gate.md

资源索引

• scripts/render_search.py、scripts/run_search.py、scripts/parse_cbb_list.py
• references/cbb_catalog.md — CBB 一览（含参数/适用场景）