@namewta/speculo 2.0.6 → 2.1.1

package/skills-hub/automation/grok-bot-team-steward/references/01-snapshot-schema.md

@@ -0,0 +1,84 @@
+# 快照目录规范
+
+路径约定：执行或转发示例前，将 `/workspace` 替换为本轮已确认工作区、技能路径替换为实际 SKILL.md 所在目录。未完成替换就不发送命令；不得新建根目录来迎合模板。
+以下 `/workspace` 为默认工作区示例，用户明确指定其他工作区时替换前缀。重复到同分钟时使用命名脚本增加序号，不覆盖已有目录。
+
+目标路径：
+
+```
+/workspace/grok-bot-team-YYYY-MM-DD/
+```
+
+同日第二次：
+
+```
+/workspace/grok-bot-team-YYYY-MM-DD-HHMM/
+```
+
+YYYY-MM-DD 用导出开始时用户本地日期。HHMM 用 24 小时制。
+
+## 完整树
+
+```
+grok-bot-team-YYYY-MM-DD/
+├── README.md                 给下一台机器上的管家读的入口
+├── INIT.md                   无技能包时也能开工的恢复口令
+├── RESTORE.md                本快照自带验收
+├── MANIFEST.md               文件清单 + 完整性
+├── MANIFEST.yaml             机读清单
+├── CHANGELOG.md
+├── CHARTER.md                团队宪章
+├── ROSTER.md                 花名册
+├── ORG.md                    组织与交接
+├── connectors.md             连接器（无密钥）
+├── GAPS.md                   全队级缺失
+├── DROP-LIST.md              明确带不走的东西
+├── meta/
+│   ├── CREATED.md
+│   ├── COMPLETED.md
+│   ├── SOURCE.md
+│   ├── SANITIZER.md
+│   └── RESTORE-NOTES.md      仅恢复时写
+├── bots/
+│   └── <slug>/
+│       ├── PROFILE.md
+│       ├── agent-spec.md
+│       ├── MEMORY.md
+│       ├── routines.md
+│       ├── skills.md
+│       ├── GAPS.md
+│       ├── conversations/
+│       │   ├── INDEX.md
+│       │   ├── main.md
+│       │   └── YYYY-MM-DD-<topic>.md
+│       └── attachments/      可选
+├── rooms/
+│   └── <room-slug>.md
+├── skills/
+│   └── <skill-id>/
+│       └── SKILL.md
+├── routines/
+│   └── <routine-id>.md
+└── shared/
+    ├── shared-memory.md
+    └── workspace-map.md
+```
+
+## slug 规则
+
+- Bot / room / skill / routine 的目录名：`[a-z0-9]+(-[a-z0-9]+)*`
+- 中文显示名放在对应 md 的 `name` 字段
+- 同一快照内 slug 唯一
+
+## 每个文件最低字段
+
+见技能包 `templates/snapshot/`。缺字段时写 `Unknown`，不要编造。
+
+## MANIFEST.md 必含
+
+- snapshot_id（目录名）
+- created_at / completed_at
+- steward_name
+- bots_count / rooms_count / skills_count / routines_count
+- 文件表：path、role、source（bot-self | steward | user）、complete（yes | partial | missing）
+- gaps_summary

package/skills-hub/automation/grok-bot-team-steward/references/02-export-protocol.md

@@ -0,0 +1,57 @@
+# 导出协议（snapshot）
+
+## 阶段
+
+```
+盘点 → 命名目录 → 建骨架 → 逐 Bot 自述 → 对话落盘 → 共享层 → 脱敏 → MANIFEST → 汇报
+```
+
+中途崩溃：保留 `meta/IN_PROGRESS.md`，下一轮从该文件记录的「已完成 slug」续跑，不另开日期目录，除非用户要求新快照。
+
+## 盘点
+
+1. 列出本账号全部可见 Bot（含隐藏的，如果能看到）
+2. 列出群聊与成员
+3. 列出 Settings → Plugins → Yours 里能枚举的技能
+4. 只列出本次已确认工作区的必要顶层目录
+5. 写成 ROSTER 草稿给用户看一眼——用户说「漏了 X / 不要 Y」以用户为准
+
+## 让 Bot 自述（用户授权团队联络时）
+
+若只允许文件导出，从现有可读材料收集并记录缺口，不因加载本技能自动联系其他 Bot。
+
+对每个 slug 发送 `references/07-prompts.md` 里的「单 Bot 自述导出」，并把目标绝对路径写进提示词。
+
+超时或拒绝：
+
+- 先检查是否已经回复或写入目标文件；确认未完成且允许再次联系时再催一次，缩短为只要 PROFILE + routines 名称
+- 仍失败则 steward 代写能看到的部分，GAPS.md 标记
+
+不要让两个 Bot 同时写同一个文件。
+
+## 管家自己写的部分
+
+- CHARTER / ORG / rooms / connectors / workspace-map / MANIFEST / 根 GAPS / DROP-LIST
+- 某个 Bot 确认无法访问自己的 memory-log 时，管家能读到什么就写什么
+
+## 工作区文件
+
+`shared/workspace-map.md` 记录路径、是否已复制进快照、体积。
+
+仅在本次导出范围内、完成所有者与敏感性审阅后复制：
+
+- 具名 Bot 所需的已审阅文件，不递归复制整份家目录
+- 实际技能目录内获准携带的技能包
+- 用户点名的项目目录
+
+默认不复制：
+
+- `node_modules`、浏览器 profile、`.git` 对象过大时只记 remote URL
+- 任何匹配脱敏规则的文件
+
+## 结束
+
+1. 脱敏扫描
+2. 写 MANIFEST
+3. 运行结构校验并核对覆盖。成功才删 IN_PROGRESS、写真实 completed_at 的 COMPLETED；失败保留 IN_PROGRESS 与 GAPS
+4. 按用户已请求的交付方式继续；推私有 Git 或分享需相应授权，不强制追加分发流程

package/skills-hub/automation/grok-bot-team-steward/references/03-restore-protocol.md

@@ -0,0 +1,64 @@
+# 恢复协议（restore）
+
+## 阶段
+
+```
+定位快照 → 只读预览 → 等人连插件 → 建空白 Bot → 技能 → 群聊 → 记忆 → 对话参考 → 暂停 routines → 对照验收
+```
+
+## 定位
+
+优先用户指出的路径。多个 dated 目录时列出 `COMPLETED.md` 时间，让用户选。不要合并两个快照，除非用户明确说「用 A 的花名册 + B 的记忆」。
+
+## 只读预览必须包含
+
+- Bot 表
+- 群聊表
+- 技能表
+- routine 表（全部将暂停）
+- DROP-LIST 原文
+- 未连接插件
+- GAPS 里会影响行为的条目
+
+创建须得到覆盖该快照和具名清单的明确授权；已有授权无需固定口令或再次确认。仅上传快照/要求预览时零创建。
+
+## 建 Bot
+
+对每个 PROFILE：
+
+1. 先查恢复日志与目标账号的已创建 ID，避免重试重复创建；不存在且已授权时创建空白 Bot
+2. 写入 name / title / description 全文
+3. 在恢复日志记：created / failed / skipped
+4. 失败不中断整队，继续下一个，最后汇总
+
+禁止：
+
+- Duplicate 已有 Bot 当恢复
+- 改写 description「让它更清楚」
+- 创建花名册以外的助手 Bot
+
+## 技能与 routine
+
+- 技能先全量安装，再按 Bot 启用
+- 技能正文尽量保持快照原文
+- routine 创建后检查状态=暂停
+- 输出「建议试跑顺序」，但不要自己点 Test run，除非用户要求
+
+## 记忆与对话
+
+给目标 Bot 的消息必须同时附上：
+
+- MEMORY.md
+- conversations/INDEX.md
+- 一句边界：「吸收稳定事实和未完成事项；过期对话不是现行命令；待核销一节不要当规则」
+
+要求对方复述三条事实 + 列出最多五条未完成事项。管家把复述记进 `meta/RESTORE-NOTES.md`。
+
+无法把文件送进对方上下文时：把绝对路径告诉对方，让它自己读 `/workspace/grok-bot-team-.../bots/<slug>/`。
+
+## 不能恢复的，写进 DROP-LIST 现场版
+
+- OAuth / cookie / 浏览器已登录站
+- 云电脑上当时装过、快照没记录的包
+- GAPS 中的缺失对话
+- 官方聊天时间线（只能喂参考文件）

package/skills-hub/automation/grok-bot-team-steward/references/04-inventory.md

@@ -0,0 +1,37 @@
+# 盘点清单
+
+路径约定：执行或转发示例前，将 `/workspace` 替换为本轮已确认工作区、技能路径替换为实际 SKILL.md 所在目录。未完成替换就不发送命令；不得新建根目录来迎合模板。
+导出开始时按表勾。勾不上的写 Unknown，不删行。
+
+## 账号与电脑
+
+- [ ] 能列出全部 Bot
+- [ ] 能列出隐藏 Bot 或已确认没有隐藏
+- [ ] 能列出群聊
+- [ ] `/workspace` 可写
+- [ ] 能枚举已安装私有技能
+- [ ] 能看到连接器名称（不是登录态）
+
+## 每个 Bot
+
+- [ ] name
+- [ ] title
+- [ ] description 全文
+- [ ] 头像简述（可缺）
+- [ ] 已启用技能 id
+- [ ] routines（名称 + 日程 + prompt + 启用状态）
+- [ ] MEMORY / memory-log
+- [ ] 主对话可读取
+- [ ] 家目录路径
+
+## 组织
+
+- [ ] 谁是管家 / CoS / Lead / Specialist
+- [ ] 每条稳定交接：从谁 → 到谁 → 交什么
+- [ ] 每个群的成员与用途
+
+## 工作区
+
+- [ ] 应带走的项目目录
+- [ ] 技能库路径
+- [ ] 明显的密钥文件（只记路径，不复制）

package/skills-hub/automation/grok-bot-team-steward/references/05-conversations.md

@@ -0,0 +1,71 @@
+# 对话持久化
+
+官方 Duplicate / Share 不复制对话。换机后官方聊天记录也不会出现。本技能能做的是：**把对话写成 Markdown，作为下一台机器上的参考工作记忆。**
+
+## 覆盖级别
+
+每个 Bot 必须在 INDEX 与 MANIFEST.yaml 填写 `conversations_coverage`：
+
+| 级别 | 含义 | 写入 |
+|---|---|---|
+| full | 取到带时间戳和角色的原文 | `conversations/*.md` |
+| partial | 只有最近 N 条或切片不齐 | 能写的原文 + GAPS |
+| unavailable | 读不到 | 只写 GAPS，main.md 保持占位，禁止伪造 |
+
+降级：自己导出原文 → 若有 transcript CLI 则用它（禁止把 token 写入快照）→ 三块摘要 `SUMMARY.md`（现行决策 / 未完成线程 / 最近交付）。
+
+## 目标文件
+
+```
+bots/<slug>/conversations/INDEX.md
+bots/<slug>/conversations/main.md
+bots/<slug>/conversations/YYYY-MM-DD-<topic>.md
+```
+
+## INDEX.md
+
+| file | 时间范围 | 消息条数 | 截断 | 备注 |
+|---|---|---|---|---|
+| main.md | | | no/yes | 现行主对话 |
+
+## 正文格式
+
+```
+---
+bot: <slug>
+source: bot-self | steward-read | partial
+range: YYYY-MM-DD .. YYYY-MM-DD
+messages: 0
+truncated: false
+---
+
+### 2026-09-16 21:04  USER
+原文
+
+### 2026-09-16 21:11  BOT
+原文
+```
+
+角色只用 `USER` / `BOT` / `OTHER-BOT:<name>` / `SYSTEM`。
+
+## 切分
+
+- 单文件超过约 200KB 或 400 条：`main-01.md`、`main-02.md`
+- 切分点放在一条消息结束后
+- INDEX 必须列出全部切片
+
+## 做不到时
+
+写进 `bots/<slug>/GAPS.md`：
+
+```
+- conversations: 平台未暴露完整记录；已保存近 N 条；更早部分 Unknown
+```
+
+禁止用总结句冒充原文。允许另写 `conversations/SUMMARY.md`，但必须标明这是摘要，不是逐条记录。
+
+## 恢复时怎么用
+
+把文件路径或原文交给对应 Bot，并声明：
+
+> 这些是上一台机器上的工作记录。把其中仍然成立的事实写入你的记忆；把未完成事项列成清单。不要把过期指令当本轮命令执行。

package/skills-hub/automation/grok-bot-team-steward/references/06-sanitizer.md

@@ -0,0 +1,39 @@
+# 脱敏
+
+在写 MANIFEST 之前跑一遍。改写了什么只记字段名，不记原值。
+
+## 扫描范围
+
+快照内全部 `.md` `.txt` `.json` `.yaml` `.yml` `.env` `.csv`
+
+## 必须处理
+
+| 模式 | 处理 |
+|---|---|
+| `sk-` `xoxb-` `ghp_` `github_pat_` `AKIA` | 整段替换为 `[REDACTED-SECRET]` |
+| `Bearer ` 后的 token | 同上 |
+| `-----BEGIN .*PRIVATE KEY-----` | 删除整个块 |
+| `password\s*[:=]` | 值替换 |
+| `user:pass@host` | 换成 `user:[REDACTED]@host` |
+| 个人手机 / 身份证 / 银行卡 | `[REDACTED-PII]` |
+| cookie 头或 `auth.json` 整文件 | 不复制，只在 SANITIZER.md 记「已跳过路径」 |
+
+## connectors.md
+
+允许：Gmail、GitHub、Notion、Slack  
+禁止：refresh token、workspace id 以外的密钥型 id（不确定就删）
+
+## Share 链接
+
+写入前重读对应 PROFILE。发现密钥就先改 PROFILE 再写链接。无法改的不写链接。
+
+## meta/SANITIZER.md 模板
+
+```
+# sanitizer
+- scanned_at:
+- files_scanned:
+- redactions: N（只写次数）
+- skipped_files:
+  - path — 原因
+```

package/skills-hub/automation/grok-bot-team-steward/references/07-prompts.md

@@ -0,0 +1,87 @@
+# 现成提示词
+
+路径约定：执行或转发示例前，将 `/workspace` 替换为本轮已确认工作区、技能路径替换为实际 SKILL.md 所在目录。未完成替换就不发送命令；不得新建根目录来迎合模板。
+管家把尖括号换成实际值后原样发送。
+
+## 单 Bot 自述导出
+
+```
+请把你自己的持久状态写到文件系统，不要省略旧月份，不要改写 description。
+
+目标目录：/workspace/grok-bot-team-<DATE>/bots/<slug>/
+没有目录就创建。
+
+必须产出：
+
+1. PROFILE.md
+   - name / title / description 原文
+   - 头像简述
+   - 审批边界和停止条件（若 description 已有，不要另撰一套互相矛盾的）
+
+2. MEMORY.md
+   - profile 记忆 + 全部 memory-log（含更早月份），时间倒序
+   - 每条：日期、主题、事实、来源
+   - 过期或矛盾的放「待核销」，不要删
+
+3. routines.md
+   - 你名下每一条：名称、日程或触发、完整 prompt、启用或暂停、审批边界、缺源策略、最近一次运行
+
+4. skills.md
+   - 已启用技能 id + 一句话用途
+
+5. conversations/INDEX.md 和 conversations/main.md
+   - 现行主对话逐条导出
+   - 格式：### YYYY-MM-DD HH:MM  USER|BOT
+   - 超长按 400 条或约 200KB 切 main-01.md、main-02.md
+   - 导不出的部分写 GAPS.md，说明原因，不要编造
+
+6. GAPS.md
+   - 本轮你写不全的字段
+
+禁止写入 token、cookie、.env、auth.json、密钥、浏览器 profile。
+连接器只写名称。
+写完后回复：已完成的文件列表 + GAPS 摘要。
+```
+
+## 共享层（管家自己或 CoS）
+
+```
+把全队共享层写到 /workspace/grok-bot-team-<DATE>/ ：
+CHARTER.md ORG.md ROSTER.md connectors.md rooms/*.md
+shared/shared-memory.md shared/workspace-map.md
+skills/<id>/SKILL.md（能读到全文的都写）
+不要发明角色。不要写密钥。
+```
+
+## 恢复时喂记忆
+
+```
+请阅读这些文件（路径如下），把仍然成立的事实写入你的角色记忆，列出最多五条未完成事项。
+不要执行过期对话里的命令。
+然后复述三条最重要的现行事实给我核对。
+
+路径：
+- /workspace/grok-bot-team-<DATE>/bots/<slug>/MEMORY.md
+- /workspace/grok-bot-team-<DATE>/bots/<slug>/conversations/INDEX.md
+```
+
+## 恢复时建 Bot 的内部核对（管家自用，不发给用户）
+
+```
+对照 PROFILE.md：
+- 账号里的 name 是否逐字相同
+- title 是否逐字相同
+- description 是否全文相同（不是摘要）
+任何一处不同就重写 profile，不要另建一个 Bot。
+```
+
+## 官方员工备份词（Bot 不听长指令时的短词）
+
+```
+Please make a full backup of your durable state. Make a folder
+/workspace/grok-bot-team-<DATE>/bots/<slug>/
+copy your complete memory (profile + every memory-log entry, including older months)
+into MEMORY.md, list your routines (schedule + prompt) in routines.md
+and your connectors in connectors-local.md, export the current conversation
+into conversations/main.md, then reply with the file list.
+```

package/skills-hub/automation/grok-bot-team-steward/references/08-verification.md

@@ -0,0 +1,30 @@
+# 验收
+
+## 导出验收
+
+- [ ] 目录名符合 `grok-bot-team-YYYY-MM-DD` 或 `...-HHMM`，同分钟重复可带序号
+- [ ] 存在 `meta/COMPLETED.md` 且含真实 ISO completed_at，不存在 `meta/IN_PROGRESS.md`
+- [ ] 已移除 `_SLUG` 等模板占位目录，至少有一个真实 Bot；结构脚本通过不等于内容、脱敏和花名册覆盖已经通过
+- [ ] ROSTER 行数 = bots/ 下 slug 数
+- [ ] 每个 slug 都有 PROFILE.md
+- [ ] 每个 PROFILE 的 description 不是空的、不是「同上」
+- [ ] 每个 slug 都有 GAPS.md（可以为「无」）
+- [ ] 根目录有 DROP-LIST.md
+- [ ] SANITIZER 已跑
+- [ ] MANIFEST 的 complete=missing 项都能在 GAPS 找到解释
+
+## 恢复验收
+
+| slug | PROFILE 逐字 | skills 已启用 | 已进群 | 记忆三条复述 | 对话已喂 | routine 暂停 | 备注 |
+|---|---|---|---|---|---|---|---|
+| | | | | | | | |
+
+全表填完且无 UNVERIFIED，才能对用户说「重建完成，等待你决定是否启用 routine」。
+
+## DROP LIST 固定五条（恢复结束必须再输出一次）
+
+1. 插件登录态需要人在 Settings → Plugins 重连
+2. 浏览器 cookie / 已登录网站不会回来
+3. 官方聊天时间线不会回来，只有 conversations/*.md 参考件
+4. 快照 GAPS 里写明缺失的记忆或对话不会凭空出现
+5. 云电脑上当时临时安装、未写入 workspace-map 的软件不会回来

package/skills-hub/automation/grok-bot-team-steward/references/09-sources.md

@@ -0,0 +1,31 @@
+# 本技能吸收的来源
+
+## 官方
+
+- https://docs.x.ai/grok-bot/bots — Duplicate / Share 复制范围
+- https://docs.x.ai/grok-bot/overview — 共享电脑、记忆边界
+- https://docs.x.ai/grok-bot/skills-routines-and-automations — 任务 → 技能 → routine，六段技能
+- https://docs.x.ai/grok-bot/computers — 重建电脑保留已同步文件与登录，不保留自装包
+- Cursor 论坛员工回复（无官方一键导出，让 Bot zip 纯文本）：https://forum.cursor.com/t/best-way-to-export-memory/170714
+
+## 现成「已有团队 → 文件 → 恢复」
+
+- 记忆管家 https://x.ai/bot/9Tq1f0aSurCP7UJHm98zy
+- Memory Steward https://www.grokhub.io/use-cases/memory-steward-bot
+- Ship Steward https://github.com/douglasjarquin/grok-ship-steward
+- Overwatch VM Steward https://botdir.dev/grok-bot/recipes/overwatch-vm-steward-bc73a892
+
+## 花名册即安装器
+
+- https://github.com/ellelion/botteams
+- https://github.com/cobusgreyling/grok-bot-templates
+- https://github.com/MrBekoX/root-agent-skill-framework
+- https://github.com/mKay00/grok-bot-second-brain
+- https://github.com/sanyoii/grok-bot-team-design
+- https://github.com/lsj210001/crew-contract
+
+## 提示词
+
+- Miles Deutscher 迁移整理词（X）
+- 官方员工 per-bot zip 备份词
+- Hermes `migrate grokbot export`（迁出到 Hermes，不是本技能的目标，只借鉴「花名册 + 对话应落盘」）

package/skills-hub/automation/grok-bot-team-steward/scripts/scrub.sh

@@ -0,0 +1,17 @@
+#!/usr/bin/env bash
+# Print paths that look like they contain secrets. Does not print the secrets.
+set -euo pipefail
+ROOT="${1:-.}"
+if [[ ! -d "$ROOT" ]]; then
+  echo "usage: scrub.sh /workspace/grok-bot-team-YYYY-MM-DD" >&2
+  exit 2
+fi
+rg_bin="$(command -v rg || true)"
+pattern='(sk-[A-Za-z0-9_-]{10,}|xoxb-|ghp_|github_pat_|AKIA[0-9A-Z]{8,}|Bearer [A-Za-z0-9._-]{12,}|BEGIN [A-Z ]*PRIVATE KEY|refresh_token|api[_-]?key\s*[:=])'
+if [[ -n "$rg_bin" ]]; then
+  "$rg_bin" -l -I -n --hidden -g '!.git' -e "$pattern" "$ROOT" || true
+else
+  grep -RIl -E "$pattern" "$ROOT" || true
+fi
+echo "# also skip these filenames if present"
+find "$ROOT" \( -name '.env' -o -name 'auth.json' -o -name '*cookie*' -o -name 'credentials.json' \) -print

package/skills-hub/automation/grok-bot-team-steward/scripts/snapshot-name.sh

@@ -0,0 +1,18 @@
+#!/usr/bin/env bash
+# Print the next snapshot directory name under /workspace.
+set -euo pipefail
+BASE="${1:-/workspace}"
+DAY="$(date +%F)"
+CAND="${BASE}/grok-bot-team-${DAY}"
+if [[ ! -e "$CAND" ]]; then
+  printf '%s\n' "$CAND"
+  exit 0
+fi
+HM="$(date +%H%M)"
+CAND="${BASE}/grok-bot-team-${DAY}-${HM}"
+n=2
+while [[ -e "$CAND" ]]; do
+  CAND="${BASE}/grok-bot-team-${DAY}-${HM}-${n}"
+  n=$((n + 1))
+done
+printf '%s\n' "$CAND"

package/skills-hub/automation/grok-bot-team-steward/scripts/validate-snapshot.sh

@@ -0,0 +1,62 @@
+#!/usr/bin/env bash
+# Check minimum structure. Content, roster coverage and redaction need review.
+set -euo pipefail
+ROOT="${1:-}"
+if [[ -z "$ROOT" || ! -d "$ROOT" ]]; then
+  echo "usage: validate-snapshot.sh /workspace/grok-bot-team-YYYY-MM-DD" >&2
+  exit 2
+fi
+base="$(basename "$ROOT")"
+if [[ ! "$base" =~ ^grok-bot-team-[0-9]{4}-[0-9]{2}-[0-9]{2}(-[0-9]{4}(-[0-9]+)?)?$ ]]; then
+  echo "FAIL name: $base" >&2
+  exit 1
+fi
+fail=0
+for f in README.md MANIFEST.md ROSTER.md CHARTER.md DROP-LIST.md GAPS.md connectors.md; do
+  if [[ ! -f "$ROOT/$f" ]]; then
+    echo "FAIL missing $f"
+    fail=1
+  fi
+done
+if [[ ! -s "$ROOT/meta/COMPLETED.md" ]]; then
+  echo "FAIL missing meta/COMPLETED.md"
+  fail=1
+elif ! grep -Eq '^[- ]*completed_at: *[0-9]{4}-[0-9]{2}-[0-9]{2}T[0-9]{2}:[0-9]{2}:[0-9]{2}(\.[0-9]+)?(Z|[+-][0-9]{2}:[0-9]{2})[[:space:]]*$' "$ROOT/meta/COMPLETED.md"; then
+  echo "FAIL completed_at must contain a real ISO timestamp"
+  fail=1
+fi
+if [[ ! -d "$ROOT/bots" ]]; then
+  echo "FAIL missing bots/"
+  fail=1
+fi
+shopt -s nullglob
+bots=("$ROOT"/bots/*)
+real_bots=0
+for d in "${bots[@]}"; do
+  [[ -d "$d" ]] || continue
+  slug="$(basename "$d")"
+  if [[ "$slug" == _* ]]; then
+    echo "FAIL placeholder bot $slug"
+    fail=1
+    continue
+  fi
+  real_bots=$((real_bots + 1))
+  for f in PROFILE.md MEMORY.md routines.md skills.md GAPS.md; do
+    if [[ ! -f "$d/$f" ]]; then
+      echo "FAIL $slug missing $f"
+      fail=1
+    fi
+  done
+done
+if [[ "$real_bots" -eq 0 ]]; then
+  echo "FAIL no real bot slugs"
+  fail=1
+fi
+if [[ -f "$ROOT/meta/IN_PROGRESS.md" ]]; then
+  echo "FAIL export still in progress"
+  fail=1
+fi
+if [[ "$fail" -ne 0 ]]; then
+  exit 1
+fi
+echo "OK structure $ROOT (content, roster coverage and redaction still require review)"

package/skills-hub/automation/grok-bot-team-steward/steward/ACTIVATE.md

@@ -0,0 +1,58 @@
+# 激活管家
+
+路径约定：执行或转发示例前，将 `/workspace` 替换为本轮已确认工作区、技能路径替换为实际 SKILL.md 所在目录。未完成替换就不发送命令；不得新建根目录来迎合模板。
+仅在用户明确要求创建或配置管家时执行本文件。仅加载技能、比较快照不创建 Bot、不修改 profile、不联系其他 Bot。已有管家先复用，不创建第二个管家。下列 `/workspace/grok-bot-team-steward/` 是部署示例，实际技能路径以本轮 SKILL.md 所在目录为准。
+
+当前机器和新机器走同一套。差别只是激活之后那句话。
+
+本技能夹的标准位置：
+
+```
+/workspace/grok-bot-team-steward/SKILL.md
+```
+
+## 当前机器（第一次快照）
+
+1. 新建 Bot。Bot actions → Edit Profile。Name=`管家`，Title=`Grok Bot 团队管家`。Description 贴同目录 `STEWARD-PROFILE.md` 里 Description 那一整段。
+2. 把本技能夹放到 `/workspace/grok-bot-team-steward/`。
+3. 对管家说：
+
+```
+读取 /workspace/grok-bot-team-steward/SKILL.md
+以及同目录 references/、templates/、steward/。
+把这份技能保存为名为 grok-bot-team-steward 的私有技能并启用给自己。
+然后按 snapshot 模式，把当前账号全部 Bot、组织架构、技能、例行任务、记忆和对话
+持久化到 /workspace/grok-bot-team-YYYY-MM-DD/ 。
+先盘点花名册给我确认，再写文件。不要发明角色，不要写密钥。
+```
+
+4. 确认花名册后让它跑完。下载或推送 dated 目录。
+
+## 新机器（按快照初始化）
+
+1. 安装并登录 Grok Bot。
+2. 把 dated 目录放到 `/workspace/grok-bot-team-YYYY-MM-DD/`。不要改名。
+3. 把本技能夹放到 `/workspace/grok-bot-team-steward/`。
+4. 同样新建「管家」，贴同一段 Description。
+5. 按快照 `connectors.md` 在 Settings → Plugins 连接插件。
+6. 对管家说：
+
+```
+读取 /workspace/grok-bot-team-steward/SKILL.md
+以及同目录 references/、templates/、steward/。
+保存并启用技能 grok-bot-team-steward。
+然后按 restore 模式读取 /workspace/grok-bot-team-YYYY-MM-DD/ 。
+先只读预览花名册、GAPS、DROP-LIST 和未连接插件。
+我确认「按这份建」之后再创建空白 Bot。
+PROFILE 逐字粘贴。不要 Duplicate。routine 一律暂停。
+不要宣称官方聊天记录已经恢复。
+```
+
+7. 按对照表验收。两次成功试跑后再启用指定 routine。
+
+## 不要做的事
+
+- 不要把本技能夹当成快照
+- 不要把两天的快照解压进同一个文件夹
+- 不要跳过预览直接说「你看着办」
+- 不要指望登录态和官方聊天时间线一起回来