REQUIREMENTS (要件定義書 - Agentic 版)

1. エージェント自律動作要件 (スキル一覧)

本システムは、AI エージェントが Workspace（ファイルシステム）に対して直接、以下の「スキル」を適用して運用します。

1.1. wiki-ingest スキル (ドキュメント取り込み)

• REQ-1.1.1: インボックスからのファイル配置とテキスト抽出
  • エージェントは、raw_sources/inbox/ ディレクトリに配置された新規ドキュメントを検出し、raw_sources/ 以下の適切なディレクトリ（インボックス外）へ移動した上で、適したツール（MCP ツール等）を用いてテキストを抽出できること。
• REQ-1.1.2: エンティティ要約と Wiki ページの作成
  • エージェントは、抽出したテキストからキーエンティティ（人物、技術、概念等）を識別し、wiki/entities/ 配下に個別の Markdown ページを自動作成すること。
• REQ-1.1.3: 既存知識との自律マージ
  • 作成対象のエンティティが既に Wiki 上に存在する場合、エージェントは既存のファイルを読み込み、新しい情報と論理的に統合・更新（部分置換や追記）すること。
• REQ-1.1.4: [[wikilink]] の自動構築
  • エージェントは、生成または更新した Markdown テキスト内に存在する他の Wiki ページへの言及を検出し、自動的に Obsidian 互換の [[ページ名]] 形式でリンク化すること。
• REQ-1.1.5: 認識論的マーキングの付与
  • エージェントは、記述の正確性を担保するため、情報の出所（ソース引用、推論 [I]、ユーザー主張 [P]、不確実 [?]）を区別するマーカーを Wiki 内に厳密に書き込むこと。
• REQ-1.1.6: ソースメタデータ JSON の自動生成
  • エージェントは、ソースドキュメント取り込み時に、拡張子を除いたファイル名に .metadata.json を付与したメタデータファイルを raw_sources/ に自動生成し、以下の情報を格納すること。
    • target_file_name (対象ファイル名)
    • ingested_at (取り込み日時 - ISO 8601 形式)
    • last_modified_at (対象ファイルの最終更新日)
    • summary (ファイル内容のサマリー)
    • keywords (ファイルに関連するキーワード一覧)

1.2. wiki-query スキル (対話と知識のストック化)

• REQ-1.2.1: ナレッジベースを前提とした対話
  • エージェントは、Wiki 全体のインデックス（index.md）や関連ファイルを自律的に探索し、文脈を合成して高度な回答を生成できること。
• REQ-1.2.2: 回答のナレッジストック化
  • エージェントは、ユーザーとの対話で生まれた有益な知見、調査結果、または高度な比較表を、自律的に新しい Wiki ページとして wiki/ 内にコンパイル・保存すること。

1.3. wiki-lint スキル (ナレッジベース監査)

• REQ-1.3.1: 矛盾記述の検出
  • エージェントは、Wiki 内を定期的にスキャンし、異なる文書間で生じている事実の矛盾や主張の衝突を論理的に検知できること。
• REQ-1.3.2: リンク切れ・孤立ページの自動修復
  • エージェントは、破綻したリンクや、どこからもリンクされていない孤立ページ（Orphan pages）を検出し、意味的類似性を判断して自動リンク構築や統合処理を行えること。
• REQ-1.3.3: レビューキューとログの保守
  • エージェントは、自動修復できない矛盾や不確実な記述を wiki/review_queue.md に登録し、処理ログを wiki/log.md に記録すること。

---

2. インターフェース要件

ユーザーおよびエージェントが相互作用するインターフェースの要件です。

• REQ-2.1: Obsidian 連携ビュー (ナレッジベース可視化)
  • 生成される Wiki はすべて標準 Markdown 形式とし、Obsidian Vault 上で以下のドキュメント画面として視覚的にブラウズできること。
    • インデックス画面 (wiki/index.md): エージェントが自動維持する Wiki の目次ダッシュボード。
    • レビューキュー画面 (wiki/review_queue.md): 人間の判断が必要な監査項目の一覧。
    • 履歴画面 (wiki/log.md): エージェントのスキル実行履歴。
• REQ-2.2: エージェントチャット UI
  • ユーザーは、エージェント（Antigravity 2.0 のチャット等）を介して直接、質問を投げかけたり、明示的に「wiki-ingest スキルを実行して」などの指示（コマンド・トリガー）を与えられること。
• REQ-2.3: スキル定義管理 (.agents/skills/)
  • エージェントの動作を規定するスキル定義（Markdown 指示書）がプロジェクト内に整理されて配置されており、エージェントが必要に応じて読み込み・実行できる構成であること。