From fbc82f5ba525e4759ed91203bdd7a332c3ccb36d Mon Sep 17 00:00:00 2001 From: tukuaiai Date: Tue, 19 May 2026 04:08:21 +0800 Subject: [PATCH] feat: skills - summarize auto-tmux records --- skills/auto-tmux/AGENTS.md | 4 +- skills/auto-tmux/README.md | 1 + skills/auto-tmux/SKILL.md | 5 +- skills/auto-tmux/references/automation.md | 3 + .../auto-tmux/references/iteration-roadmap.md | 4 +- skills/auto-tmux/scripts/AGENTS.md | 2 + skills/auto-tmux/scripts/README.md | 4 + .../auto-tmux/scripts/auto-tmux-smoke-test.sh | 10 +- skills/auto-tmux/scripts/auto-tmux.sh | 2 +- skills/auto-tmux/scripts/record-summary.sh | 100 ++++++++++++++++++ .../auto-tmux/scripts/validate-auto-tmux.sh | 5 + 11 files changed, 134 insertions(+), 6 deletions(-) create mode 100755 skills/auto-tmux/scripts/record-summary.sh diff --git a/skills/auto-tmux/AGENTS.md b/skills/auto-tmux/AGENTS.md index 1096946..7b3679d 100644 --- a/skills/auto-tmux/AGENTS.md +++ b/skills/auto-tmux/AGENTS.md @@ -19,6 +19,7 @@ skills/auto-tmux/ │ ├── swarm-archive.sh │ ├── swarm-board.sh │ ├── swarm-assign.sh +│ ├── record-summary.sh │ ├── safety-check.sh │ ├── render-swarm-prompt.sh │ ├── swarm-dispatch.sh @@ -49,6 +50,7 @@ skills/auto-tmux/ - `scripts/swarm-archive.sh` 是归档层，打包 brief、snapshot 和 swarm state 供复盘交接。 - `scripts/swarm-board.sh` 是看板层，将任务、依赖、锁和状态日志渲染为 Markdown。 - `scripts/swarm-assign.sh` 是分配建议层，将 ready task 轮询映射到 worker pane。 +- `scripts/record-summary.sh` 是复盘摘要层，将 pane 录制日志整理为 Markdown。 - `scripts/safety-check.sh` 是安全预检层，检查待发送 payload 的危险命令、敏感信息和大小。 - `scripts/render-swarm-prompt.sh` 是提示词渲染层，生成 commander/worker/reviewer 协议文本。 - `scripts/swarm-dispatch.sh` 是提示词下发层，默认写文件，显式 `--send` 后才发送到 pane。 @@ -61,4 +63,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/swarm-archive.sh`、`bash -n skills/auto-tmux/scripts/swarm-board.sh`、`bash -n skills/auto-tmux/scripts/swarm-assign.sh`、`bash -n skills/auto-tmux/scripts/safety-check.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/swarm-board.sh`、`bash -n skills/auto-tmux/scripts/swarm-assign.sh`、`bash -n skills/auto-tmux/scripts/record-summary.sh`、`bash -n skills/auto-tmux/scripts/safety-check.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 af9dcc6..4296065 100644 --- a/skills/auto-tmux/README.md +++ b/skills/auto-tmux/README.md @@ -26,6 +26,7 @@ bash -n skills/auto-tmux/scripts/swarm-watch.sh bash -n skills/auto-tmux/scripts/swarm-archive.sh bash -n skills/auto-tmux/scripts/swarm-board.sh bash -n skills/auto-tmux/scripts/swarm-assign.sh +bash -n skills/auto-tmux/scripts/record-summary.sh bash -n skills/auto-tmux/scripts/safety-check.sh bash -n skills/auto-tmux/scripts/render-swarm-prompt.sh bash -n skills/auto-tmux/scripts/swarm-dispatch.sh diff --git a/skills/auto-tmux/SKILL.md b/skills/auto-tmux/SKILL.md index c49eba0..14b3ebb 100644 --- a/skills/auto-tmux/SKILL.md +++ b/skills/auto-tmux/SKILL.md @@ -40,6 +40,7 @@ bash -n skills/auto-tmux/scripts/swarm-watch.sh bash -n skills/auto-tmux/scripts/swarm-archive.sh bash -n skills/auto-tmux/scripts/swarm-board.sh bash -n skills/auto-tmux/scripts/swarm-assign.sh +bash -n skills/auto-tmux/scripts/record-summary.sh bash -n skills/auto-tmux/scripts/safety-check.sh bash -n skills/auto-tmux/scripts/render-swarm-prompt.sh bash -n skills/auto-tmux/scripts/swarm-dispatch.sh @@ -148,6 +149,7 @@ cp -n "$repo_root/skills/auto-tmux/assets/oh-my-tmux/.tmux.conf.local" ~/.tmux.c ```bash skills/auto-tmux/scripts/auto-tmux.sh record start -t :. --dir /tmp/auto-tmux-records skills/auto-tmux/scripts/auto-tmux.sh record stop -t :. +skills/auto-tmux/scripts/record-summary.sh --dir /tmp/auto-tmux-records --out /tmp/auto-tmux-record-summary.md ``` **等待 pane 出现完成信号** @@ -265,6 +267,7 @@ skills/auto-tmux/scripts/swarm-dispatch.sh --role worker --target ::/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 diff --git a/skills/auto-tmux/scripts/auto-tmux.sh b/skills/auto-tmux/scripts/auto-tmux.sh index 3636c69..ca43574 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 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 diff --git a/skills/auto-tmux/scripts/record-summary.sh b/skills/auto-tmux/scripts/record-summary.sh new file mode 100755 index 0000000..765fe81 --- /dev/null +++ b/skills/auto-tmux/scripts/record-summary.sh @@ -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=/g' \ + -e 's/(Bearer[[:space:]]+)[A-Za-z0-9._~+\/=-]+/\1/g' \ + -e 's/(sk-[A-Za-z0-9_-]{12,})//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 diff --git a/skills/auto-tmux/scripts/validate-auto-tmux.sh b/skills/auto-tmux/scripts/validate-auto-tmux.sh index 8679fb7..6c33832 100755 --- a/skills/auto-tmux/scripts/validate-auto-tmux.sh +++ b/skills/auto-tmux/scripts/validate-auto-tmux.sh @@ -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