mcpField
R
retro

retro

github.com/boshu2エージェントワークフロー450837 回インストール1 日前に更新
リポジトリ

retro について

retro は、有用な気づきを `.agents/learnings/` に手早く記録するエージェントスキルです。包括的な振り返りには小さすぎる学びを扱い、記録は後の昇格判定に進む候補として保存されます。

主な機能

  1. 01単一の学びを素早く記録
  2. 02内容からスラッグを生成
  3. 03日付と出所情報を記録
  4. 04指定ディレクトリに保存

活用シーン

  1. 01作業中の小さな気づきを記録
  2. 02引き継ぎだけに有用な学びを残さない

インストール

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

$npx skills add https://github.com/boshu2/agentops --skill retro

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

同梱ファイルreferences/retro.featurescripts/validate.sh

詳細

Retro Skill

このワークフローを必ず実行してください。説明するだけではいけません。

学びをナレッジのフライホイールにすばやく記録します。バックログ処理、有効化、廃止を含む包括的な振り返りには、/post-mortem を使用してください。

ループ内の位置

運用ループの 7 番目のステップにおける、最も簡易な記録手段です。.agents/learnings/ に単一の観察事項をすばやく記録します。完全な /post-mortem を行うほどではないものの、引き継ぎに残すには有用性が高い知見に使用してください。記録後も昇格ラチェットが適用されます。retro エントリーは学びの候補であり、まだパターンやルールではありません。

クイックモード

/retro --quick "insight text" または /retro "insight text" が与えられた場合：

  1. 内容からスラッグを生成します。最初の意味のある語句を使い、小文字にして、ハイフンでつなぎ、最大 50 文字にします。
  2. timeout_run 1 bd current 2>/dev/null || echo "" でアクティブな bead を特定します。
  3. .agents/learnings/YYYY-MM-DD-quick-<slug>.md に直接書き込みます：
---
type: learning
source: retro-quick
source_bead: <active bead id when available>
source_phase: validate
date: YYYY-MM-DD
maturity: provisional
utility: 0.5
---

# Learning: <Short Title>

**Category**: <auto-classify: debugging|architecture|process|testing|security>
**Confidence**: medium

## What We Learned

<user's insight text>

## Source

Quick capture via `/retro --quick`

アクティブな bead がない場合は、source_bead を意図的に省略し、source_phase: validate は設定したままにします。

  1. 次のように確認します：
Learned: <one-line summary>
Saved to: .agents/learnings/YYYY-MM-DD-quick-<slug>.md

For comprehensive knowledge extraction, use `/post-mortem`.

完了です。 確認後、ただちに応答を終了してください。

例

ユーザーの入力： /retro --quick "macOS cp alias prompts on overwrite — use /bin/cp to bypass"

実行内容：

  1. エージェントがスラッグを生成します：macos-cp-alias-overwrite
  2. エージェントが timeout_run 1 bd current 2>/dev/null || echo "" でアクティブな bead を特定します。
  3. エージェントが、次のような来歴フィールドを含む学びを .agents/learnings/2026-03-03-quick-macos-cp-alias-overwrite.md に書き込みます：
---
type: learning
source: retro-quick
source_bead: bd-123
source_phase: validate
date: 2026-03-03
maturity: provisional
utility: 0.5
---
  1. エージェントが確認します：Learned: macOS cp alias prompts — use /bin/cp

トラブルシューティング

問題原因解決策
学びが一般的すぎる表面的な記録具体的に記述します。「認証について学んだ」ではなく、「認証トークンは 1 時間後に期限切れになる」とします
学びが重複する同じ知見を 2 回記録した書き込む前に grep で既存の学びを確認します
完全な振り返りが必要クイック記録では不十分包括的な抽出と処理には /post-mortem を使用します

参考ドキュメント

  • references/retro.feature — 実行可能な仕様：.agents/learnings/ への単一観察事項の記録、ラチェット適用前の候補、最も簡易な 7 番目のステップ（soc-qk4b）

コメント

Markdown 対応