bb-list-issues

name	bb-list-issues
description	Babel internal issue protocol — list open handoffs by label. Scans designs/*/.handoff/*.md (filtered by label) and best-effort merge with gh issue list. Used by all guru/architect agents at startup to pick up work.

bb-list-issues

Inputs

• --label <label> (optional) — filter; absent = all
• --design-name <name> (optional) — filter; absent = all designs
• --limit <int> (optional, default 20) — max returned
• --include-fixed (flag) — include closed handoffs from .handoff/closed/

Output Contract

field	值
issues	[{design_name, label, artifact, correlation_id, file, ts}]
count	int
valid	bool

4-Phase 执行

Phase 1 — scan_fs

调 Bash：

PATTERN="designs/*/.handoff/*.md"
[ -n "<label>" ] && PATTERN="designs/*/.handoff/<label>.md"
[ -n "<design-name>" ] && PATTERN="designs/<design-name>/.handoff/*.md"
find . -path "./$PATTERN" -type f 2>/dev/null | sort -r | head -n "<limit>"

Phase 2 — parse_md_frontmatter

调 Read 工具读每个匹配 md，按 - timestamp: / - artifact: / - correlation_id: 提字段。filename basename 即 label。

Phase 3 — gh_merge (best-effort)

if command -v gh >/dev/null 2>&1 && [ -n "<label>" ]; then
  gh issue list --label "<label>" --limit "<limit>" --json number,title,url 2>/dev/null
fi

合并 fs + gh 结果，按 ts 倒序。

Phase 4 — return

返回 JSON。count == 0 时返回 {issues:[], count:0, valid:true}。

用法示例

Skill(bb-list-issues, args="--label ready-for-rtl --limit 5")
Skill(bb-list-issues, args="--design-name uart")