ホーム / 全スキル / ワークフロー＆基本ツール / retro
English (EN)简体中文 (ZH)日本語 (JA)
ワークフロー＆基本ツール · mattpocock/skills

retro

Conduct a retrospective on a coding session.

L2 ローカル · 作業ディレクトリ限定V1 コミット固定ファイル書き込みDual-pass Audit
Author mattpocockGitHub mattpocock/skills ↗Stars 257659License MIT（GitHub API spdx MIT；仓库根 LICENSE: Copyright (c) 2026 Matt Pocock）Commit 3cca18b368
管理レベルは Skill の能力と推奨統制措置を示すものであり、品質や安全性の認証、利用可否の判定ではありません。使用の可否はユーザーおよび管理者が決定します。Agent 環境によって制約が異なるため、自動保護を仮定しないでください。第三者製 Skill の著作権は原著作者に帰属し、利用リスクは利用者が負います。

1仕組みと動作原理

振り返りの対象はコードではなく coding agent の実行環境：目的は agent 環境の改善提案を行い、将来の実行効率を高めること。

skills/in-progress/retro/SKILL.md
The user has asked for a **retrospective**. You are suggesting improvements to the coding agent's **environment** to improve future runs.
code-review（差分レビュー）とは根本的に異なる：retro はセッションを観察サンプルとして扱い、環境改善の候補を出力する。

文体基準を委託：最初のステップで writing-for-agents（リポジトリ内の model-invoked 向けライティングガイド skill）を呼び出し、改善提案の記述スタイルを統一する。

skills/in-progress/retro/SKILL.md
Call the Skill tool with `writing-for-agents` for the writing style guide.
writing-for-agents は skills/productivity/ に配置された model-invoked（openai.yaml に policy ブロックなし）であり、retro（user-invoked）からの呼び出しは規約上問題ない。

エビデンスソース = セッション主ソース/ローカルセッションログ：ユーザー指定の session 記録を読み込み（ローカルで session logs を検索する可能性あり）、未指定時は現在のセッションをデフォルトとする。

skills/in-progress/retro/SKILL.md
Read the primary sources for the session the user specifies. This may mean searching through session logs on this machine. If the user doesn't specify a session, default to the current one.
これが本 skill の唯一のデータ取り込みアクション：ローカル読み取りのみで、ネットワーク通信は発生しない。

7つの改善シグナルをスキャン：navigation / automated checks / coding standards / global AGENTS.md / tool economy / no-ops / information access の各カテゴリに「いつ使うか」の判定基準が付属。

skills/in-progress/retro/SKILL.md
**Navigation**: how easy was it for the agent to find the right files? Are there hidden dependencies between files? Would a **navigation pointer** make it easier? _Use when_ the session took a long time to find a piece of information.
残り6つも同一構造：Automated checks（_Use when_ the agent made a mistake that could have been caught by an automated check）、Coding standards（レビュアー agent が見逃した時）、Global AGENTS.md（ファイルが肥大化した時）、Tool economy（高コストなツール呼び出し時）、No-ops（steering ファイルが肥大化し効果がない時）、Information access（重要な情報にアクセスできない時）。

出力は深刻度順にソートしてユーザーに提示され、「実装 vs レビュー」の責務モデルが付属：実装 agent の context 負荷が最も高く、レビュー agent の負荷が最も低い → コーディング規約は実装側ではなくレビュー側で強制すべきである。

skills/in-progress/retro/SKILL.md
The review agent has the least context pressure - it receives a diff, so no exploration needed. It often does not need to write code or debug. This means that the review agent should be responsible for imposing coding standards, not the implementation agent.
ファイルの責務レイヤリング（Reference > Files）：CLAUDE.md/AGENTS.md は navigation pointers としてのみ使用し、CODING_STANDARDS.md はレビュー時に読み込み（1000行超はナビゲーションポインタを追加）、docs は参照ファイル、skills は context に取り込むドキュメントまたはユーザーコマンド用。

2コア機能

01指定されたまたは現在の coding session の振り返りを実施し、ローカルセッションログからエビデンスを取得
027つの環境改善候補のスキャン（navigation/automated checks/coding standards/AGENTS.md/tool economy/no-ops/information access）
03深刻度順にソートされた改善提案の出力
04writing-for-agents スタイルガイドを再利用した提案テキストの標準化
05リポジトリファイルの階層別責務モデルの提示（CLAUDE.md/CODING_STANDARDS/docs/skills それぞれの用途）

4推奨統制措置と判定根拠

安全運用のための推奨統制措置
Agent 向け
作業ディレクトリを限定
管理者向け
操作ログを保持
判定根拠（ファイルパスと抜粋）
  • 本地文件: ローカルプロジェクトファイルまたは作業ディレクトリ成果物の操作
監査ノート： ローカルのセッション/ファイル/履歴の読み取りのみで、外部送信、認証情報へのアクセス、ファイル書き込み命令は一切ありません（提案はユーザー向けのリストとして出力され、適用は別途手動で行う）。留意事項：セッションログにはシークレットや PII が含まれる可能性があるため、出力時のマスキングが推奨されます（skill 上で明示的な指示はありません）；STUB/実験的ステータスかつホストのログ形式に依存するため、動作が変動する可能性があります。

5二重目の独立検証

  • [ok] 七类改进候选 + 每类 Use-when 判据 — SKILL.md Step 3 七类全列（Navigation/Automated checks/Coding standards/Global AGENTS.md/Tool economy/No-ops/Information access），各带 _Use when_ 条件。
  • [ok] 读取会话日志（本机） — 'This may mean searching through session logs on this machine. If the user doesn't specify a session, default to the current one.' 原文在。
  • [ok] 调 writing-for-agents 文体指南 — 'Call the Skill tool with `writing-for-agents` for the writing style guide.' 原文在；writing-for-agents 为 model-invoked，调用合规。
  • [ok] 按严重度呈现给用户 — 'Present these candidates to the user, in order of severity.' 原文在。
  • [ok] 无写文件/无网络/无凭证 — 全文 token 扫描零命中写文件类与网络类指令；输出是给用户的候选清单。
  • [discrepancy] README STUB 标注 vs SKILL.md 完整步骤（找茬点） — in-progress/README.md 标 retro 为 'STUB: design notes only, not functional yet'，但同 pin 的 SKILL.md 已是完整可执行步骤（Step 1-4 + Reference 模型）。判断为 README 滞后于 SKILL.md 或作者仍视为设计稿；已在 traits/risks 如实标注，不替作者定性。
  • [ok] 元数据 + beta 状态 — GitHub API MIT/257659/2026-09-04；本地 HEAD == 3cca18b；in-progress README 列 beta。

6結論

  • ユニークな振り返り対象：コードではなく agent の実行環境をレビューし、code-review と相互補完の関係を構築。
  • 7つの実用的なシグナルと Use-when 判定基準により、曖昧な「振り返り」を構造化されたスキャンに変換。
  • 明確な責務モデル：context 負荷の観点からコーディング規約を強制すべき主体（レビュー側）を決定し、最小限に保つファイル階層設計（CLAUDE.md のスリム化）を直接再利用可能。
  • 抑制された出力：ソート済みの候補リストを提示するのみで、ユーザーの steering ファイルを勝手に書き換えない。
    • 最適な用途： agent を日常的に活用している開発者（週次や大型機能の実装後など）：自身の steering ファイル、コーディング規約、自動チェック、ツール設定を体系的に改善し、「今回のセッションで滞った点」を実行可能な環境改善リストに昇華させたい場合に最適。
    不向きな用途： コード自体のレビューを求めるユースケース（code-review を選択すべき）；ホスト環境が可読なセッションログを保持していない環境；skill による AGENTS.md や CODING_STANDARDS.md の直接書き換えを期待するユーザー（提案リストの提示のみ）；STUB 表記があるため、本番クリティカルなフローへの組み込み。
    Install Agent-Ready
    ① Verified Mirror 2026-09-09
    Option A · Direct DownloadDownload retro.tar.gz
    sha256: d1a796d39173a1c6…
    Option B · Copy Guide for Agent
    install.json
    Agent はこの JSON ガイドから自動的にダウンロードして検証します。
    ② Upstream GitHub
    GitHub Repo ↗
    Pinned to commit 3cca18b368.