agent-diff-guard: Skill for Claude Code

/morning-guard-triage

设计一次，每天自动跑。这是 agent-diff-guard Loop Guard 层的标准晨间巡查 skill——呼应 Loop Engineering 的核心理念：agent 在你睡觉时持续迭代，你醒来时需要一份精确到"该看什么"的简报，而不是翻阅 50 条 commit log。

---

标准 Morning Triage Loop 形状（Osmani 框架）

┌────────────────────────────────────────────────────────┐
│  Morning Triage Loop                                   │
│                                                        │
│  1. list sessions   →  找出昨日 / 活跃的 loop session  │
│  2. report per session  →  生成晨报（drift/budget/findings）│
│  3. aggregate        →  汇总 block/warn 项到 PROGRESS.md│
│  4. [可选] worktree  →  为值得修复的项创建隔离分支      │
│  5. [可选] notify    →  推送摘要到 Slack / Linear       │
└────────────────────────────────────────────────────────┘

每个步骤独立可跳过，无副作用（只读 + 写本地文件），适合作为 cron job 或 Claude Code /loop 的 post-iteration hook 运行。

---

步骤详解与 Bash 命令示例

步骤 1：读昨日所有 loop session

# 列出所有 session（JSON 格式便于后续处理）
SESSIONS=$(agent-diff-guard loop list --json)

# 筛选昨日活跃 / 今日仍在运行的 session（jq 过滤）
ACTIVE_IDS=$(echo "$SESSIONS" | jq -r '.[] | select(.status == "active" or .status == "emergency-braked") | .id')

echo "待巡查 sessions："
echo "$ACTIVE_IDS"

步骤 2：对每个 session 生成晨报

REPORT_DIR=".agent-guard/morning-$(date +%Y%m%d)"
mkdir -p "$REPORT_DIR"

for SID in $ACTIVE_IDS; do
  # 生成 JSON 晨报（含 topFindings / driftSummary / budgetSummary / recommendation）
  agent-diff-guard loop report --session "$SID" --json > "$REPORT_DIR/$SID.json"

  # 同时生成人类可读版本
  agent-diff-guard loop report --session "$SID" > "$REPORT_DIR/$SID.txt"

  echo "✓ $SID 晨报已写入 $REPORT_DIR/"
done

generateReport() 输出字段说明（来自 src/loop/report.ts）：

字段	含义
topFindings	Top-5 高频发现（rule × path × count）
driftSummary.status	stable / drifting / diverged
budgetSummary.budgetPct	token 消耗百分比
recommendation	continue / review-and-continue / rollback / stop
emergencyBrakeTriggered	是否触发了紧急制动

步骤 3：汇总高风险项 → PROGRESS.md 状态文件

PROGRESS_FILE="MORNING-TRIAGE-$(date +%Y%m%d).md"

{
  echo "# Morning Guard Triage — $(date +%Y-%m-%d)"
  echo ""
  echo "> 自动生成。verdict=block 的项需人工确认。"
  echo ""

  for SID in $ACTIVE_IDS; do
    R="$REPORT_DIR/$SID.json"
    echo "## $SID"
    echo "- recommendation: $(jq -r '.recommendation' "$R")"
    echo "- drift: $(jq -r '.driftSummary.status' "$R") / $(jq -r '(.driftSummary.currentDrift * 100 | floor | tostring) + "%"' "$R")"
    echo "- budget: $(jq -r '(.budgetSummary.budgetPct * 100 | floor | tostring) + "%"' "$R") used"
    echo "- emergency_brake: $(jq -r '.emergencyBrakeTriggered' "$R")"
    echo ""
    echo "### wake-you-up 发现"
    jq -r '.topFindings[] | select(.severity=="wake-you-up") | "- [ ] `\(.rule)` @ `\(.path)` ×\(.count)"' "$R"
    echo ""
  done
} > "$PROGRESS_FILE"

echo "✓ 状态文件：$PROGRESS_FILE"