Communityコーディング&開発github.com

계획 기반 구현 노트 : m_impl

plan/<ID>_plan_*.md の計画に従って実装し、中核設計と計画からの変更理由を実装ノート impl/<ID>_impl_<エージェント>-<モデル>.md に記録します。--review を指定すると実装後に m_review 相互レビューまで続けて行います。使い方: /m_impl <ID> [--review <claude|codex|agy> [モデル]]

계획 기반 구현 노트 : m_impl とは?

m_impl は、AI エージェントが計画ドキュメント (plan/<ID>_plan_*.md) に基づいてコードを実装し、その過程と計画からの乖離を構造化された実装ノート (impl/<ID>_impl_<エージェント>-<モデル>.md) に記録するためのスキルです。主な目的は、計画と実装のトレーサビリティを確保し、設計判断の理由を明示することです。対応するエージェントは Claude Code、Codex、Aider などで、任意のモデルと組み合わせて使用できます。ワークフローは、まず計画を読み込み未確定の決定事項があれば確認、次にテンプレートに沿って実装ノートを起稿、マイルストーンごとに自己検証(assert ベースのテストや実際の実行)を行いながら実装を進め、最後に計画からの変更理由・検証結果・残課題を記録してコミットします。--review フラグを付けると、実装完了後に自動的に m_review スキルを呼び出し、別エージェントによる相互レビューに移行します。これにより、実装の一貫性と品質が向上します。

対応✓Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/saibi/gen_kor_subtitle/tree/HEAD/.agents/skills/m_impl

Installed? Explore more コーディング&開発 skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

m_impl — 計画通りに実装し記録する

入力

  • <ID>: 実装する計画 ID。plan/<ID>_plan_*.md が存在しない場合は /m_plan を先に行うよう案内して中断する。
  • --review <エージェント> [モデル]: 実装完了後に m_review スキルの手順を続けて実行する。

手順

  1. 計画確認: plan/<ID>_plan_*.md と AGENTS.md を読む。計画文書を修正する場合は、AGENTS.md の作成者表記ルールに従って変更記録を残す。確定(✅)されていない決定事項があれば、実装前に m_plan の方式(選択肢+推奨案、1つずつ)で問い合わせる。
  2. 実装ノート開始: 下記テンプレートで impl/<ID>_impl_<エージェント>-<モデル>.md を作成し(既に別エージェントのノートが存在する場合は新規作成せず、そのファイルに変更記録を残しながら追記する)、アーキテクチャの初案を記述する。
  3. マイルストーン順に実装: 各マイルストーンを完了するたびに
    • 小さな自己検証を残す(test_*.py の assert ベースの検査、または実際の実行)。外部サービス・CLI 連携は実際の実行で最低1回確認する。
    • 実装ノートの 進捗記録 に核心のみ1~3行記述する(何を実施し、どのように確認したか)。些細な修正は記述しない。
  4. 完了処理:
    • 実装ノートの 計画との変更 に、計画と異なる点ごとに 状況 と 根本理由 を記述する。検証結果 と 残された制約 も記入する。
    • 計画文書にも反映する(保留・変更のマーク)。plan/README.md の状態を 実装完了 に変更する。
    • README などユーザー向け文書を更新する。
    • コミットする(メッセージルールは AGENTS.md に従う)。レビューはこのコミットを基準に行うため、コミットハッシュを実装ノートに記述する。
  5. --review が指定された場合: .agents/skills/m_review/SKILL.md を読み、その手順をそのまま実行する。

テンプレート (impl/<ID>_impl_<エージェント>-<モデル>.md)

# [<ID>] 実装ノート

- 計画: plan/<ID>_plan_<エージェント>-<モデル>.md
- 実装コミット: <ハッシュ>(レビュー反映コミットは review/<ID>_refine_*.md)

## アーキテクチャ
<ファイル構成、主要モジュール/関数の役割、データフロー。ダイアグラムや表で簡潔に>

## 中核設計決定
- <決定> — <理由>

## 進捗記録
- <ID>-M1: <実施内容と確認方法>

## 計画との変更
| 項目 | 計画 | 最終実装 | 状況と根本理由 |
| :--- | :--- | :--- | :--- |

## 検証結果
<自己検証、実際の実行で確認したことと確認できなかったこと>

## 残された制約
- <既知の制約と改善の方向性>

Individual skills in this repo

This repo contains 2 individual skills — each has its own dedicated page.

関連スキル