mcpField
C
chief-retro

chief-retro

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

chief-retro について

chief-retroは、マイルストーンの目標と契約に照らして完了作業を確認し、バッチまたはマイルストーンの振り返りレポートを作成します。プロジェクトのレポートとGit履歴を参照し、ルール変更案はユーザーの承認後に適用します。

主な機能

  1. 01バッチまたはマイルストーンの範囲判定
  2. 02目標と契約の達成状況確認
  3. 03レポートとGit履歴の確認
  4. 04振り返りレポートの作成
  5. 05ルール更新に承認を要求

活用シーン

  1. 01完了したタスクバッチの振り返り
  2. 02マイルストーン全体の達成状況の評価
  3. 03振り返りからルール変更案を提示

インストール

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

$npx skills add https://github.com/thaitype/chief --skill chief-retro

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

詳細

現在のマイルストーンの振り返りを実施します。

対象範囲の判定

対象範囲を自動的に判定します。

  1. アクティブなマイルストーンの _plan/_todo.md を読みます。
  2. すべてのタスクに [x] が付いている場合 → マイルストーンの振り返り。
  3. 未完了のタスクがある場合 → バッチの振り返り(直近の完了済みバッチのみを対象とします)。

入力ソース

バッチの振り返り
  • 最新の _report/autopilot-run-batch-<N>.md
  • _plan/_todo.md(完了済みタスクと未完了タスク)
  • _goal/ および _contract/ のファイル
  • 前回のバッチレポート(またはマイルストーン開始)以降のコミットを示す git log
マイルストーンの振り返り
  • すべての _report/ ファイル(バッチレポート、タスクの出力など)
  • _plan/_todo.md(全履歴)
  • _goal/ および _contract/ のファイル
  • マイルストーン全体の git log

レポートのセクション

以下のセクションでレポートを作成します。

# Retro: <milestone> — <batch N | milestone>

## Coverage Check

For each goal and contract file, check whether the work done satisfies it:

| File | Status | Notes |
|------|--------|-------|
| _goal/xxx.md | ✅ Satisfied / ⚠️ Partial / ❌ Missing | what's done or missing |
| _contract/xxx.md | ✅ / ⚠️ / ❌ | ... |

## Planned vs Delivered

- What was in the TODO
- What was actually completed
- What was skipped or changed mid-execution

## Blockers Hit

- Issues encountered during execution
- How they were resolved (or not)

## Lessons Learned

- Patterns observed (good and bad)
- Recurring problems
- Surprises or unexpected outcomes
- What worked well and should be repeated

## Proposed Rule Updates

For each proposal:
- **What:** the rule to add or change
- **Where:** which file in `.chief/_rules/` (e.g. `_standard/auth.md`, `_verification/tests.md`)
- **Why:** what happened that motivates this rule
- **Suggestion:** recommended for the user

## User Action Needed

Items requiring human decision:
- Uncovered goals or contracts that need another batch
- Decisions to promote to permanent rules
- Manual steps that automation couldn't handle

出力ファイル

  • バッチの振り返り → .chief/<milestone>/_report/retro-batch-<N>.md
  • マイルストーンの振り返り → .chief/<milestone>/_report/retro-milestone.md

<N> には、振り返りの対象となるバッチ番号を指定します。

レポート作成後

ルールの更新案をユーザーに提示します。次のように尋ねます。

「このルール案を適用しますか?」

  • ユーザーが適用する案を選びます。
  • 承認された案ごとに、.chief/_rules/ 内のファイルを作成または更新します。
  • 却下された案は、レポートにのみ残します。

ルール

  • カバレッジチェックを絶対に省略しないでください。これが振り返りの主な価値です。
  • ルールの更新案を絶対に自動適用しないでください。必ず先にユーザーに確認してください。
  • ゴール、コントラクト、計画は絶対に変更しないでください。振り返りではこれらを読み取り専用とし、更新できるのは _rules/ のみです。
  • 実際の git log とファイルの内容を使用してください。記憶をもとに要約してはいけません。
  • ルールの優先順位に従ってください:AGENTS.md > .chief/_rules > マイルストーンのゴール。

コメント