miko.catchup-system-hld

Files (1)

• SKILL.md

SKILL.md (first lines)

## 入力

```text
$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/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 の現行の記載です。
## ディレクトリ構成
{ディレクトリ構成セクションの内容}
## レイヤー構成と責務
{レイヤー構成と責務セクションの内容}
## ファイル命名規約
{ファイル命名規約セクションの内容}

From studyplus/miko, MIT.

More from studyplus/miko