reflection — 週次リフレクション生成(Phase2)
spec: obsidian-ssot/docs/superpowers/specs/2026-08-16-reflection-skill-phase2-design.md
対象読者: 生成するLLM自身。手順を厳密に守ること(品質は手順で担保)。
トリガーワード
「リフレクション」「今週の振り返り」「思考癖まとめて」/reflection
Phase 0: 対象週決定(1実行=1週)
REF_DATE=$(TZ=Asia/Tokyo date -d "last sunday" +%F)
WEEK=$(TZ=Asia/Tokyo date -d "$REF_DATE" +%G-W%V)
ls ~/projects/obsidian-ssot/40_CAREER/リフレクション/weekly/$WEEK.md 2>/dev/null && echo "存在: 対象は次の未生成完了週"
- 対象 = 未生成の完了週のうち最も古い週(通常は上記 $WEEK)
- 対象週ファイルが既に存在する場合: ユーザーに「再生成(置換)か別の週か」を確認
- 1回の実行で生成するのは1週分のみ(複数週未生成でもまとめ生成はしない)
Phase 1: 想起トリガー(記憶鮮度の機械的補完)
対象週(月〜日)の日記 10_DAILY/YYYY-MM-DD.md を読み、主要トピックを箇条書きで先に列挙してから本文生成に入る(いきなり書き始めない)。
Phase 2: 前週Wファイル読込
- 前週 = 対象週のISO週−1(
date -d "$REF_DATE -7 days" +%G-W%V) - 前週ファイルが存在しない場合(初回・スキップ週): 繰越・アドバイス評価をスキップし新規作成として処理
Phase 3: 4要素生成
テンプレ: 40_CAREER/リフレクション/weekly/_テンプレート.md / 品質基準(few-shot): weekly/2026-W33.md を必ず読む
- 📊 作業の傾向・時間の使い方(集中プロジェクト・反復パターン・時間帯)
- 🧠 思考・意思決定の癖(sentaku/multi-llm-review使用傾向・重視した原則)
- ⚠️ 繰り返す課題・弱点(過去週との連続性に注意)
- 💡 CCからのアドバイス(翌週実行可能な具体アクション)
思考ルール(厳守):
- 「なぜ」を3回深掘りする。事象の羅列を禁止(日記の要約コピーレベルで終わらない)
- 前週のCCアドバイスは 実行/未実行/部分実行 をすべて明記(自己擁護禁止・未実行を正直に)
- 持ち越しは2セクションに物理分離: 「前週からの繰越(評価対象)」と「次週への申し送り(新規作成)」
- commitハッシュ・日時など具体例を必ず付ける
Phase 4: 品質チェック(機械判定・生成物に適用)
§4.5チェックリスト5項目(事実羅列でないか/具体例あり/CC実行可能/前回一貫性/持ち越し明示)+以下:
| # | チェック | 閾値 |
|---|---|---|
| ① | 具体エピソード(日付・固有名詞付き)の引用数 | ≥3件 |
| ② | 前週Wファイルと同一・類似の文 | ≤2文 |
| ③ | 前週アドバイスの実行/未実行/部分実行の明記 | すべて |
- 軽微な⚠️(例: ②が3文): 警告行を付けてPhase 5へ
- 重大な⚠️(①<3件): 会話内にドラフトを表示して停止。ファイル作成せずユーザーの修正指示を待つ→修正後にPhase 5へ
Phase 5: commit & push(未承認Top3込み・1回のcommit)
weekly/$WEEK.md作成(frontmatter: type/week/period/generated/sources + 本体 + 末尾に## Top3候補(未承認)セクション)- 日記(対象週の日付ファイル群)に
## 週次リフレクション反映 ($WEEK)見出しでサマリー追記。再生成時は同見出し($WEEK厳密一致)のセクションを置換(冪等) _INDEX.mdfrontmatter にpending_top3: $WEEKを追加- commit & push(obsidian-ssot・git add はファイル個別指定):
git add 40_CAREER/リフレクション/weekly/$WEEK.md 40_CAREER/リフレクション/_INDEX.md 10_DAILY/<対象日付群>→git commit -m "reflection: $WEEK 週次リフレクション生成(Top3未承認)"→git push
Phase 6: Top3承認(D′案・先に記録して後から消す)
未承認状態は既にcommit済み。therefore:
- 同一セッションにユーザーがいる場合: Top3の3行ドラフトを表示 →
y/修正指示を待つ - 承認時:
_INDEX.mdの「気づきTop3」を差替 +pending_top3を削除 +top3_last_updated: $WEEKを更新 → 別commit & push(reflection: $WEEK Top3承認反映) - ユーザーが反応しなければそのまま終了(何もしなくてよい — 次回 resume-session が検知して再依頼する)
Phase 7: 試行モード(最初の2回のみ・W34/W35)
生成完了報告時に「W33(手動生成)と比べた品質ギャップを5段階で評価してください」を依頼する。評価≤3なら機械チェック項目の追加を提案。W36以降は本Phaseをスキップ(SKILL.mdから本Phaseを削除してよい)。
月次モード(拡張ポイント・未実装)
月次俯瞰が必要になったら(=週次で「中長期トレンドが見えない」と感じたら)本スキルの月次設計を再考する。それまで実装しない。
関連
- spec: 上記 / 正典:
40_CAREER/リフレクション/_INDEX.md/ テンプレ:weekly/_テンプレート.md - resume-session が未生成完了週を検知・提案する(本スキルは検知ロジックを持たない)