AGENT SKILL

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 から抽出したものです。

ディレクトリ構成

{ディレクトリ構成セクションの内容}

レイヤー構成と責務

{レイヤー構成と責務セクションの内容}

以下を確認してください:

  1. 上記に記載されている全ディレクトリ(ディレクトリ構成の各パス、レイヤー構成の「置き場」列)が実際に存在するか、Glob で確認する
  2. 逆に、トップレベルおよびソースコードルート直下に、上記に記載されていない主要ディレクトリがないか確認する(.miko/ は除外)

結果を以下の形式で返してください:

  • 記載あり・実在する: [一覧]
  • 記載あり・実在しない: [一覧]
  • 記載なし・実在する(主要なもののみ): [一覧] </サブエージェントAへのプロンプト>

<サブエージェントBへのプロンプト> 以下の内容は miko/system_high_level_design.md から抽出したものです。

API 構造

{API 構造セクションの内容}

ルーティング定義ファイルを読み、以下を確認してください:

  1. 記載されている API パターン(URI の名前空間・認証方式)がルーティング定義と一致するか
  2. 記載されていない新しい API パターン(新しい名前空間、新しい認証方式など)がないか
  3. 記載されているが実際には存在しない(廃止された)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. 廃止されたディレクトリが本当に不要か確認する(移動先がないか等)
  3. レイヤー構成に変化があるか(新しいレイヤーの追加、責務変更、廃止)
  4. ファイル命名規約に変化があるか(新しいディレクトリ内のファイル名パターンを確認)

結果を以下の形式で返してください:

  • ディレクトリ構成の更新案: [追加・廃止・変更の一覧と説明]
  • レイヤー構成の更新案: [変更がある場合のみ]
  • ファイル命名規約の更新案: [変更がある場合のみ] </サブエージェント1へのプロンプト>

<サブエージェント2へのプロンプト> ※ API パターンに乖離があった場合のみ起動

以下はステップ 3 で検出された乖離です。 {サブエージェント B の結果から乖離部分を抽出}

以下は miko/system_high_level_design.md の現行の記載です。

API 構造

{API 構造セクションの内容}

ビジネスルール抽出の着目点

{ビジネスルール抽出の着目点セクションの内容}

以下を調査してください:

  1. 新規 API パターンの詳細(URI の名前空間、認証方式、対応するコントローラー/ハンドラー)
  2. 廃止された API パターンが本当に不要か確認する
  3. 新規 API パターンに伴い、ビジネスルール抽出の着目点に新しいパターンが必要か確認する(コントローラー/ハンドラーを数件読んで判断)

結果を以下の形式で返してください:

  • API 構造の更新案: [追加・廃止の一覧と説明]
  • ビジネスルール抽出の着目点の更新案: [変更がある場合のみ] </サブエージェント2へのプロンプト>

全サブエージェントの完了後、 結果を統合して次のステップに進む。

6. 【確認】更新内容の確認

検出した乖離と更新案を、セクション別(ディレクトリ構成/レイヤー構成/API構造/着目点/ケイパビリティ一覧)にユーザーに提示し、承認を取る。変更がないセクションは省略する。

7. system_high_level_design.md 更新

確認を踏まえ、既存ファイルをベースに差分を反映する。

保持するもの:

  • 既存の記述は消さない(変更が必要な場合は改訂)
  • システム概要・テナント構造は変更しない(変更が必要な場合はユーザーに確認済みの内容のみ反映)

更新するもの:

  • ディレクトリ構成
  • レイヤー構成と責務
  • API 構造(変更がある場合)
  • ファイル命名規約(変更がある場合)
  • ビジネスルール抽出の着目点(変更がある場合)
  • ケイパビリティ一覧(miko/ 配下のディレクトリとの整合)

8. 完了報告

更新した項目(ディレクトリ構成・レイヤー構成・API 構造・着目点・ケイパビリティ一覧)の変更件数をサマリーテーブルで提示する。次のアクションとして /miko.catchup をご案内する。

04 同仓库更多 Skills