miko.catchup-system-hld
system_high_level_design.md をコードベースの現状に追従させる。
- License 许可
- MIT
- 所属仓库
- studyplus/miko
- 最近更新
- 2026-11-10
- Stars
- ★ 22
- Forks
- 1
01 前言 Front Matter
- description
- system_high_level_design.md をコードベースの現状に追従させる。
03 SKILL.md 正文
入力
$ARGUMENTS
入力は不要(引数があれば無視する)。
このスキルの役割
miko/system_high_level_design.md がコードベースの現状と乖離していないかチェックし、必要に応じて更新する。
miko.setup が初回生成を担うのに対し、このスキルはその後のメンテナンスを担う。ディレクトリ構成の変化、新しいレイヤーやAPI構造の追加、フレームワークのアップグレード等を検出して反映する。
出力: miko/system_high_level_design.md(更新がある場合のみ)
手順
1. 既存ファイル確認
miko/system_high_level_design.mdが存在するか確認する- 存在しない場合はエラーとして中止する:
⛩️
miko/system_high_level_design.mdが見つかりません。 初回セットアップは/miko.setupをお使いください。
2. ガイドと参考資料の読み込み
以下のファイルを読み込む。
再読み込みの省略: .miko/ 配下のガイド・サンプルは、このセッションで全文を読み込み済みで、その全文が現在のコンテキストに残っていれば読み直さない。要約しか残っていない(コンテキストが圧縮・要約された後など)、または確信が持てなければ読み直す。miko/ 配下のプロジェクト文書は対象外で、毎回読み込む。
指示書(必須):
.miko/guides/tone_guide.md— ユーザーとの対話スタイル。このファイルの口調・絵文字・出力言語ルールに従うこと
実例(品質の基準):
.miko/examples/system_high_level_design.md— システム HLD のサンプル。同等の構造・詳細度を維持する
現行ファイル:
miko/system_high_level_design.md— 現在の内容を把握。以下を抽出・記録する:- ディレクトリ構成セクションの内容
- レイヤー構成と責務
- API 構造
- ファイル命名規約
- ビジネスルール抽出の着目点
- ケイパビリティ一覧
3. ディレクトリ存在チェック(サブエージェント並列)
miko/system_high_level_design.md の各セクションからディレクトリパスを抽出し、実在するか確認する。以下のサブエージェント(Agent ツール、subagent_type: "Explore"、model: "sonnet")を並列に起動する。
探索対象外: .miko/ ディレクトリは miko の内部リソースであり、プロジェクトのコードではない。探索・精読の対象にしないこと。
<サブエージェントAへのプロンプト> 以下の内容は miko/system_high_level_design.md から抽出したものです。
ディレクトリ構成
{ディレクトリ構成セクションの内容}
レイヤー構成と責務
{レイヤー構成と責務セクションの内容}
以下を確認してください:
- 上記に記載されている全ディレクトリ(ディレクトリ構成の各パス、レイヤー構成の「置き場」列)が実際に存在するか、Glob で確認する
- 逆に、トップレベルおよびソースコードルート直下に、上記に記載されていない主要ディレクトリがないか確認する(.miko/ は除外)
結果を以下の形式で返してください:
- 記載あり・実在する: [一覧]
- 記載あり・実在しない: [一覧]
- 記載なし・実在する(主要なもののみ): [一覧] </サブエージェントAへのプロンプト>
<サブエージェントBへのプロンプト> 以下の内容は miko/system_high_level_design.md から抽出したものです。
API 構造
{API 構造セクションの内容}
ルーティング定義ファイルを読み、以下を確認してください:
- 記載されている API パターン(URI の名前空間・認証方式)がルーティング定義と一致するか
- 記載されていない新しい API パターン(新しい名前空間、新しい認証方式など)がないか
- 記載されているが実際には存在しない(廃止された)API パターンがないか
結果を以下の形式で返してください:
- 一致する API パターン: [一覧]
- 新規の API パターン: [一覧](なければ「なし」)
- 廃止された API パターン: [一覧](なければ「なし」) </サブエージェントBへのプロンプト>
全サブエージェントの完了後、 結果を統合して次のステップに進む。
4. 乖離判定
全ディレクトリが一致し、未記載の主要ディレクトリもなく、API パターンにも変更がない場合:
- 「⛩️
system_high_level_design.mdは現在のコードベースと一致しております。更新は不要です。」と報告して終了する
乖離ありの場合:
- 次のステップに進む
5. 詳細調査(サブエージェント並列)
ステップ 3 で検出された乖離について、更新案を策定するための詳細調査を行う。乖離があったセクションに対応するサブエージェントのみ起動する。 乖離がなかったセクションのサブエージェントは起動しない。
サブエージェント: Agent ツール、subagent_type: "Explore"、model: "sonnet"
<サブエージェント1へのプロンプト> ※ ディレクトリ構成・レイヤー構成に乖離があった場合のみ起動
以下はステップ 3 で検出された乖離です。 {サブエージェント A の結果から乖離部分を抽出}
以下は miko/system_high_level_design.md の現行の記載です。
ディレクトリ構成
{ディレクトリ構成セクションの内容}
レイヤー構成と責務
{レイヤー構成と責務セクションの内容}
ファイル命名規約
{ファイル命名規約セクションの内容}
以下を調査してください:
- 新しいディレクトリの役割と責務を特定する(中のファイルを数件読んで判断)
- 廃止されたディレクトリが本当に不要か確認する(移動先がないか等)
- レイヤー構成に変化があるか(新しいレイヤーの追加、責務変更、廃止)
- ファイル命名規約に変化があるか(新しいディレクトリ内のファイル名パターンを確認)
結果を以下の形式で返してください:
- ディレクトリ構成の更新案: [追加・廃止・変更の一覧と説明]
- レイヤー構成の更新案: [変更がある場合のみ]
- ファイル命名規約の更新案: [変更がある場合のみ] </サブエージェント1へのプロンプト>
<サブエージェント2へのプロンプト> ※ API パターンに乖離があった場合のみ起動
以下はステップ 3 で検出された乖離です。 {サブエージェント B の結果から乖離部分を抽出}
以下は miko/system_high_level_design.md の現行の記載です。
API 構造
{API 構造セクションの内容}
ビジネスルール抽出の着目点
{ビジネスルール抽出の着目点セクションの内容}
以下を調査してください:
- 新規 API パターンの詳細(URI の名前空間、認証方式、対応するコントローラー/ハンドラー)
- 廃止された API パターンが本当に不要か確認する
- 新規 API パターンに伴い、ビジネスルール抽出の着目点に新しいパターンが必要か確認する(コントローラー/ハンドラーを数件読んで判断)
結果を以下の形式で返してください:
- API 構造の更新案: [追加・廃止の一覧と説明]
- ビジネスルール抽出の着目点の更新案: [変更がある場合のみ] </サブエージェント2へのプロンプト>
全サブエージェントの完了後、 結果を統合して次のステップに進む。
6. 【確認】更新内容の確認
検出した乖離と更新案を、セクション別(ディレクトリ構成/レイヤー構成/API構造/着目点/ケイパビリティ一覧)にユーザーに提示し、承認を取る。変更がないセクションは省略する。
7. system_high_level_design.md 更新
確認を踏まえ、既存ファイルをベースに差分を反映する。
保持するもの:
- 既存の記述は消さない(変更が必要な場合は改訂)
- システム概要・テナント構造は変更しない(変更が必要な場合はユーザーに確認済みの内容のみ反映)
更新するもの:
- ディレクトリ構成
- レイヤー構成と責務
- API 構造(変更がある場合)
- ファイル命名規約(変更がある場合)
- ビジネスルール抽出の着目点(変更がある場合)
- ケイパビリティ一覧(miko/ 配下のディレクトリとの整合)
8. 完了報告
更新した項目(ディレクトリ構成・レイヤー構成・API 構造・着目点・ケイパビリティ一覧)の変更件数をサマリーテーブルで提示する。次のアクションとして /miko.catchup をご案内する。
04 同仓库更多 Skills
miko.version
miko のバージョンを表示する。
miko.split-proposal
既存のプロポーザルを親(umbrella)+ サブプロポーザルにフェーズ分割する。
miko.speckit.tasks
speckit.tasks を拡張し、縦割りタスク順序と test_design.md の活用を追加する。
miko.speckit.specify
Miko プロポーザルを入力として speckit.specify を拡張し、spec.md を生成する。
miko.speckit.plan
speckit.plan を拡張し、テスト設計(test_design.md)を追加生成する。
miko.speckit.implement
speckit.implement を拡張し、フェーズごとの確認停止と test_design.md の活用を追加する。