xuzhougeng/wisp-science/skills/bear-onboard/SKILL.md
bear-onboard
Review bear-onboard's use cases, installation, workflow, and original source instructions.
- Source repository stars
- 560
- Declared platforms
- 0
- Static risk flags
- 0
- Last source update
- 2026-07-28
- Source checked
- 2026-07-28
Decision brief
What it does—and where it fits
一个工作流:把概念版图(空间)和演化脉络(时间)同时摆出来,让你在最短的时间内建立对一个陌生领域的立体认知。单独看地图不知道哪个概念重要;单独看脉络不知道现在的技术版图长什么样。两者交叉,才能定位自己在哪里、该从哪里进入。
Not for
- Tasks that require unconfirmed production actions or broad system permissions.
- Environments where the pinned source and install steps cannot be inspected.
Compatibility matrix
Platform support, with evidence labels
| Platform | Status | Evidence | What to check |
|---|---|---|---|
| Codex | Not declared | No explicit evidence | Portability before use |
| Claude Code | Not declared | No explicit evidence | Portability before use |
| Cursor | Not declared | No explicit evidence | Portability before use |
| Gemini CLI | Not declared | No explicit evidence | Portability before use |
Installation
Inspect first. Install second.
The source command is displayed only when detected. A safe inspection prompt is always available so your agent can explain every action before execution.
npx skills add https://github.com/xuzhougeng/wisp-science --skill "skills/bear-onboard"Inspect the Agent Skill "bear-onboard" from https://github.com/xuzhougeng/wisp-science/blob/95d2c13d1665d46a388b5bdc998dcce0d5ec2eee/skills/bear-onboard/SKILL.md at commit 95d2c13d1665d46a388b5bdc998dcce0d5ec2eee. List every install step, command, network request, credential, file read/write, external action, and rollback step. Explain whether it fits my task. Do not install or execute anything until I approve.
Workflow
What the source asks the agent to do
- 01
步骤(固定顺序)
Step 0 — 确认 CLI 可用 运行 sci --version。未安装就给安装命令并停止;认证错误就提示 sci init 并停止。
Step 0 — 确认 CLI 可用 运行 sci --version。未安装就给安装命令并停止;认证错误就提示 sci init 并停止。Step 1 — 锚定领域,执行多维检索(概念版图侧) 以输入术语为中心概念,执行主检索(--mode low,--limit 20),再做至少 2 个补充检索(方法邻居、应用场景、对照概念等角度)。从摘要里挖出 5–8 个邻近概念,每个概念写出:它是什么(2–3 句)+ 与中心的连接(1 句)+ 支撑文献 ID。告知用户本次将执行约 8–10 次检索,然后直接开始,不等待确认。 - 02
输出物
检索结束后,在当前目录创建 {topic-slug}/ 子文件夹,输出四个东西:
终端 — 直接 print 综合摘要:枢纽节点列表 + 贯穿问题 + 推荐入门路径report.md — 稳定 YAML front matter + 综合判断 + 枢纽节点说明 + 概念邻接表(含 Mermaid 图)+ 传承链 + 推荐阅读顺序 + 检索透明度report.html — 综合报告,见下方 HTML 规范 - 03
HTML 报告规范
强调色 0891b2(青,bear-map 同色系,体现"认知地图"的延伸)。
概念名 + 标注"概念版图中的角色"和"传承脉络中的位置"是什么(2–3 句实质性描述)为什么是枢纽(1 句:它在版图和脉络里都扮演关键角色)
Permission review
Static risk signals and limitations
No configured static risk pattern was detected
This is not proof of safety. Runtime behavior, indirect dependencies, and hidden external systems are outside the static scan.
Evidence record
Why each signal appears
| Signal | Value | Evidence type | Meaning |
|---|---|---|---|
| Quality score | 66/100 | Computed | Documentation, specificity, maintenance, and trust rules |
| Repository stars | 560 | Source | Repository attention, not individual Skill quality |
| Compatibility | 0 platforms | Source | Declared in the catalog source record |
| Usage guide | catalog record | Editorial | Generated or reviewed according to the visible evidence level |
Pinned source
Provenance and original SKILL.md
- Repository
- xuzhougeng/wisp-science
- Skill path
- skills/bear-onboard/SKILL.md
- Commit
- 95d2c13d1665d46a388b5bdc998dcce0d5ec2eee
- License
- AGPL-3.0
- Collected
- 2026-07-28
- Default branch
- main
View the original SKILL.md
bear-onboard · 领域快速入门
一个工作流:把概念版图(空间)和演化脉络(时间)同时摆出来,让你在最短的时间内建立对一个陌生领域的立体认知。单独看地图不知道哪个概念重要;单独看脉络不知道现在的技术版图长什么样。两者交叉,才能定位自己在哪里、该从哪里进入。
先读 references/sci-cli.md——CLI 检测步骤、用法和铁律。
再读 references/output-system.md——HTML 外壳规范和设计 token。
步骤(固定顺序)
Step 0 — 确认 CLI 可用
运行 sci --version。未安装就给安装命令并停止;认证错误就提示 sci init 并停止。
Step 1 — 锚定领域,执行多维检索(概念版图侧)
以输入术语为中心概念,执行主检索(--mode low,--limit 20),再做至少 2 个补充检索(方法邻居、应用场景、对照概念等角度)。从摘要里挖出 5–8 个邻近概念,每个概念写出:它是什么(2–3 句)+ 与中心的连接(1 句)+ 支撑文献 ID。
告知用户本次将执行约 8–10 次检索,然后直接开始,不等待确认。
Step 2 — 锚定演化脉络,执行溯源检索(脉络侧) 以同一术语为主题,先找当前标志性工作作为锚点,再逐层向前追溯(默认 3 层),最后补充近 1–2 年的最新进展。每条传承边标注关系类型(方法来源 / 问题来源 / 证据来源 / 领域转折)。
Step 3 — 交叉识别枢纽节点 对比两侧的检索结果,找出同时出现在概念版图和演化脉络中的概念——这些是枢纽节点,是理解这个领域最优先需要掌握的概念。枢纽节点通常既是地图上的核心邻居,也是脉络上的关键转折点。
Step 4 — 综合判断 基于两侧检索结果写 2–4 句入门框架描述:这个领域的核心问题是什么、现在的技术版图围绕什么展开、进入这个领域最好从哪个枢纽节点开始。不做"这个领域好不好"的价值判断。
输出物
检索结束后,在当前目录创建 {topic-slug}/ 子文件夹,输出四个东西:
- 终端 — 直接 print 综合摘要:枢纽节点列表 + 贯穿问题 + 推荐入门路径
report.md— 稳定 YAML front matter + 综合判断 + 枢纽节点说明 + 概念邻接表(含 Mermaid 图)+ 传承链 + 推荐阅读顺序 + 检索透明度report.html— 综合报告,见下方 HTML 规范references.bib— 合并所有 query 的.bib,去重后只保留报告引用的文献
HTML 报告规范
强调色 #0891b2(青,bear-map 同色系,体现"认知地图"的延伸)。
首屏:综合判断面板
.verdict-title:这个领域一直在回答的贯穿问题是什么
.verdict-note:入门框架 2–4 句——核心问题是什么、现在版图的主干是什么、从哪里进入最高效
.metric-strip:邻近概念数 / 传承节点数 / 枢纽节点数 / 推荐入门文献数
枢纽节点面板(首屏下方,最重要的 section)
列出 2–4 个枢纽节点,每个枢纽节点卡片包含:
- 概念名 + 标注"概念版图中的角色"和"传承脉络中的位置"
- 是什么(2–3 句实质性描述)
- 为什么是枢纽(1 句:它在版图和脉络里都扮演关键角色)
- 建议阅读的代表文献 DOI 链接
详细内容区(两个 tab)
tab「概念版图」:SVG 概念星图(中心节点青色填充,邻居节点白底青色边框,带关系标签),星图下方每个邻居有完整说明卡片(是什么 2–3 句 + 与中心连接 1 句)。枢纽节点在星图中用 stroke-width: 3; stroke: var(--accent) 加粗边框区分,说明卡片加 .card-primary class。
tab「演化脉络」:竖向传承时间轴,每个节点突出转折点,末尾三张 summary cards(贯穿问题 / 开放边缘 / 检索缺口)。枢纽节点在时间轴中加星形标记。
两个 tab 中的文献卡片均含 DOI 链接和中文学术摘要折叠。
推荐阅读顺序(底部独立 section):3–5 篇,说明为什么按这个顺序读、每篇解决哪个认知缺口。
检索透明度(底部):列出所有查询词、mode、返回数、采用数、检索缺口。
诚实边界
枢纽节点是基于本次检索结果的交叉,不是完整领域的权威分类。检索覆盖有限,脉络链可能存在缺口。入门框架是对检索结果的提炼,不是对领域的完整评价。
Gotchas
- 枢纽节点不能强行凑数:如果两侧检索结果没有真正的交叉概念,如实说"本次检索未发现明确枢纽节点",分别推荐各侧权重最高的概念作为入门起点
- 概念版图和脉络的检索对象必须是同一个术语:不要在版图侧搜一个宽泛领域、在脉络侧搜一篇具体论文
- 综合判断要基于两侧检索内容,不要只写概念版图侧的感受