Obsidian Vault 書き戻しの自動化 — Claude Code hooks と Git フックと GitHub Actions の使い分け

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16

// <proj>/.claude/settings.json
{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Bash",
        "hooks": [
          {
            "type": "command",
            "command": "~/.claude/hooks/detect-pr-merge.sh"
          }
        ]
      }
    ]
  }
}

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20

#!/usr/bin/env bash
# PostToolUse フック: 直前の Bash コマンドが PR マージなら、
# 書き戻しを促す指示をエージェントに注入する

set -euo pipefail

# 標準入力に JSON 形式でツール呼び出し情報が来る
INPUT=$(cat)
COMMAND=$(echo "$INPUT" | jq -r '.tool_input.command // ""')

if echo "$COMMAND" | grep -qE '^gh pr merge'; then
  # stdout に出した内容は、ツール結果としてエージェントの文脈に追加される
  cat <<'EOF'
[automation hint]
PR がマージされました。今回のセッションで得た「他プロジェクトでも再利用できそうな知見」を、
/summary-back-to-vault スキルで個人 Vault の inbox に書き戻してください。
EOF
fi

exit 0

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Bash",
        "hooks": [
          { "type": "command", "command": "~/.claude/hooks/detect-pr-merge.sh" }
        ]
      },
      {
        "matcher": "Write|Edit",
        "hooks": [
          { "type": "command", "command": "~/.claude/hooks/notify-doc-change.sh" }
        ]
      }
    ]
  }
}

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14

{
  "hooks": {
    "Stop": [
      {
        "hooks": [
          {
            "type": "command",
            "command": "~/.claude/hooks/append-daily-log.sh"
          }
        ]
      }
    ]
  }
}

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34

#!/usr/bin/env bash
# Stop フック: セッションで「学び」を産んだら Daily Note の器を用意
set -euo pipefail

INPUT=$(cat)
TRANSCRIPT_PATH=$(echo "$INPUT" | jq -r '.transcript_path // ""')

# 直近のツール呼び出しに gh pr create / git commit があるかをチェック
# 注: transcript は JSONL なので、本番では jq で tool_use.input.command を
# 構造化して取り出すのが安全。下の grep は最短実装の例として割り切る。
if [[ -f "$TRANSCRIPT_PATH" ]] \
   && grep -qE '"gh pr create |"git commit ' "$TRANSCRIPT_PATH"; then

  TODAY=$(date +%Y-%m-%d)
  VAULT_INBOX="$HOME/Documents/ObsidianVault/inbox/daily/$TODAY.md"
  mkdir -p "$(dirname "$VAULT_INBOX")"

  # ファイルが無ければテンプレートで初期化
  if [[ ! -f "$VAULT_INBOX" ]]; then
    cat > "$VAULT_INBOX" <<EOF
---
date: $TODAY
---

## Learned

EOF
  fi

  # フックはあくまで「箱を用意するだけ」。中身は次回エージェントに書かせる
  echo "[automation hint] 今日の Daily Note ($VAULT_INBOX) に '## Learned' エントリを追記してください。"
fi

exit 0

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11

{
  "hooks": {
    "SessionEnd": [
      {
        "hooks": [
          { "type": "command", "command": "~/.claude/hooks/session-log.sh" }
        ]
      }
    ]
  }
}

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24

#!/usr/bin/env bash
# .git/hooks/post-merge
# main ブランチに merge が反映された後だけ動く

set -euo pipefail

# 対話シェル経由の git pull だけを対象にする（CI や別スクリプトを除外）
[[ -t 1 ]] || exit 0

BRANCH=$(git rev-parse --abbrev-ref HEAD)
[[ "$BRANCH" == "main" ]] || exit 0

# 直近の merge commit の説明文
LAST_MERGE=$(git log -1 --merges --format="%B" || true)
[[ -z "$LAST_MERGE" ]] && exit 0

# ログを残し、Claude Code を headless で起動して /summary-back-to-vault を呼ぶ
# 注: 新規セッションなので「いま開いていた会話の文脈」は引き継げない
LOG_DIR="$HOME/.claude/logs"
mkdir -p "$LOG_DIR"
claude -p "/summary-back-to-vault 直近マージ: $LAST_MERGE" \
  --output-format text \
  >> "$LOG_DIR/post-merge-$(date +%Y%m%d).log" 2>&1 &
disown

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55

# .github/workflows/post-merge-summarize.yml
name: Summarize merged PR back to Vault
on:
  pull_request:
    types: [closed]

jobs:
  summarize:
    if: github.event.pull_request.merged == true
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
        with:
          ref: ${{ github.event.pull_request.base.ref }}

      - name: Fetch PR diff and discussion
        env:
          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
        run: |
          gh pr view ${{ github.event.pull_request.number }} \
            --json title,body,comments,files \
            > /tmp/pr-context.json

      - name: Generate summary via Claude API
        env:
          ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}
        run: |
          # ペイロードは必ず jq で組み立てる（PR 本文に " や \ が混ざっても壊れない）
          jq -n \
            --rawfile pr /tmp/pr-context.json \
            --arg model "claude-sonnet-4-6" \
            --arg sys "summary-back-to-vault テンプレートに従う。書き戻し不要なら 'SKIP' とだけ返す。" \
            '{
              model: $model,
              max_tokens: 2048,
              system: $sys,
              messages: [{role: "user", content: $pr}]
            }' > /tmp/payload.json

          curl -sS https://api.anthropic.com/v1/messages \
            -H "x-api-key: $ANTHROPIC_API_KEY" \
            -H "anthropic-version: 2023-06-01" \
            -H "content-type: application/json" \
            -d @/tmp/payload.json > /tmp/summary.json

          jq -r '.content[0].text' /tmp/summary.json > /tmp/summary.md

      - name: Open PR against personal Vault repo
        env:
          VAULT_TOKEN: ${{ secrets.VAULT_REPO_TOKEN }}
        run: |
          # SKIP なら何もしない
          grep -q '^SKIP$' /tmp/summary.md && exit 0
          # /tmp/summary.md を Vault リポジトリの inbox/ にコミットして PR を立てる
          # （リポジトリのクローン、ブランチ作成、gh pr create は省略）