<一句话说清『这个 skill 做什么 + 何时调用』。把最关键的触发场景放最前面。结尾给 2-3 个用户会说的关键词。>
The English summary is being prepared. Showing the original description.
amoslee2026/Babel49Updated Aug 4, 2026
FreePublished on GitHub
bb-get-interface-template
读取指定 CBB / protocol wiki 文件，解析其 ## Interface / ## Ports section，返回结构化端口表 + 参数表。bba-architect 用于填入 MAS 模块接口。
触发场景：(1) bb-search-cbb 命中后取详细接口；(2) 显式 /bb-get-interface-template。
The English summary is being prepared. Showing the original description.
See how to installFiles included (4)
- SKILL.md2.2 KB
- references/wiki_section_conventions.md637 B
- scripts/locate_template.py852 B
- scripts/parse_md_tables.py1.0 KB
SKILL.md (original)
Review the instructions the agent will receive before you install.
bb-get-interface-template
职责
按 template_name 查 wiki/cbb/ 或 wiki/protocols/ 中对应 .md，提取 ## Interface / ## Ports 表格 → JSON。
- 调用者：
bba-architect - 上游：
bb-search-cbb/bb-search-protocol - 禁止使用：Task / Agent / Skill
Input Args
| arg | type | required | 默认 | 说明 |
|---|---|---|---|---|
| template_name | string | true | — | CBB 或协议名（sync-fifo/uart/axi4-lite） |
| section | string | false | interface | interface | ports | parameters |
Output Contract
| field | 值 |
|---|---|
artifact_path | — |
template_name | str |
source_file | path |
ports | [{name,direction,width,description}] |
parameters | [{name,default}] |
valid | bool |
error | string|null |
4-Phase 执行
Phase 1 — locate_template
scripts/locate_template.py：优先 wiki/cbb/<name>.md，其次 wiki/protocols/<name>.md；都不存在 → error="template not found: <name>"。
Phase 2 — read_md
Python 直接读取目标文件全文（无需 shell）。
Phase 3 — parse_md_tables
scripts/parse_md_tables.py：
- 用 markdown 解析定位
## Interface/## Ports/## Parameters标题 - 之后第一张表格按列名
name / direction / width / description解析为 list[dict] - 类似处理 Parameters 表
Phase 4 — return
返回 JSON。bba-architect 把 ports 写到 MAS 对应模块的 interface.ports。
收敛 / 失败
| 状态 | 行动 |
|---|---|
| valid=true | 写入 MAS |
| 文件不存在 | error="template not found" |
| Section 找不到 | error="section <name> not found" |
| 表格格式错 | error="malformed table"；fallback：返回原始 markdown |
资源索引
scripts/locate_template.py、scripts/parse_md_tables.pyreferences/wiki_section_conventions.md— wiki markdown 标题/表头约定
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