@namewta/speculo 2.0.6 → 2.1.0

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。
+
+## 不要做的事
+
+- 不要把本技能夹当成快照
+- 不要把两天的快照解压进同一个文件夹
+- 不要跳过预览直接说「你看着办」
+- 不要指望登录态和官方聊天时间线一起回来

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

@@ -0,0 +1,33 @@
+# 管家授权安装
+
+路径约定：执行或转发示例前，将 `/workspace` 替换为本轮已确认工作区、技能路径替换为实际 SKILL.md 所在目录。未完成替换就不发送命令；不得新建根目录来迎合模板。
+仅在用户明确要求创建或配置管家时执行本文件。仅加载技能、比较快照不创建 Bot、不修改 profile、不联系其他 Bot。已有管家先复用，不创建第二个管家。下列 `/workspace/grok-bot-team-steward/` 是部署示例，实际技能路径以本轮 SKILL.md 所在目录为准。
+
+把本文件发给一个新建的 Grok Bot。它读完后应把自己变成团队管家。
+
+## 你的身份
+
+Name：管家  
+Title：Grok Bot 团队管家  
+
+Description 使用下面整段，保存到自己的 profile，不要缩写。
+
+你是 **管家**，本账号 Grok Bot 团队的档案官和冷启动员。主责只有两件：把当前团队写成 `/workspace/grok-bot-team-YYYY-MM-DD/` 快照；或读取这样一份快照，在本账号重建花名册、技能、群聊、记忆参考和暂停态例行任务。激活并遵守技能 `grok-bot-team-steward`。接收条件：用户要求快照、备份、持久化、导出、换机初始化、恢复、或上传了 `grok-bot-team-20*` 目录。做法：先判定 snapshot 还是 restore。snapshot 时盘点活花名册，让每个 Bot 自述 PROFILE / MEMORY / routines / 对话，再写共享层、脱敏、MANIFEST。restore 时先只读预览，等人连接插件并确认「按这份建」，再创建空白 Bot 并逐字写入 PROFILE，不使用 Duplicate 作为主路径。交付：快照目录绝对路径，或恢复对照表 + DROP LIST。授权：不发送外部邮件、不发帖、不付款、不改生产、不发起 OAuth、不向用户索要 token、不启用 routine。停止：完成 / 待确认 / 找不到快照 / 用户叫停。
+
+## 技能正文位置
+
+先在工作区定位：
+
+```
+/workspace/grok-bot-team-steward/SKILL.md
+```
+
+若路径不同，搜索 `SKILL.md` 且目录名含 `grok-bot-team-steward`。读取该文件和同级 `references/`，保存为私有技能 `grok-bot-team-steward` 并启用给自己。
+
+## 保存后立刻做
+
+1. 回复：技能已启用。
+2. 扫描 `/workspace/grok-bot-team-20*`。
+3. 若存在完整快照且用户要初始化 → restore，先预览。
+4. 否则 → snapshot，先给出花名册草稿。
+5. 遵守硬规则：dated 目录不覆盖、不发明角色、不写密钥、routine 恢复为暂停、对话导不出就写 GAPS、不宣称 100% 一模一样。

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

@@ -0,0 +1,28 @@
+# 团队管家
+
+路径约定：执行或转发示例前，将 `/workspace` 替换为本轮已确认工作区、技能路径替换为实际 SKILL.md 所在目录。未完成替换就不发送命令；不得新建根目录来迎合模板。
+| 字段 | 值 |
+|---|---|
+| name | 管家 |
+| title | Grok Bot 团队管家 |
+| autonomy | L1。导出可自行落盘；恢复必须先预览再创建；启用 routine 必须用户点头 |
+
+## Description（整段贴进 Bot actions → Edit Profile）
+
+你是 **管家**，本账号 Grok Bot 团队的档案官和冷启动员。
+
+主责只有两件：把当前团队写成 `/workspace/grok-bot-team-YYYY-MM-DD/` 快照；或读取这样一份快照，在本账号重建花名册、技能、群聊、记忆参考和暂停态例行任务。
+
+激活并遵守技能 `grok-bot-team-steward`（本技能目录内 SKILL.md 与 references/）。与本描述冲突时以该技能的硬规则为准。
+
+接收条件：用户要求快照、备份、持久化、导出、换机初始化、恢复、或上传了 `grok-bot-team-20*` 目录。
+
+做法：先判定 snapshot 还是 restore。snapshot 时盘点活花名册，让每个 Bot 自述 PROFILE / MEMORY / routines / 对话，再写共享层、脱敏、MANIFEST。restore 时先只读预览，等人连接插件并确认「按这份建」，再创建空白 Bot 并逐字写入 PROFILE，不使用 Duplicate 作为主路径。
+
+交付：快照目录绝对路径，或恢复对照表 + DROP LIST。没有 MANIFEST 和 GAPS 不算完成。
+
+分工：你协调导出和重建。不抢业务 Bot 的专业工作。不创建花名册以外的 Bot。
+
+授权：不发送外部邮件、不发帖、不付款、不改生产、不发起 OAuth、不向用户索要 token、不启用 routine。Share 链接写入前必须脱敏。
+
+停止：完成 / 待用户确认花名册或插件 / 待授权启用 routine / 找不到快照 / 达工作量上限 / 用户叫停。

package/skills-hub/automation/grok-bot-team-steward/templates/snapshot/CHANGELOG.md

@@ -0,0 +1,3 @@
+# CHANGELOG
+
+- YYYY-MM-DD HH:MM — snapshot created by 管家

package/skills-hub/automation/grok-bot-team-steward/templates/snapshot/CHARTER.md

@@ -0,0 +1,27 @@
+# CHARTER
+
+## 目标
+
+- 主结果：
+- 非目标：
+
+## 编制原则
+
+- 最小有用花名册
+- 全体 Bot 共享一台云电脑，Bot 不是安全边界
+- 管家只做档案与冷启动，不抢业务执行
+
+## 语言与时区
+
+- 语言：
+- 时区：
+
+## 审批边界
+
+必须人工点头：外部发送、付款、发帖、合并、生产变更、创建花名册以外的 Bot、启用 routine、公开 Share。
+
+可自行完成：只读调研、起草、在 `/workspace` 写快照文件。
+
+## 停止条件
+
+完成 / 待输入 / 待授权 / 受阻 / 达上限 / 用户叫停。

package/skills-hub/automation/grok-bot-team-steward/templates/snapshot/DROP-LIST.md

@@ -0,0 +1,10 @@
+# DROP LIST
+
+本快照明确带不走：
+
+1. 插件 OAuth 登录态
+2. 浏览器 cookie 与已登录网站
+3. 官方聊天时间线本体（只有 conversations/*.md）
+4. GAPS.md 里标记缺失的记忆或对话
+5. 未写入 shared/workspace-map.md 的云电脑自装软件
+6. 附件中超过导出上限且未拆分的文件

package/skills-hub/automation/grok-bot-team-steward/templates/snapshot/GAPS.md

@@ -0,0 +1,6 @@
+# GAPS（全队）
+
+- conversations: 
+- memory: 
+- skills-text: 
+- workspace-copy: 

package/skills-hub/automation/grok-bot-team-steward/templates/snapshot/INIT.md

@@ -0,0 +1,14 @@
+# INIT（本快照自带）
+
+本文件属于 dated 快照，不是技能包。把本目录放到 `/workspace/` 后，对管家说：
+
+```
+读取本目录上一层或 /workspace/grok-bot-team-steward/ 里的 grok-bot-team-steward 技能。
+restore 模式读取本目录。
+先只读预览 ROSTER / GAPS / DROP-LIST / connectors。
+我确认「按这份建」后再创建空白 Bot。
+PROFILE 逐字粘贴。routine 一律暂停。
+不要 Duplicate。不要宣称官方聊天已恢复。
+```
+
+若技能包不在，把本目录 `../` 找不到 SKILL.md 时：仍按 ROSTER 与每个 `bots/<slug>/PROFILE.md` 创建，MEMORY.md 发给对应 Bot 读入。

package/skills-hub/automation/grok-bot-team-steward/templates/snapshot/MANIFEST.md

@@ -0,0 +1,30 @@
+# MANIFEST
+
+- snapshot_id: grok-bot-team-YYYY-MM-DD
+- created_at:
+- completed_at:
+- steward_name: 管家
+- timezone:
+- bots_count: 0
+- rooms_count: 0
+- skills_count: 0
+- routines_count: 0
+- conversations_files: 0
+
+## files
+
+| path | role | source | complete |
+|---|---|---|---|
+| CHARTER.md | charter | steward | missing |
+| ROSTER.md | roster | steward | missing |
+
+source：`bot-self` | `steward` | `user`  
+complete：`yes` | `partial` | `missing`
+
+## gaps_summary
+
+-
+
+## restore_hint
+
+对新账号上的管家说：读取 grok-bot-team-steward 技能，restore 本目录，先预览再创建。

package/skills-hub/automation/grok-bot-team-steward/templates/snapshot/MANIFEST.yaml

@@ -0,0 +1,20 @@
+schema: grok-bot-team-snapshot/v1
+snapshot_id: grok-bot-team-YYYY-MM-DD
+exported_at: ""
+completed_at: ""
+timezone: ""
+exporter: 管家
+source_skill: grok-bot-team-steward
+status: in_progress
+bots: []
+rooms: []
+skills: []
+routines: []
+connectors: []
+conversations_coverage: {}
+cannot_restore:
+  - OAuth and browser sessions
+  - cloud computer packages not listed in shared/workspace-map.md
+  - official chat history the platform refused to export
+  - attachments over the ~25MB cap that were not split
+gaps: []

package/skills-hub/automation/grok-bot-team-steward/templates/snapshot/ORG.md

@@ -0,0 +1,15 @@
+# ORG
+
+```
+用户
+└─ 管家（档案 / 冷启动）
+   ├─ <Lead A>
+   │    └─ <Specialist>
+   └─ <Lead B>
+```
+
+## 交接
+
+| 从 | 到 | 交什么 | 格式 |
+|---|---|---|---|
+| | | | 结果 / 来源版本 / 路径 / 已完成 / 缺口 / 授权 / 剩余工作量 |

package/skills-hub/automation/grok-bot-team-steward/templates/snapshot/README.md

@@ -0,0 +1,8 @@
+# grok-bot-team-YYYY-MM-DD
+
+这是一份 Grok Bot 团队快照，不是技能包。
+
+- 在原账号由管家按技能 `grok-bot-team-steward` 导出
+- 换机时把本目录放到 `/workspace/grok-bot-team-YYYY-MM-DD/`，新建管家，激活同一技能，模式选 restore
+
+先读 `MANIFEST.md`、`ROSTER.md`、`GAPS.md`、`DROP-LIST.md`、`connectors.md`。

package/skills-hub/automation/grok-bot-team-steward/templates/snapshot/RESTORE.md

@@ -0,0 +1,13 @@
+# RESTORE（本快照自带验收）
+
+- [ ] 插件已按 connectors.md 重连
+- [ ] Bot 数量与 ROSTER 一致
+- [ ] 每个 PROFILE name/title/description 逐字一致
+- [ ] 技能已保存并按 skills.md 启用
+- [ ] 群聊成员与 rooms/ 一致
+- [ ] 每个 Bot 复述了 MEMORY 中三条事实
+- [ ] conversations 已作为参考喂入，未声称官方历史恢复
+- [ ] routines 均为暂停
+- [ ] DROP-LIST 已向用户宣读
+
+未勾完不许说初始化完成。

package/skills-hub/automation/grok-bot-team-steward/templates/snapshot/ROSTER.md

@@ -0,0 +1,11 @@
+# ROSTER
+
+| slug | name | title | rooms | skills | routines | conversations |
+|---|---|---|---|---|---|---|
+| example | Example | 一件具体工作 | hq | 0 | 0 | partial |
+
+## 创建规则
+
+- 恢复时 name 与 PROFILE.md 逐字一致
+- 禁止第二个同名 Bot
+- 创建后第一条对外动作必须是草稿

package/skills-hub/automation/grok-bot-team-steward/templates/snapshot/bots/_SLUG/GAPS.md

@@ -0,0 +1,7 @@
+# GAPS
+
+- profile:
+- memory:
+- routines:
+- skills:
+- conversations:

package/skills-hub/automation/grok-bot-team-steward/templates/snapshot/bots/_SLUG/MEMORY.md

@@ -0,0 +1,9 @@
+# MEMORY
+
+现行事实（日期 + 来源）：
+
+- YYYY-MM-DD —  — 来源：
+
+待核销：
+
+- YYYY-MM-DD —  — 原因：

package/skills-hub/automation/grok-bot-team-steward/templates/snapshot/bots/_SLUG/PROFILE.md

@@ -0,0 +1,27 @@
+# PROFILE
+
+| 字段 | 值 |
+|---|---|
+| slug | example |
+| name | Example |
+| title | 一件具体工作 |
+| autonomy | L1 草稿 |
+| avatar | |
+
+## Description
+
+你是 **Example**，一名 Grok Bot。
+
+主责：
+
+接收条件：
+
+做法：
+
+交付：
+
+分工：
+
+授权：不发送、不付款、不改生产。外部动作必须人工批准。
+
+停止：完成 / 待输入 / 待授权 / 受阻 / 达上限 / 用户叫停。

package/skills-hub/automation/grok-bot-team-steward/templates/snapshot/bots/_SLUG/agent-spec.md

@@ -0,0 +1,9 @@
+# agent-spec
+
+- slug:
+- name:
+- visible_id: Unknown
+- enabled_skills: []
+- routine_ids: []
+- rooms: []
+- home_dir:

package/skills-hub/automation/grok-bot-team-steward/templates/snapshot/bots/_SLUG/conversations/INDEX.md

@@ -0,0 +1,5 @@
+# conversations
+
+| file | range | messages | truncated | source |
+|---|---|---|---|---|
+| main.md | | 0 | yes | unknown |

package/skills-hub/automation/grok-bot-team-steward/templates/snapshot/bots/_SLUG/conversations/main.md

@@ -0,0 +1,9 @@
+---
+bot: example
+source: unknown
+range:
+messages: 0
+truncated: true
+---
+
+（尚未导出。导不出时保留本文件并在 GAPS.md 说明原因，不要编造消息。）

package/skills-hub/automation/grok-bot-team-steward/templates/snapshot/bots/_SLUG/routines.md

@@ -0,0 +1,5 @@
+# routines
+
+| id | 名称 | 日程或触发 | 技能 | 状态 | 审批 | 缺源策略 | 最近一次运行 |
+|---|---|---|---|---|---|---|---|
+| | | | | paused | L1 | 跳过并记录 | Unknown |

package/skills-hub/automation/grok-bot-team-steward/templates/snapshot/bots/_SLUG/skills.md

@@ -0,0 +1,5 @@
+# enabled skills
+
+| id | 用途 |
+|---|---|
+| | |

package/skills-hub/automation/grok-bot-team-steward/templates/snapshot/connectors.md

@@ -0,0 +1,7 @@
+# connectors
+
+| 连接器 | 用途 | 需要它的 Bot | 换机重连 |
+|---|---|---|---|
+| GitHub | 私有仓存放快照 | 管家 | Settings → Plugins → GitHub |
+
+禁止写 token / cookie / refresh token。

package/skills-hub/automation/grok-bot-team-steward/templates/snapshot/meta/COMPLETED.md

@@ -0,0 +1,6 @@
+# COMPLETED
+
+- snapshot_id: grok-bot-team-YYYY-MM-DD
+- completed_at:
+- bots_written: 0
+- open_gaps: 0

package/skills-hub/automation/grok-bot-team-steward/templates/snapshot/meta/CREATED.md

@@ -0,0 +1,6 @@
+# CREATED
+
+- snapshot_id: grok-bot-team-YYYY-MM-DD
+- started_at:
+- steward:
+- operator:

package/skills-hub/automation/grok-bot-team-steward/templates/snapshot/meta/RESTORE-NOTES.md

@@ -0,0 +1,13 @@
+# RESTORE NOTES
+
+仅恢复时填写。
+
+- source_snapshot:
+- restored_at:
+- operator_confirm: 未确认 / 按这份建
+- plugins_connected:
+- bots_created:
+- bots_failed:
+- routines_paused:
+- memory_readbacks:
+- deviations: 用户当轮改了什么

package/skills-hub/automation/grok-bot-team-steward/templates/snapshot/meta/SANITIZER.md

@@ -0,0 +1,7 @@
+# sanitizer
+
+- scanned_at:
+- files_scanned: 0
+- redactions: 0
+- skipped_files:
+  - 

package/skills-hub/automation/grok-bot-team-steward/templates/snapshot/meta/SOURCE.md

@@ -0,0 +1,8 @@
+# SOURCE
+
+- account_hint: Unknown（不要写邮箱原文）
+- app: Grok Bot
+- steward_skill: grok-bot-team-steward
+- started_at:
+- finished_at:
+- notes:

package/skills-hub/automation/grok-bot-team-steward/templates/snapshot/rooms/_ROOM.md

@@ -0,0 +1,8 @@
+# room
+
+- slug:
+- name:
+- members:
+- purpose:
+- handoff: 结果 / 来源版本 / 成品路径 / 已完成 / 缺口 / 授权 / 剩余工作量
+- never:

package/skills-hub/automation/grok-bot-team-steward/templates/snapshot/routines/_ROUTINE.md

@@ -0,0 +1,12 @@
+# routine
+
+- id:
+- name:
+- owner_slug:
+- cadence:
+- skill:
+- expected_result:
+- approval: L1 草稿
+- missing_source: 跳过并记录
+- test_first: true
+- status_on_restore: paused

package/skills-hub/automation/grok-bot-team-steward/templates/snapshot/shared/shared-memory.md

@@ -0,0 +1,5 @@
+# shared memory
+
+全队共享、不专属于某个 Bot 的现行事实。
+
+- YYYY-MM-DD —

package/skills-hub/automation/grok-bot-team-steward/templates/snapshot/shared/workspace-map.md

@@ -0,0 +1,5 @@
+# workspace map
+
+| path | 复制进快照 | 体积 | 备注 |
+|---|---|---|---|
+| /workspace/example | no | Unknown | |

package/skills-hub/automation/grok-bot-team-steward/templates/snapshot/skills/_SKILL/SKILL.md

@@ -0,0 +1,18 @@
+---
+name: example-skill
+description: 在用户要求做某类可重复任务时使用。
+---
+
+# example-skill
+
+## 1. 何时使用
+
+## 2. 所需输入与权限
+
+## 3. 工作步骤
+
+## 4. 如何验收
+
+## 5. 返回什么
+
+## 6. 何事必须批准