mcpField
G
groove-utilities-memory-retrospective

groove-utilities-memory-retrospective

github.com/andreadellacorteエージェントワークフロー6516 回インストール14 週間前に更新
リポジトリ

groove-utilities-memory-retrospective について

Grooveユーザー向けの読み取り専用レトロスペクティブスキルです。指定期間のメモリー、タスクのインシデント、評価、学び、Gitの活動をまとめ、結果は会話にのみ表示します。

主な機能

  1. 01週、月、全期間での集計
  2. 02セッション評価の傾向とスパークライン
  3. 03解決済み・未解決インシデントの要約
  4. 04トピック別の学びの整理
  5. 05Gitコミット数による作業量の目安
  6. 06読み取り専用、会話への出力のみ

活用シーン

  1. 01過去1週間または1か月の作業の振り返り
  2. 02繰り返すミスやワークフローの傾向の把握

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/andreadellacorte/groove --skill groove-utilities-memory-retrospective

インストール後、Claude Code で/groove-utilities-memory-retrospectiveを入力して読み込まれたか確認します。

詳細

groove-utilities-memory-retrospective

期間を指定するには、week（デフォルト）、month、または all を $ARGUMENTS に指定します。

Outcome

期間の振り返りを会話に出力します。セッション評価の推移、繰り返し発生するミスのパターン、記録された主な学び、ワークフローの健全性に関する短い概要を含みます。ファイルは書き込みません。

Acceptance Criteria

  • セッション評価の推移が表示される（learned/signals.md にデータがある場合）
  • ミスのパターンが要約される（タスクバックエンドの解決済みインシデントから）
  • 主な学びがトピック別に一覧表示される（日付付きの learned/*.md エントリから）
  • ワークフローの健全性の概要が示される（全体的な推移を一文で記述）
  • 出力はすべて会話内のみ

Steps

  1. メモリのパスは常に .groove/memory/ です

  2. $ARGUMENTS から日付範囲を決定します。

    • week：過去 7 日間（今日 - 7 日）
    • month：過去 30 日間
    • all：利用可能なすべてのデータ
    • 指定がない場合のデフォルト：week

  3. セッション評価 — .groove/memory/learned/signals.md が存在する場合は読み込みます。

    • 日付範囲に一致するテーブル行を解析します：| YYYY-MM-DD | N/5 | context |
    • 算出する値：件数、平均評価、推移（十分なデータがある場合は直近 3 件と最初の 3 件を比較）
    • データがない場合：「セッション評価はまだ記録されていません」と記載します

  4. ミス — タスクバックエンドで「Groove Memory」→「Mistakes」配下の解決済みインシデントを照会します。

    • 解決済みには beans list --parent <mistakes-epic-id> -t bug -s completed、未解決には -s in-progress を使用します
    • タイトルのキーワードでグループ化し、繰り返し発生するパターンを特定します
    • 解決済みと未解決のインシデントの合計件数を数えます
    • タスクバックエンドまたはデータがない場合：「インシデントはまだ記録されていません」と記載します

  5. 学び — .groove/memory/learned/*.md を glob します（signals.md は除外）。

    • 各ファイルを読み込み、日付範囲内の日付付きエントリ（## YYYY-MM-DD 見出し）を収集します
    • トピック別（ファイル名の拡張子を除いた部分）にグループ化します
    • トピックごとのエントリ数を数え、サンプルとして各トピックの最新の箇条書きを表示します
    • ファイルがない場合：「学びはまだ記録されていません」と記載します

  6. Git のアクティビティ — git log --oneline --since="<start-date>" を実行し、期間内の作業量の目安としてコミット数を数えます

  7. 次の形式で振り返りを会話に出力します。

## Groove Retrospective — <period> (<start-date> to <today>)

### Session Ratings
<count> sessions rated | avg: <N>/5 | trend: <up/down/flat or n/a>
<sparkline of ratings if ≥3 data points, e.g. ▂▄█▆▇>

### Mistakes
<N> incidents resolved | <N> open
Top patterns:
- <root cause pattern> (N occurrences)
- ...
(No recurring patterns) if all unique

### Learnings
<N total entries across <M> topics>
- patterns (<N> entries): <most recent bullet>
- anti-patterns (<N> entries): <most recent bullet>
- ...

### Workflow Health
<git commits in period> commits | <1-sentence summary of overall trend>
e.g. "Stable week — ratings above 4, one incident (resolved), 3 new patterns captured."

スパークラインの生成

ブロック文字を使用して、評価の簡単なスパークラインを表示します。

  • 1/5 → ▁、2/5 → ▂、3/5 → ▄、4/5 → ▆、5/5 → █
  • 期間内に評価が 3 件以上ある場合のみ表示します

制約

  • 読み取りのみ — ファイルには書き込まないでください
  • データソースのファイルがない場合は、そのセクションを一行の注記で適切に省略してください
  • テーブル行は安全に解析し、不正な形式の行はエラーにせずスキップしてください
  • 日付のフィルタリング：YYYY-MM-DD の日付が範囲内にある行を対象とし、有効な日付がない行はスキップしてください
  • 出力は会話内のみ — AGENTS.md やメモリファイルには決して書き込まないでください

コメント

Markdown 対応