<一句话说清『这个 skill 做什么 + 何时调用』。把最关键的触发场景放最前面。结尾给 2-3 个用户会说的关键词。>
The English summary is being prepared. Showing the original description.
amoslee2026/Babel49Updated Aug 4, 2026
FreePublished on GitHub
bb-search-protocol
在 wiki/protocols/ 搜索协议知识（UART/AXI4-Lite/UCIe 等），返回匹配的文档路径与摘要。触发场景：(1) bba-architect 写 PRD/MAS 时需查协议规格；(2) 显式 /bb-search-protocol。
The English summary is being prepared. Showing the original description.
See how to installFiles included (5)
- SKILL.md2.2 KB
- references/protocol_index.md639 B
- scripts/parse_results.py987 B
- scripts/render_search.py557 B
- scripts/run_search.py1.8 KB
SKILL.md (original)
Review the instructions the agent will receive before you install.
bb-search-protocol
职责
在项目 wiki/protocols/ 目录里按关键词搜索协议文档，返回匹配文件、行号、片段，供 bba-architect 用 Read 工具读取细节。
- 调用者：
bba-architect - 禁止使用：Task / Agent / Skill
Input Args
| arg | type | required | 默认 | 说明 |
|---|---|---|---|---|
| pattern | string | true | — | 关键词（uart / axi4 / ucie） |
| field | string | false | — | 限定字段（baud / timing） |
| max_results | int | false | 20 | 最多返回条数 |
Output Contract
| field | 值 |
|---|---|
artifact_path | — （inline 返回，不写文件） |
matches | [{file:path, line:int, snippet:str}] |
count | int |
valid | bool |
4-Phase 执行
Phase 1 — render_search_cmd
scripts/render_search.py 生成 rg 命令：
rg -i "<pattern>" wiki/protocols/ --include="*.md" -n -A 2 --max-count=<max_results>
如指定 field，叠加 && rg "<field>" 二次过滤。
Phase 2 — run_search
scripts/run_search.py：
timeout 30 bash -c "<cmd>" > /tmp/protocol_search_<stamp>.txt 2>&1- 解析 rg
file:line:content三段格式
Phase 3 — parse_results
scripts/parse_results.py：
- 每行
<file>:<line>:<content>→ 一条 match - 聚合相邻行作为 snippet
- 统计 count
Phase 4 — return
返回 JSON。调用方 (bba-architect) 据 file 列表 Read 详细内容补充 PRD。
收敛 / 失败
| 状态 | 行动 |
|---|---|
| count>0 | 有结果 |
| count==0 | 调用方放宽 pattern 重试；超 3 次记录 gap: <pattern> 入 MAS |
| rg 不可用 | 退到 grep -r |
MVP 覆盖
wiki/protocols/
├── uart.md
├── axi4-lite.md
└── ucie-overview.md (planned, not yet available)
资源索引
scripts/render_search.py、scripts/run_search.py、scripts/parse_results.pyreferences/protocol_index.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