gavindiaz/vibe-coding-cn
1
0
Fork 0
mirror of https://github.com/tradecatlabs/vibe-coding-cn.git synced 2026-08-21 23:08:06 +00:00
Code Issues Packages Projects Releases Wiki Activity

feat: skills - archive auto-tmux swarm handoffs

Browse Source
This commit is contained in:
tukuaiai
2026-05-19 03:48:40 +08:00
parent 3d3e683069
commit f0535d5e0b
11 changed files with 111 additions and 6 deletions
Download Patch File Download Diff File Expand all files Collapse all files
skills/auto-tmux/scripts/AGENTS.md
+2
View File
@@ -12,6 +12,7 @@ scripts/
├── swarm-state.sh # 蜂群状态、任务、锁和报告管理
├── swarm-brief.sh # 只读生成蜂群交接报告
├── swarm-watch.sh # 有限轮次只读巡检和状态采样
├── swarm-archive.sh # 打包 brief、snapshot 和 swarm state
├── render-swarm-prompt.sh # commander/worker/reviewer 提示词渲染
├── swarm-dispatch.sh # 渲染并可选下发蜂群提示词
├── auto-tmux-smoke-test.sh # 临时 tmux 会话端到端自测
@@ -29,6 +30,7 @@ scripts/
- Prompt 下发脚本默认只写文件；真实发送必须显式 `--send`，批量使用前先 `--dry-run`。
- 交接报告脚本只读调用 doctor/topology/scan/report，不直接发送按键。
- 巡检脚本必须是有限轮次，不允许默认无限循环。
- 归档脚本只复制状态和只读证据，不修改 tmux pane 或 swarm state。
- 状态脚本只能写入显式状态目录，不保存密钥、Token、密码或私密项目内容。
- 自测脚本必须创建独立临时 tmux session，并在退出时清理。
- 专属校验脚本必须覆盖脚本权限、语法、help 输出、关键索引、strict 校验和 smoke test。
skills/auto-tmux/scripts/README.md
+4
View File
@@ -8,6 +8,7 @@
- [`swarm-state.sh`](./swarm-state.sh) - 蜂群状态、任务、锁和报告管理。
- [`swarm-brief.sh`](./swarm-brief.sh) - 只读生成蜂群交接报告，汇总 doctor、topology、pane 输出和状态报告。
- [`swarm-watch.sh`](./swarm-watch.sh) - 有限轮次巡检蜂群 pane 输出和状态报告，形成连续证据。
- [`swarm-archive.sh`](./swarm-archive.sh) - 打包 brief、snapshot 和 swarm state，生成可交接归档。
- [`render-swarm-prompt.sh`](./render-swarm-prompt.sh) - commander、worker、reviewer 提示词渲染。
- [`swarm-dispatch.sh`](./swarm-dispatch.sh) - 渲染提示词并可选发送到指定 pane，默认只写文件。
- [`auto-tmux-smoke-test.sh`](./auto-tmux-smoke-test.sh) - 创建临时 tmux 会话，端到端验证脚本能力。
@@ -51,6 +52,9 @@ skills/auto-tmux/scripts/swarm-brief.sh --session ai-hub --swarm-dir /tmp/ai_swa
# 采集 3 轮蜂群巡检证据
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
# 初始化蜂群状态并添加任务
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 链接"
skills/auto-tmux/scripts/auto-tmux-smoke-test.sh
+6 -1
View File
@@ -8,6 +8,7 @@ SWARM_STATE="$SCRIPT_DIR/swarm-state.sh"
RENDER_PROMPT="$SCRIPT_DIR/render-swarm-prompt.sh"
SWARM_BRIEF="$SCRIPT_DIR/swarm-brief.sh"
SWARM_WATCH="$SCRIPT_DIR/swarm-watch.sh"
SWARM_ARCHIVE="$SCRIPT_DIR/swarm-archive.sh"
SWARM_DISPATCH="$SCRIPT_DIR/swarm-dispatch.sh"
SESSION="auto-tmux-smoke-$$"
SWARM_DIR="/tmp/auto-tmux-smoke-swarm-$$"
@@ -15,13 +16,14 @@ SNAPSHOT_DIR="/tmp/auto-tmux-smoke-snapshot-$$"
RECORD_DIR="/tmp/auto-tmux-smoke-record-$$"
BRIEF_DIR="/tmp/auto-tmux-smoke-brief-$$"
WATCH_DIR="/tmp/auto-tmux-smoke-watch-$$"
ARCHIVE_FILE="/tmp/auto-tmux-smoke-archive-$$.tar.gz"
DISPATCH_PROMPT="/tmp/auto-tmux-smoke-dispatch-$$.md"
TASK_IMPORT_FILE="/tmp/auto-tmux-smoke-tasks-$$.txt"
PASTE_FILE="/tmp/auto-tmux-smoke-paste-$$.txt"
cleanup() {
tmux kill-session -t "$SESSION" 2>/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
skills/auto-tmux/scripts/auto-tmux.sh
+1 -1
View File
@@ -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
skills/auto-tmux/scripts/swarm-archive.sh
Executable
+80
View File
@@ -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:-<all>}\`"
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"
skills/auto-tmux/scripts/validate-auto-tmux.sh
+5
View File
@@ -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