diff --git a/skills/auto-tmux/AGENTS.md b/skills/auto-tmux/AGENTS.md index ae463e0..e2894ce 100644 --- a/skills/auto-tmux/AGENTS.md +++ b/skills/auto-tmux/AGENTS.md @@ -16,6 +16,7 @@ skills/auto-tmux/ │ ├── swarm-state.sh │ ├── swarm-brief.sh │ ├── swarm-watch.sh +│ ├── swarm-archive.sh │ ├── render-swarm-prompt.sh │ ├── swarm-dispatch.sh │ ├── auto-tmux-smoke-test.sh @@ -42,6 +43,7 @@ skills/auto-tmux/ - `scripts/swarm-state.sh` 是蜂群协作状态层，管理任务、锁、状态日志和结果报告。 - `scripts/swarm-brief.sh` 是只读交接层，汇总 doctor/topology/scan/report 形成上下文快照。 - `scripts/swarm-watch.sh` 是有限轮次巡检层，按间隔采集 pane 输出与 swarm report。 +- `scripts/swarm-archive.sh` 是归档层，打包 brief、snapshot 和 swarm state 供复盘交接。 - `scripts/render-swarm-prompt.sh` 是提示词渲染层，生成 commander/worker/reviewer 协议文本。 - `scripts/swarm-dispatch.sh` 是提示词下发层，默认写文件，显式 `--send` 后才发送到 pane。 - `scripts/validate-auto-tmux.sh` 是技能专属质量门禁，覆盖脚本、文档索引和 smoke test。 @@ -53,4 +55,4 @@ skills/auto-tmux/ - 上游来源：`tools/external/.tmux` 与 `tools/external/tmux`。 - 下游使用：`SKILL.md` 和 `references/` 中的命令示例。 - 验证入口：`skills/auto-skill/scripts/validate-skill.sh skills/auto-tmux --strict`。 -- 脚本验证：`skills/auto-tmux/scripts/validate-auto-tmux.sh`、`bash -n skills/auto-tmux/scripts/auto-tmux.sh`、`bash -n skills/auto-tmux/scripts/swarm-state.sh`、`bash -n skills/auto-tmux/scripts/swarm-brief.sh`、`bash -n skills/auto-tmux/scripts/swarm-watch.sh`、`bash -n skills/auto-tmux/scripts/render-swarm-prompt.sh`、`bash -n skills/auto-tmux/scripts/swarm-dispatch.sh`、`skills/auto-tmux/scripts/auto-tmux-smoke-test.sh`。 +- 脚本验证：`skills/auto-tmux/scripts/validate-auto-tmux.sh`、`bash -n skills/auto-tmux/scripts/auto-tmux.sh`、`bash -n skills/auto-tmux/scripts/swarm-state.sh`、`bash -n skills/auto-tmux/scripts/swarm-brief.sh`、`bash -n skills/auto-tmux/scripts/swarm-watch.sh`、`bash -n skills/auto-tmux/scripts/swarm-archive.sh`、`bash -n skills/auto-tmux/scripts/render-swarm-prompt.sh`、`bash -n skills/auto-tmux/scripts/swarm-dispatch.sh`、`skills/auto-tmux/scripts/auto-tmux-smoke-test.sh`。 diff --git a/skills/auto-tmux/README.md b/skills/auto-tmux/README.md index ebeb0b4..83e1441 100644 --- a/skills/auto-tmux/README.md +++ b/skills/auto-tmux/README.md @@ -23,6 +23,7 @@ bash -n skills/auto-tmux/scripts/auto-tmux.sh bash -n skills/auto-tmux/scripts/swarm-state.sh bash -n skills/auto-tmux/scripts/swarm-brief.sh bash -n skills/auto-tmux/scripts/swarm-watch.sh +bash -n skills/auto-tmux/scripts/swarm-archive.sh bash -n skills/auto-tmux/scripts/render-swarm-prompt.sh bash -n skills/auto-tmux/scripts/swarm-dispatch.sh bash -n skills/auto-tmux/scripts/validate-auto-tmux.sh diff --git a/skills/auto-tmux/SKILL.md b/skills/auto-tmux/SKILL.md index 8ea8433..a45b4cf 100644 --- a/skills/auto-tmux/SKILL.md +++ b/skills/auto-tmux/SKILL.md @@ -37,6 +37,7 @@ bash -n skills/auto-tmux/scripts/auto-tmux.sh bash -n skills/auto-tmux/scripts/swarm-state.sh bash -n skills/auto-tmux/scripts/swarm-brief.sh bash -n skills/auto-tmux/scripts/swarm-watch.sh +bash -n skills/auto-tmux/scripts/swarm-archive.sh bash -n skills/auto-tmux/scripts/render-swarm-prompt.sh bash -n skills/auto-tmux/scripts/swarm-dispatch.sh bash -n skills/auto-tmux/scripts/validate-auto-tmux.sh @@ -112,6 +113,7 @@ skills/auto-tmux/scripts/auto-tmux.sh broadcast --session ai-hub --text "pwd" -- skills/auto-tmux/scripts/auto-tmux.sh snapshot --session ai-hub --dir /tmp/auto-tmux-snapshot -n 120 skills/auto-tmux/scripts/swarm-brief.sh --session ai-hub --swarm-dir /tmp/ai_swarm --out /tmp/auto-tmux-brief skills/auto-tmux/scripts/swarm-watch.sh --session ai-hub --swarm-dir /tmp/ai_swarm --iterations 3 --interval 10 +skills/auto-tmux/scripts/swarm-archive.sh --session ai-hub --swarm-dir /tmp/ai_swarm --out /tmp/ai-hub-handoff.tar.gz ``` **远程救援：发现等待输入即发送 y** @@ -251,6 +253,7 @@ skills/auto-tmux/scripts/swarm-dispatch.sh --role worker --target ::/dev/null || true - rm -rf "$SWARM_DIR" "$SNAPSHOT_DIR" "$RECORD_DIR" "$BRIEF_DIR" "$WATCH_DIR" "$DISPATCH_PROMPT" "$TASK_IMPORT_FILE" "$PASTE_FILE" + rm -rf "$SWARM_DIR" "$SNAPSHOT_DIR" "$RECORD_DIR" "$BRIEF_DIR" "$WATCH_DIR" "$ARCHIVE_FILE" "$DISPATCH_PROMPT" "$TASK_IMPORT_FILE" "$PASTE_FILE" } trap cleanup EXIT @@ -35,6 +37,7 @@ bash -n "$SWARM_STATE" bash -n "$RENDER_PROMPT" bash -n "$SWARM_BRIEF" bash -n "$SWARM_WATCH" +bash -n "$SWARM_ARCHIVE" bash -n "$SWARM_DISPATCH" "$AUTO_TMUX" hub --session "$SESSION" --workers 1 --cmd bash @@ -101,6 +104,8 @@ grep -q 'smoke-fail' /tmp/auto-tmux-smoke-task-list-todo.txt grep -q 'auto-tmux Swarm Brief' "$BRIEF_DIR/brief.md" "$SWARM_WATCH" --session "$SESSION" --swarm-dir "$SWARM_DIR" --out "$WATCH_DIR" --iterations 1 --interval 0 -n 10 >/tmp/auto-tmux-smoke-watch.txt grep -q 'auto-tmux Swarm Watch' "$WATCH_DIR/index.md" +"$SWARM_ARCHIVE" --session "$SESSION" --swarm-dir "$SWARM_DIR" --out "$ARCHIVE_FILE" -n 10 >/tmp/auto-tmux-smoke-archive.txt +test -s "$ARCHIVE_FILE" "$RENDER_PROMPT" commander --session "$SESSION" --swarm-dir "$SWARM_DIR" --task "smoke" >/tmp/auto-tmux-smoke-commander-prompt.md "$RENDER_PROMPT" worker --session "$SESSION" --target "$worker_target" --swarm-dir "$SWARM_DIR" --task "smoke" >/tmp/auto-tmux-smoke-worker-prompt.md "$SWARM_DISPATCH" --role worker --target "$worker_target" --session "$SESSION" --swarm-dir "$SWARM_DIR" --task "smoke" --out "$DISPATCH_PROMPT" >/tmp/auto-tmux-smoke-dispatch-render.txt diff --git a/skills/auto-tmux/scripts/auto-tmux.sh b/skills/auto-tmux/scripts/auto-tmux.sh index 6216904..a058703 100755 --- a/skills/auto-tmux/scripts/auto-tmux.sh +++ b/skills/auto-tmux/scripts/auto-tmux.sh @@ -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 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 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 diff --git a/skills/auto-tmux/scripts/swarm-archive.sh b/skills/auto-tmux/scripts/swarm-archive.sh new file mode 100755 index 0000000..9273b0e --- /dev/null +++ b/skills/auto-tmux/scripts/swarm-archive.sh @@ -0,0 +1,80 @@ +#!/usr/bin/env bash +# Build a portable archive for a tmux AI swarm handoff. +set -euo pipefail + +usage() { + cat <<'EOF' +swarm-archive: build a portable auto-tmux handoff archive + +Usage: + swarm-archive.sh [--session NAME] [--swarm-dir DIR] [--out FILE] [-n LINES] + +Examples: + swarm-archive.sh --session ai-hub --swarm-dir /tmp/ai_swarm + swarm-archive.sh --session ai-hub --out /tmp/ai-hub-handoff.tar.gz -n 120 +EOF +} + +die() { + printf 'error: %s\n' "$*" >&2 + exit 1 +} + +script_dir="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)" +auto_tmux="$script_dir/auto-tmux.sh" +swarm_brief="$script_dir/swarm-brief.sh" + +session="" +swarm_dir="${AUTO_TMUX_SWARM_DIR:-/tmp/ai_swarm}" +out_file="/tmp/auto-tmux-archive-$(date +%Y%m%d-%H%M%S).tar.gz" +lines=120 + +while [[ $# -gt 0 ]]; do + case "$1" in + --session) session="${2:-}"; shift 2 ;; + --swarm-dir) swarm_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 positive integer" +command -v tar >/dev/null 2>&1 || die "tar is not installed or not in PATH" + +work_dir="$(mktemp -d /tmp/auto-tmux-archive.XXXXXX)" +cleanup() { + rm -rf "$work_dir" +} +trap cleanup EXIT + +mkdir -p "$work_dir" +{ + printf '# auto-tmux archive manifest\n\n' + printf '%s\n' "- created_at: \`$(date -Is)\`" + printf '%s\n' "- session: \`${session:-}\`" + printf '%s\n' "- swarm_dir: \`$swarm_dir\`" + printf '%s\n' "- lines_per_pane: \`$lines\`" +} > "$work_dir/MANIFEST.md" + +brief_args=(--swarm-dir "$swarm_dir" --out "$work_dir/brief" -n "$lines") +snapshot_args=(snapshot --dir "$work_dir/snapshot" -n "$lines") +if [[ -n "$session" ]]; then + brief_args=(--session "$session" "${brief_args[@]}") + snapshot_args=(snapshot --session "$session" --dir "$work_dir/snapshot" -n "$lines") +fi + +"$swarm_brief" "${brief_args[@]}" > "$work_dir/brief.log" 2>&1 || true +"$auto_tmux" "${snapshot_args[@]}" > "$work_dir/snapshot.log" 2>&1 || true + +if [[ -d "$swarm_dir" ]]; then + mkdir -p "$work_dir/state" + cp -a "$swarm_dir/." "$work_dir/state/" +else + printf 'swarm state dir not found: %s\n' "$swarm_dir" > "$work_dir/state-missing.txt" +fi + +mkdir -p "$(dirname "$out_file")" +tar -czf "$out_file" -C "$work_dir" . +printf 'archive written: %s\n' "$out_file" diff --git a/skills/auto-tmux/scripts/validate-auto-tmux.sh b/skills/auto-tmux/scripts/validate-auto-tmux.sh index 6e3923a..749f419 100755 --- a/skills/auto-tmux/scripts/validate-auto-tmux.sh +++ b/skills/auto-tmux/scripts/validate-auto-tmux.sh @@ -81,6 +81,7 @@ scripts=( "$script_dir/swarm-state.sh" "$script_dir/swarm-brief.sh" "$script_dir/swarm-watch.sh" + "$script_dir/swarm-archive.sh" "$script_dir/render-swarm-prompt.sh" "$script_dir/swarm-dispatch.sh" "$script_dir/auto-tmux-smoke-test.sh" @@ -95,21 +96,25 @@ run_gate "auto-tmux help" "$script_dir/auto-tmux.sh" help run_gate "swarm-state help" "$script_dir/swarm-state.sh" help run_gate "swarm-brief help" "$script_dir/swarm-brief.sh" --help run_gate "swarm-watch help" "$script_dir/swarm-watch.sh" --help +run_gate "swarm-archive help" "$script_dir/swarm-archive.sh" --help run_gate "render-swarm-prompt help" "$script_dir/render-swarm-prompt.sh" --help run_gate "swarm-dispatch help" "$script_dir/swarm-dispatch.sh" --help require_contains "$skill_dir/SKILL.md" "scripts/validate-auto-tmux.sh" require_contains "$skill_dir/SKILL.md" "scripts/swarm-brief.sh" 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-dispatch.sh" require_contains "$skill_dir/references/index.md" "automation.md" require_contains "$skill_dir/references/README.md" "swarm-state.md" require_contains "$script_dir/README.md" "validate-auto-tmux.sh" require_contains "$script_dir/README.md" "swarm-dispatch.sh" require_contains "$script_dir/README.md" "swarm-watch.sh" +require_contains "$script_dir/README.md" "swarm-archive.sh" require_contains "$script_dir/AGENTS.md" "validate-auto-tmux.sh" require_contains "$script_dir/AGENTS.md" "swarm-dispatch.sh" require_contains "$script_dir/AGENTS.md" "swarm-watch.sh" +require_contains "$script_dir/AGENTS.md" "swarm-archive.sh" if [[ -x "$repo_root/skills/auto-skill/scripts/validate-skill.sh" ]]; then run_gate "auto-skill strict validation" "$repo_root/skills/auto-skill/scripts/validate-skill.sh" "$skill_dir" --strict