feat: skills - summarize auto-tmux records

2026-08-19 13:58:05 +00:00 · 2026-05-19 04:08:21 +08:00
parent e75a2366c5
commit fbc82f5ba5
11 changed files with 134 additions and 6 deletions
@@ -15,6 +15,7 @@ scripts/
 ├── swarm-archive.sh # 打包 brief、snapshot 和 swarm state
 ├── swarm-board.sh # 从 swarm state 渲染 Markdown 看板
 ├── swarm-assign.sh # 生成 ready task 到 worker pane 的分配建议
+├── record-summary.sh # 汇总 pipe-pane 录制日志
 ├── safety-check.sh # 发送/粘贴/分发前的 payload 安全预检
 ├── render-swarm-prompt.sh # commander/worker/reviewer 提示词渲染
 ├── swarm-dispatch.sh # 渲染并可选下发蜂群提示词
@@ -36,6 +37,7 @@ scripts/
 - 归档脚本只复制状态和只读证据，不修改 tmux pane 或 swarm state。
 - 看板脚本只读 `tasks.tsv`、`deps.tsv`、锁和状态日志，不改写状态目录。
 - 分配建议脚本只读任务和 pane 拓扑，不 claim 任务、不发送 prompt。
+- 录制摘要脚本只读 record 日志，输出默认脱敏，不修改日志源文件。
 - 安全预检脚本只能读取文本或文件，不控制 tmux，不写状态目录。
 - 状态脚本只能写入显式状态目录，不保存密钥、Token、密码或私密项目内容。
 - 自测脚本必须创建独立临时 tmux session，并在退出时清理。
@@ -11,6 +11,7 @@
 - [`swarm-archive.sh`](./swarm-archive.sh) - 打包 brief、snapshot 和 swarm state，生成可交接归档。
 - [`swarm-board.sh`](./swarm-board.sh) - 将 `tasks.tsv`、依赖、锁和状态日志渲染为 Markdown 看板。
 - [`swarm-assign.sh`](./swarm-assign.sh) - 根据 ready tasks 和 worker pane 生成只读分配建议。
+- [`record-summary.sh`](./record-summary.sh) - 汇总 `record start` 产生的 pane 日志，生成复盘摘要。
 - [`safety-check.sh`](./safety-check.sh) - 发送、粘贴或分发前检查危险命令、敏感信息和过大 payload。
 - [`render-swarm-prompt.sh`](./render-swarm-prompt.sh) - commander、worker、reviewer 提示词渲染。
 - [`swarm-dispatch.sh`](./swarm-dispatch.sh) - 渲染提示词并可选发送到指定 pane，默认只写文件。
@@ -66,6 +67,9 @@ skills/auto-tmux/scripts/swarm-board.sh --dir /tmp/ai_swarm --out /tmp/ai-swarm-
 # 生成 worker 分配建议
 skills/auto-tmux/scripts/swarm-assign.sh --swarm-dir /tmp/ai_swarm --session ai-hub --out /tmp/ai-swarm-assign.md

+# 汇总 pane 录制日志
+skills/auto-tmux/scripts/record-summary.sh --dir /tmp/auto-tmux-records --out /tmp/auto-tmux-record-summary.md
+
 # 初始化蜂群状态并添加任务
 skills/auto-tmux/scripts/swarm-state.sh init --dir /tmp/ai_swarm
 skills/auto-tmux/scripts/swarm-state.sh task-add --id task-001 --text "检查 README 链接"
@@ -11,6 +11,7 @@ SWARM_WATCH="$SCRIPT_DIR/swarm-watch.sh"
 SWARM_ARCHIVE="$SCRIPT_DIR/swarm-archive.sh"
 SWARM_BOARD="$SCRIPT_DIR/swarm-board.sh"
 SWARM_ASSIGN="$SCRIPT_DIR/swarm-assign.sh"
+RECORD_SUMMARY="$SCRIPT_DIR/record-summary.sh"
 SAFETY_CHECK="$SCRIPT_DIR/safety-check.sh"
 SWARM_DISPATCH="$SCRIPT_DIR/swarm-dispatch.sh"
 SESSION="auto-tmux-smoke-$$"
@@ -18,6 +19,7 @@ SWARM_DIR="/tmp/auto-tmux-smoke-swarm-$$"
 DEP_SWARM_DIR="/tmp/auto-tmux-smoke-dep-swarm-$$"
 SNAPSHOT_DIR="/tmp/auto-tmux-smoke-snapshot-$$"
 RECORD_DIR="/tmp/auto-tmux-smoke-record-$$"
+RECORD_SUMMARY_FILE="/tmp/auto-tmux-smoke-record-summary-$$.md"
 BRIEF_DIR="/tmp/auto-tmux-smoke-brief-$$"
 WATCH_DIR="/tmp/auto-tmux-smoke-watch-$$"
 ARCHIVE_FILE="/tmp/auto-tmux-smoke-archive-$$.tar.gz"
@@ -29,7 +31,7 @@ PASTE_FILE="/tmp/auto-tmux-smoke-paste-$$.txt"

 cleanup() {
  tmux kill-session -t "$SESSION" 2>/dev/null || true
-  rm -rf "$SWARM_DIR" "$DEP_SWARM_DIR" "$SNAPSHOT_DIR" "$RECORD_DIR" "$BRIEF_DIR" "$WATCH_DIR" "$ARCHIVE_FILE" "$BOARD_FILE" "$ASSIGN_FILE" "$DISPATCH_PROMPT" "$TASK_IMPORT_FILE" "$PASTE_FILE"
+  rm -rf "$SWARM_DIR" "$DEP_SWARM_DIR" "$SNAPSHOT_DIR" "$RECORD_DIR" "$RECORD_SUMMARY_FILE" "$BRIEF_DIR" "$WATCH_DIR" "$ARCHIVE_FILE" "$BOARD_FILE" "$ASSIGN_FILE" "$DISPATCH_PROMPT" "$TASK_IMPORT_FILE" "$PASTE_FILE"
 }
 trap cleanup EXIT

@@ -46,6 +48,7 @@ bash -n "$SWARM_WATCH"
 bash -n "$SWARM_ARCHIVE"
 bash -n "$SWARM_BOARD"
 bash -n "$SWARM_ASSIGN"
+bash -n "$RECORD_SUMMARY"
 bash -n "$SAFETY_CHECK"
 bash -n "$SWARM_DISPATCH"

@@ -75,7 +78,12 @@ fi
 test -s "$SNAPSHOT_DIR/topology.txt"

 "$AUTO_TMUX" record start -t "$worker_target" --dir "$RECORD_DIR" >/tmp/auto-tmux-smoke-record-start.txt
+"$AUTO_TMUX" send -t "$worker_target" --text "echo AUTO_TMUX_RECORD_OK" --enter
+"$AUTO_TMUX" wait -t "$worker_target" --pattern "AUTO_TMUX_RECORD_OK" --timeout 10 >/tmp/auto-tmux-smoke-record-wait.txt
 "$AUTO_TMUX" record stop -t "$worker_target" >/tmp/auto-tmux-smoke-record-stop.txt
+"$RECORD_SUMMARY" --dir "$RECORD_DIR" --out "$RECORD_SUMMARY_FILE" -n 20 >/tmp/auto-tmux-smoke-record-summary.txt
+grep -q 'auto-tmux Record Summary' "$RECORD_SUMMARY_FILE"
+grep -q 'AUTO_TMUX_RECORD_OK' "$RECORD_SUMMARY_FILE"

 "$SWARM_STATE" init --dir "$SWARM_DIR" >/tmp/auto-tmux-smoke-swarm-init.txt
 "$SWARM_STATE" task-add --dir "$SWARM_DIR" --id smoke-task --text "run smoke task" >/tmp/auto-tmux-smoke-task-add.txt
@@ -153,7 +153,7 @@ cmd_doctor() {
    status_line "WARN" "tmux server has no reachable session yet"
  fi

-  for script in auto-tmux.sh swarm-state.sh swarm-brief.sh swarm-watch.sh swarm-archive.sh swarm-board.sh swarm-assign.sh safety-check.sh render-swarm-prompt.sh swarm-dispatch.sh auto-tmux-smoke-test.sh validate-auto-tmux.sh; do
+  for script in auto-tmux.sh swarm-state.sh swarm-brief.sh swarm-watch.sh swarm-archive.sh swarm-board.sh swarm-assign.sh record-summary.sh safety-check.sh render-swarm-prompt.sh swarm-dispatch.sh auto-tmux-smoke-test.sh validate-auto-tmux.sh; do
    if [[ -x "$script_dir/$script" ]]; then
      status_line "OK" "script executable: $script"
    else
@@ -0,0 +1,100 @@
+#!/usr/bin/env bash
+# record-summary: summarize auto-tmux pipe-pane record logs as Markdown.
+set -euo pipefail
+
+usage() {
+  cat <<'EOF'
+record-summary: summarize auto-tmux record logs
+
+Usage:
+  record-summary.sh [--dir DIR] [--out FILE] [-n LINES]
+
+Defaults:
+  --dir /tmp/auto-tmux-records
+  --out stdout
+  -n    40 tail lines per log
+
+This script is read-only. It never modifies tmux sessions or record logs.
+EOF
+}
+
+die() {
+  printf 'error: %s\n' "$*" >&2
+  exit 1
+}
+
+record_dir="/tmp/auto-tmux-records"
+out_file=""
+lines=40
+
+while [[ $# -gt 0 ]]; do
+  case "$1" in
+    --dir)
+      record_dir="${2:-}"
+      shift 2
+      ;;
+    --out)
+      out_file="${2:-}"
+      shift 2
+      ;;
+    -n|--lines)
+      lines="${2:-}"
+      shift 2
+      ;;
+    -h|--help)
+      usage
+      exit 0
+      ;;
+    *)
+      die "unknown option: $1"
+      ;;
+  esac
+done
+
+[[ "$lines" =~ ^[0-9]+$ ]] || die "--lines must be a number"
+[[ -d "$record_dir" ]] || die "record directory not found: $record_dir"
+
+redact() {
+  sed -E \
+    -e 's/(OPENAI_API_KEY|ANTHROPIC_API_KEY|GITHUB_TOKEN|GH_TOKEN|API_KEY|TOKEN|PASSWORD|SECRET)=([^[:space:]]+)/\1=<redacted>/g' \
+    -e 's/(Bearer[[:space:]]+)[A-Za-z0-9._~+\/=-]+/\1<redacted>/g' \
+    -e 's/(sk-[A-Za-z0-9_-]{12,})/<redacted-openai-key>/g'
+}
+
+render_summary() {
+  printf '# auto-tmux Record Summary\n\n'
+  printf -- '- dir: `%s`\n' "$record_dir"
+  printf -- '- created_at: `%s`\n\n' "$(date -Is)"
+
+  printf '## Logs\n\n'
+  printf '| file | bytes | lines | modified |\n'
+  printf '|:---|---:|---:|:---|\n'
+  find "$record_dir" -maxdepth 1 -type f -name '*.log' -print | sort | while read -r file; do
+    printf '| `%s` | %s | %s | %s |\n' \
+      "$(basename "$file")" \
+      "$(wc -c < "$file" | tr -d ' ')" \
+      "$(wc -l < "$file" | tr -d ' ')" \
+      "$(date -r "$file" -Is 2>/dev/null || printf unknown)"
+  done
+
+  if ! find "$record_dir" -maxdepth 1 -type f -name '*.log' -print -quit | grep -q .; then
+    printf '| - | 0 | 0 | - |\n'
+    return 0
+  fi
+
+  printf '\n## Recent Output\n\n'
+  find "$record_dir" -maxdepth 1 -type f -name '*.log' -print | sort | while read -r file; do
+    printf '### `%s`\n\n' "$(basename "$file")"
+    printf '```text\n'
+    tail -n "$lines" "$file" | redact
+    printf '\n```\n\n'
+  done
+}
+
+if [[ -n "$out_file" ]]; then
+  mkdir -p "$(dirname "$out_file")"
+  render_summary > "$out_file"
+  printf 'record summary written: %s\n' "$out_file"
+else
+  render_summary
+fi
@@ -84,6 +84,7 @@ scripts=(
  "$script_dir/swarm-archive.sh"
  "$script_dir/swarm-board.sh"
  "$script_dir/swarm-assign.sh"
+  "$script_dir/record-summary.sh"
  "$script_dir/safety-check.sh"
  "$script_dir/render-swarm-prompt.sh"
  "$script_dir/swarm-dispatch.sh"
@@ -102,6 +103,7 @@ run_gate "swarm-watch help" "$script_dir/swarm-watch.sh" --help
 run_gate "swarm-archive help" "$script_dir/swarm-archive.sh" --help
 run_gate "swarm-board help" "$script_dir/swarm-board.sh" --help
 run_gate "swarm-assign help" "$script_dir/swarm-assign.sh" --help
+run_gate "record-summary help" "$script_dir/record-summary.sh" --help
 run_gate "safety-check help" "$script_dir/safety-check.sh" --help
 run_gate "safety-check clean text" "$script_dir/safety-check.sh" --text "make test"
 if "$script_dir/safety-check.sh" --text "rm -rf /tmp/example" >/tmp/auto-tmux-validate-gate.log 2>&1; then
@@ -118,6 +120,7 @@ require_contains "$skill_dir/SKILL.md" "scripts/swarm-watch.sh"
 require_contains "$skill_dir/SKILL.md" "scripts/swarm-archive.sh"
 require_contains "$skill_dir/SKILL.md" "scripts/swarm-board.sh"
 require_contains "$skill_dir/SKILL.md" "scripts/swarm-assign.sh"
+require_contains "$skill_dir/SKILL.md" "scripts/record-summary.sh"
 require_contains "$skill_dir/SKILL.md" "scripts/safety-check.sh"
 require_contains "$skill_dir/SKILL.md" "scripts/swarm-dispatch.sh"
 require_contains "$skill_dir/references/index.md" "automation.md"
@@ -130,6 +133,7 @@ require_contains "$script_dir/README.md" "swarm-watch.sh"
 require_contains "$script_dir/README.md" "swarm-archive.sh"
 require_contains "$script_dir/README.md" "swarm-board.sh"
 require_contains "$script_dir/README.md" "swarm-assign.sh"
+require_contains "$script_dir/README.md" "record-summary.sh"
 require_contains "$script_dir/README.md" "safety-check.sh"
 require_contains "$script_dir/AGENTS.md" "validate-auto-tmux.sh"
 require_contains "$script_dir/AGENTS.md" "swarm-dispatch.sh"
@@ -137,6 +141,7 @@ require_contains "$script_dir/AGENTS.md" "swarm-watch.sh"
 require_contains "$script_dir/AGENTS.md" "swarm-archive.sh"
 require_contains "$script_dir/AGENTS.md" "swarm-board.sh"
 require_contains "$script_dir/AGENTS.md" "swarm-assign.sh"
+require_contains "$script_dir/AGENTS.md" "record-summary.sh"
 require_contains "$script_dir/AGENTS.md" "safety-check.sh"

 if [[ -x "$repo_root/skills/auto-skill/scripts/validate-skill.sh" ]]; then