---
name: iris
description: IRISナレッジベースを自律的に構築・管理するためのコアスキルスイート。
argument-hint: "<subskill> [<arguments...>]"
---

# IRIS Core Skills (iris)

IRIS (Intelligent Retrieval and Indexing System) のナレッジベースを自律管理するための AI エージェント用スキル定義です。

> [!IMPORTANT]
> IRISコアスキル（サブスキル群）を実行するには、環境変数 `IRIS_BUNDLE_ROOT` が定義されている必要があります。この環境変数は、ナレッジバンドルが格納されているディレクトリ（通常はプロジェクトの `docs/`）の絶対パスを指している必要があります。
> ローカル開発環境では、プロジェクトルートの `.env` ファイルに定義し、`mise` などを介してロードして使用してください。

## サブスキル一覧

| サブスキル名 | ファイル名                   | 説明                                                                                                            |
| :----------- | :--------------------------- | :-------------------------------------------------------------------------------------------------------------- |
| **ingest**   | [ingest.md](./ingest.md)     | `raw_inbox/` からソースファイルを回収・整理し、`wiki/` 配下にコンセプトファイルを構築します。                   |
| **reingest** | [reingest.md](./reingest.md) | `raw_sources/` 内で更新されたソースを検知し、関連するコンセプトファイルのみを再生成・マージします。             |
| **query**    | [query.md](./query.md)       | ナレッジベースを探索・合成してユーザーの問いに回答し、回答結果を queries/ ディレクトリ配下に保存します。        |
| **queue**    | [queue.md](./queue.md)       | AIの生成成果物（検索結果など）を `raw_inbox/` に投入して Ingest の対象にします。                                |
| **lint**     | [lint.md](./lint.md)         | Ingest実行前に raw_inbox/ 配下のソースファイルを静的監査し、品質や命名規則をチェックします。                    |
| **analyze**  | [analyze.md](./analyze.md)   | ナレッジベース全体のカテゴリ使用状況を集計し、.bundle/CATEGORIES.md を作成・更新します。                        |
| **sweep**    | [sweep.md](./sweep.md)       | ソースファイルに紐づいていない孤立した古いコンセプトファイルを検知・削除します。                                |
| **index**    | [index.md](./index.md)       | 指定されたバンドルの `raw_sources` 配下にある全ソースファイルのリスト（インデックス）を作成・更新します。             |

