infocard-source-routing-decision-tree
Route non-X infocard sources before subagent dispatch.
- License 许可
- MIT
- 最近更新
- 2026-11-12
- Stars
- ★ 2
- Forks
- 1
01 前言 Front Matter
- name
- infocard-source-routing-decision-tree
- author
- Hermes Agent
- license
- MIT
- version
- 1.0.0
- metadata
- { "hermes": { "tags": [ "infocard", "source-routing", "decision-tree", "youtube", "video", "web-article", "paper" ], "related_skills": [ "infocard-publish-sop", "infocard-mobile-verifier" ] } }
- description
- Route non-X infocard sources before subagent dispatch.
02 资源文件 1
03 SKILL.md 正文
Infocard source routing decision tree
Trigger
Use this skill before any Research A subagent dispatch or publish-bundle.json write, whenever the user provides a source URL that is NOT https://x.com/i/status/....
All infocard work stays in the current main checkout. This routing skill performs source classification only; it never creates, enters, removes, or recommends a Git worktree or clone. Authoring remains under .docs/<run-id>/<slug>/, and any promotion or publication is owned by infocard-publish-sop and its Publisher flow.
The protocol's default entry path assumes an X post: status URL → author + timestamp + body extractable in one fetch. Non-X sources break that assumption in three places:
- Topic detection is harder. X post body text is captured immediately. A YouTube watch URL exposes only the page HTML; the orchestrator must first extract the title and decide if the topic matches any in-flight card. Failing this check is the 2026-08-02 incident: a 20-min YouTube video about Graph Engineering was misclassified as an AutoResearch follow-up because its
t=952stimestamp was associated with an AutoResearch card earlier in the session. - Evidence shape is different. X posts are first-class sources with display name, handle, timestamp, and media. YouTube videos produce a single content blob (title + description + transcript) without those structured fields.
- Author / timestamp attribution. The
expected_public_identityfield in the v3 bundle normally names an X account. For YouTube it must name the channel.
Entry routing decision tree
Source URL provided
│
├─ x.com/i/status/<id> → existing X source flow, no change
│
├─ github.com/<owner>/<repo> → existing source-fallback-github.md flow
│
├─ youtu.be / youtube.com → YouTube video flow (this file)
│ 1. Extract metadata from ytInitialPlayerResponse
│ 2. Topic-detect BEFORE author delegation
│ 3. Reject "looks related to last card" without
│ explicit title / description evidence
│
├─ arxiv.org/abs/<id> → Paper flow (TODO: future contribution)
│
├─ news.ycombinator.com/item?id → HN discussion flow (TODO: future contribution)
│
└─ other web URL → Generic web article flow
(blog post, podcast transcript, etc.)
YouTube source extraction recipe
# 1. Fetch the watch page with a normal desktop User-Agent
curl -sL "https://www.youtube.com/watch?v=$VIDEO_ID" \
-A "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36"
# 2. Extract title, duration, publish date from the embedded JSON blob
python3 -c "
import sys, re, json
h = sys.stdin.read()
m = re.search(r'var ytInitialPlayerResponse = (\{.+?\});', h)
d = json.loads(m.group(1))
micro = d.get('microformat',{}).get('playerMicroformatRenderer',{})
print('title:', micro.get('title',{}).get('simpleText',''))
print('lengthSeconds:', micro.get('lengthSeconds',''))
print('publishDate:', micro.get('publishDate',''))
print('description:', (micro.get('description',{}).get('simpleText','') or '')[:2000])
"
Caption retrieval (optional but useful for chapter detection)
# 3a. Find the caption base URL (it is signed and time-limited)
python3 -c "
import sys, re, json
h = sys.stdin.read()
m = re.search(r'var ytInitialPlayerResponse = (\{.+?\});', h)
d = json.loads(m.group(1))
for tr in d.get('captions',{}).get('playerCaptionsTracklistRenderer',{}).get('captionTracks',[]):
print(tr.get('languageCode'), tr.get('baseUrl','')[:300])
"
# 3b. Fetch the captions
curl -sL "<caption-baseUrl>&fmt=srv3&lang=zh-Hans" -A "Mozilla/5.0"
Pitfall: caption URLs include a signed signature= parameter and an expire timestamp. After a few minutes the URL returns 404. If caption fetch 404, do not retry the same URL — re-fetch the watch page and extract a fresh caption URL.
Topic detection gate (the lesson from 2026-08-02)
Symptom: User supplied https://m.youtube.com/watch?v=8RedSkw1UjE&t=952s (a 20-min Graph Engineering video by 大飞说科技 / 最佳拍档). I read the URL and associated the t=952s timestamp with an AutoResearch card from earlier in the session, dispatched Research A + worktree + bundle, and only discovered the actual title 「什么是图工程」several minutes into the run.
Hard rule: Before any research delegation, verify the current main checkout, then fetch the source and report the title + description + topic in one line. Worktrees and temporary clones are prohibited. If the title disagrees with the assumed topic, stop and re-discuss with the user — do not let momentum push you into an off-topic run.
Concrete check that fits in a single turn:
curl -sL "$URL" -A "Mozilla/5.0" | python3 -c "
import sys, re
h = sys.stdin.read()
m = re.search(r'<meta property=\"og:title\" content=\"([^\"]+)\"', h) or \
re.search(r'<meta name=\"title\" content=\"([^\"]+)\"', h) or \
re.search(r'<title>([^<]+)</title>', h)
print('TITLE:', m.group(1) if m else 'NONE')
m = re.search(r'<meta property=\"og:description\" content=\"([^\"]+)\"', h)
print('OG_DESC:', m.group(1)[:300] if m else 'NONE')
"
If TITLE: NONE, the URL did not fetch successfully — fix the fetch before continuing. If the title is empty / generic ("YouTube"), the request was routed to a different domain.
Bundle shape adjustments for video sources
{
"identity": {
"slug": "graph-engineering",
"title": "图工程(Graph Engineering):AI 智能体架构从 Loop 到 Graph 的范式迁移",
"expected_public_identity": "Graph Engineering (视频解读)"
},
"requirements": {
"source_type": "youtube-video",
"source_url": "https://m.youtube.com/watch?v=8RedSkw1UjE&t=952s",
"channel": "大飞说科技 / 最佳拍档",
"publish_date": "2026-08-02",
"duration_seconds": 1211,
"key_timestamps": {"952s": "视频后段 · Graph 拓扑 / 验证器"}
}
}
The meta.yaml source field should be youtube-video (not x-post). Card section 01 should be re-labelled VIDEO IDENTITY instead of PROJECT IDENTITY, with 频道 / 时长 / 发布日 / 关键时间戳 as the four headline cards.
When to recommend "skip the card"
After metadata extraction, refuse to publish when the source is:
- A 3-minute intro video with no real content
- A paywalled article with no abstract
- A paper with no accessible PDF
Do not auto-publish. Report the access boundary in one line and ask the user to provide an alternative source. Do not pad with L3 community speculation.
Web-article fallback (when the source is neither X, GitHub, nor YouTube)
Same pre-flight gate applies:
# Fetch the article
curl -sL "$URL" -A "Mozilla/5.0" > /tmp/source.html
# Extract: title, author byline (look for <meta name="author">),
# published date (look for <meta property="article:published_time">),
# description (og:description)
python3 -c "
import re
h = open('/tmp/source.html').read()
for prop in ['og:title', 'twitter:title', 'title']:
m = re.search(rf'<meta (?:property|name)=\"{prop}\" content=\"([^\"]+)\"', h)
if m: print(f'{prop}:', m.group(1)); break
for prop in ['og:description', 'twitter:description', 'description']:
m = re.search(rf'<meta (?:property|name)=\"{prop}\" content=\"([^\"]+)\"', h)
if m: print(f'{prop}:', m.group(1)[:300]); break
m = re.search(r'<meta name=\"author\" content=\"([^\"]+)\"', h)
if m: print('author:', m.group(1))
m = re.search(r'<meta property=\"article:published_time\" content=\"([^\"]+)\"', h)
if m: print('published:', m.group(1))
"
For arXiv papers: prefer https://arxiv.org/abs/<id> (HTML, easier to parse) over the PDF. og:title is usually the full title, <meta name="citation_author" content="..."> repeats for each author.
References
references/non-x-source-extraction-recipes.md— concrete curl + python snippets for YouTube, arXiv, podcast transcripts, and paywall-aware news sites
Deprecated compatibility entry
此旧入口仅作兼容转发,替代入口为 infocard-source-and-content。来源分类结果必须写入统一 source pack,不得自行分发 Author 或发布。
04 同仓库更多 Skills
authorized-infocard-execution
Use for authorized infocard runs after tool failures.
web-capture
Use when a web page needs screenshots or device simulation. Capture desktop, mobile, and tablet screenshots via agent-browser and return auditable image paths.
infocard-x-content-tracing
X content to upstream project/author tracing.
infocard-visual-pass-loop
Screenshot-and-fix loop when 200 passes but theme is broken.
infocard-topic-selection
Use when selecting or evaluating information-card topics from the user's profile or explicitly supplied themes; judge value and visual expression potential without choosing a concrete infocard theme or publishing.
infocard-theme-validation
Use when changing infocard theme CSS or pushing docs.