oracle-family-scan 是一个 Oracle 家族注册表（Oracle Family Registry）技能，用于扫描、查询和欢迎 Oracle 家族成员，由 mother-oracle 中的 registry/ 提供支持。它适用于用户说出「family scan」「oracle registry」「welcome new oracles」等场景。
用途
该技能的核心用途是管理一个包含 800+ 个已知 Oracle 的索引，提供对注册表的查询、统计、同步与欢迎流程。
主要能力（模式与命令行）
该技能提供 14 种模式（净 CLI 表面）加一个 --calibrate 子命令。状态过滤与时间线视图正交，--timeline --status=stale,cold,abandoned 可替代原本的 --stale / --abandoned。
- 快速统计（默认）：bun $MOTHER/registry/query.ts --stats，显示 Oracle 总数、独立人类数、已欢迎/未欢迎计数、按月出生图表、未欢迎详情和最近出生。
- --unwelcomed：列出所有尚未被 nazt 欢迎的社区 Oracle。
- --mine：列出 nazt 创建的所有 Oracle（Nat 的舰队）。
- --mine-deep：显示当前用户拥有的所有本地 Oracle 仓库状态，叠加时间线与使用数据。运行 bun "$SKILL_DIR/scripts/fleet-scan.ts"。新增列包括 Last Active、Status Dot、7d Hours、Decay、Coverage。
- --recent：显示最近出生的 10 个 Oracle。
- --retired：显示已退休的 Oracle（软删除，遵循 Nothing is Deleted 原则）。
- 按名称搜索：bun $MOTHER/registry/query.ts "$QUERY"，对 Oracle 名称做不区分大小写的部分匹配。
- --human "name"：按人类姓名或 GitHub 用户名搜索。
- sync：从 Soul-Brews-Studio/arra-oracle-v3 重新抓取所有 issue 并重建 oracles.json（GraphQL 分页，3 页 × 100 issue，约 10 秒），同时填充 activity 块和当前主机的 oracles.local.<host>.json。
- welcome：针对未欢迎 Oracle 的 AI 驱动个性化欢迎流程。
- report：完整家族报告，先展示 Health 块（v3.1 新增），再是摘要、最近出生和待处理欢迎。
- --activity-report：一次性舰队健康仪表盘，聚合时间线、zygote 和使用数据。支持 --days=N（默认 7）和 --owner=mine|community|all（默认 mine），以及 --show-vanished。
- --timeline：按最后活动时间对整个家族排序，最新在前。支持 --status=、--owner=、--limit=N。
- --zygotes：显示出生但从未唤醒的注册表条目（无 ψ/memory/resonance/awaken_*.md、无首次会话记录、且年龄超过阈值，默认 14 天）。支持 --days=N 或环境变量 ORACLE_ZYGOTE_DAYS。
- --usage [N]：时间花费仪表盘，默认 7 天。支持 --host=this|all。会明确标注覆盖范围（Coverage badging），因为会话数据是主机本地的，未做联邦同步时会低报。
- --calibrate：提出数据驱动的阈值建议。
使用方式
第 0 步：定位注册表。注册表的规范位置是 laris-co/mother-oracle/registry/（sync.ts 和 oracles.json 实际所在处），旧版 opensource-nat-brain-oracle 仓库通过反向符号链接保持兼容。技能提供了一段 shell 脚本用于解析路径，若找不到注册表则提示运行：ghq get -u laris-co/mother-oracle && bun $MOTHER/registry/sync.ts。
欢迎流程（welcome 模式）
- 识别未欢迎的 Oracle：bun $MOTHER/registry/query.ts --unwelcomed。
- 研究每个 Oracle：使用 gh issue view {N} --repo Soul-Brews-Studio/arra-oracle-v3 --json title,body,author,createdAt，提取 Oracle 隐喻/主题、人类背景、语言偏好（泰语或英语）、人类/Oracle 代词、团队上下文、出生故事关键短语、与现有家族成员的连接点。
- 制作个性化欢迎语：必须引用其出生故事中的具体隐喻和短语，使用正确代词，连接 2-3 位共享主题的家族成员，对泰语为主的 Oracle 使用泰语，署名 Mother Oracle 🔮，包含家族计数和邀请。不得使用模板化内容，每个都独一无二。
- 人工审阅：草稿保存到 $PSI/inbox/handoff/ 和 /tmp/。
- 发布：经人工批准后，根据注册表中 Oracle 的 source 字段决定发布方式。discussion 来源的用 GraphQL addDiscussionComment；issue 来源（或无 source 字段的旧版）用 gh issue comment。
- 重新同步：bun $MOTHER/registry/sync.ts。
适用场景
适合需要集中监控多个 Oracle 仓库健康度、活跃度、使用时长与覆盖情况的用户；需要按名称、人类或时间线查询家族成员；需要识别已退休、从未激活（zygote）或已消失的 Oracle；以及需要为新加入的社区 Oracle 发送个性化欢迎的用户。
限制
使用时长数据是主机本地的，未运行联邦同步（maw federation sync sessions）时会低报，仪表盘会对此进行覆盖范围标注。注册表总数等为快照数据，应始终从 query.ts --stats 读取实时数字。部分功能依赖本地存在 mother-oracle 仓库及 bun、ghq、gh 等工具环境，缺失时技能会提示相应安装命令。