search-company-knowledge

社内ナレッジを検索

キーワード

情報を見つける、社内ナレッジを検索する、調べる、とは何か、説明する、社内ドキュメント、社内ドキュメント、Confluence 検索、Jira 検索、社内ドキュメント、社内ナレッジ、ナレッジベース、検索する、〜について教えて、〜について情報を得る、社内システム、用語、〜に関する情報をすべて見つける、〜について何が分かっているか、デプロイ、認証、インフラストラクチャ、プロセス、手順、方法、仕組み、社内システム、社内プロセス、社内システム、社内プロセス、技術ドキュメント、エンジニアリングドキュメント、アーキテクチャ、設定、社内ドキュメントを検索する、社内ドキュメントを検索する、社内ドキュメントから見つける

概要

サイロ化された社内ナレッジシステム（Confluence、Jira、社内ドキュメント）を横断して検索し、社内の概念、システム、用語に関する質問への包括的な回答を見つけます。このスキルは複数の情報源を並行して検索し、適切な引用を添えて結果を統合します。

このスキルを使用する場面： Confluence ページ、Jira チケット、社内ドキュメントに記録されている可能性のある社内ナレッジについて、ユーザーから質問された場合に使用します。

---

ワークフロー

包括的で引用の適切な回答を提供するには、次の5つの手順に従います。

手順 1：検索クエリを特定する

ユーザーの質問から主要な検索語を抽出します。

例：

• ユーザー：「Stratus minionsについてすべて見つけて」→ 検索：「Stratus minions」
• ユーザー：「請求システムについて何が分かっていますか？」→ 検索：「請求システム」
• ユーザー：「社内のデプロイプロセスを説明して」→ 検索：「デプロイプロセス」

考慮する点：

• 主なトピックまたは概念
• 特定のシステム名やコンポーネント名
• 技術用語や専門用語

---

手順 2：並行検索を実行する

包括的に情報を得るため、利用可能なすべてのナレッジソースを同時に検索します。

オプション A：システム横断検索（最初に推奨）

Confluence と Jira を一度に検索するには、search ツール（Rovo Search）を使用します。

search(
  cloudId="...",
  query="[extracted search terms]"
)

使用する場面：

• ほとんどのクエリでの標準的な方法
• どのシステムに情報があるか分からない場合
• 複数の情報源から最も速く結果を得たい場合

search はセマンティック検索です。自然言語を渡し、クエリ構文は使用しないでください。 query に CQL または JQL を指定すると、エラーにならずに結果の精度が低くなります。タイトルやタイプの一致など、構造化されたフィルターが必要な場合は、searchConfluence（CQL）または searchJiraIssuesUsingJql（JQL）を使用してください。

例：

search(
  cloudId="...",
  query="Stratus minions"
)

Confluence ページと Jira 課題の両方から結果が返されます。

オプション B：Confluence の対象を絞った検索

Confluence を特に検索する場合は、searchConfluence を使用します。

searchConfluence(
  cloudId="...",
  cql="text ~ 'search terms' OR title ~ 'search terms'"
)

使用する場面：

• ユーザーが「Confluenceで」や「社内ドキュメントで」と明示している場合
• システム横断検索で Jira の結果が多すぎる場合
• チケットではなくドキュメントを探している場合

CQL パターンの例：

text ~ "Stratus minions"
text ~ "authentication" AND type = page
title ~ "deployment guide"

オプション C：Jira の対象を絞った検索

Jira を特に検索する場合は、searchJiraIssuesUsingJql を使用します。

searchJiraIssuesUsingJql(
  cloudId="...",
  jql="text ~ 'search terms' OR summary ~ 'search terms'"
)

使用する場面：

• ユーザーが「チケット」「課題」「バグ」に言及している場合
• 過去の問題や実装の詳細を探している場合
• システム横断検索で主にドキュメントが返される場合

JQL パターンの例：

text ~ "Stratus minions"
summary ~ "authentication" AND type = Bug
text ~ "deployment" AND created >= -90d

検索戦略

ほとんどのクエリでは、次の順序で進めます。

1. search（システム横断検索）から始めます。必ず最初に試してください
2. 結果が不明確な場合は、対象を絞った検索を追加で行います
3. 結果に特定のページやチケットが含まれている場合は、詳細を取得します

---

手順 3：詳細なコンテンツを取得する

関連する情報源を特定したら、包括的な回答を作成するために全文を取得します。

Confluence ページの場合

検索結果に Confluence ページが含まれている場合：

getConfluenceContent(
  cloudId="...",
  content_id="[page ID from search results]",
  content_format="markdown",
  detail="full"
)

返される内容： Markdown 形式のページ全文

取得する場面：

• 検索結果の抜粋が短すぎる場合
• 全体的な文脈が必要な場合
• そのページが主要なドキュメントと思われる場合

Jira 課題の場合

検索結果が Jira 課題を参照している場合:

getJiraIssue(
  cloudId="...",
  issueIdOrKey="PROJ-123"
)

返される内容: 説明やステータスを含む課題の完全な詳細。

getJiraIssue はコメント本文を返しません — 課題にコメントがいくつあるかだけを報告します。ディスカッションが重要な場合は、コメントを別途取得してください。listJiraIssueComments は主要なツールではないため、execute を通して実行し、必要なコメントが揃うまで startAt/maxResults でページネーションします:

executeRead(   # or execute(...) if your client exposes a single execute tool
  name="listJiraIssueComments",
  cloudId="...",
  inputs={"issueIdOrKey": "PROJ-123", "maxResults": 50}
)

取得すべきタイミング:

• 報告されたバグや課題を理解する必要がある場合
• 検索結果に完全なコンテキストが表示されない場合
• 課題に重要な実装メモが含まれている場合

優先順位付け

この順序で取得してください:

1. 公式ドキュメントページ(タイトルに「guide」「documentation」「overview」を含む Confluence ページ)
2. 最近の/関連する課題(関連性があり最近の Jira チケット)
3. 追加のコンテキスト(最初の結果で言及された関連ページ)

すべてを取得しないでください - ユーザーの質問との関連性に基づいて取捨選択してください。

---

ステップ 4: 結果を統合する

複数のソースからの情報を組み合わせて、一貫性のある回答を作成します。

統合のガイドライン

回答を構成する:

1. 最初に直接的な回答

   • 質問に対する明確で簡潔な回答から始めます
   • 「Stratus minions は...」

2. 詳細な説明

   • すべてのソースから包括的な詳細を提供します
   • ソース別ではなくトピック別に整理します

3. 出典の明示

   • 各情報がどこから来ているかを示します
   • 形式: 「[source] によると、...」

4. 相違点を強調する

   • ソースが矛盾する場合は、明示的に指摘します
   • 例: 「Confluence のドキュメントには X と記載されていますが、Jira チケット PROJ-123 はバグ Y により実際の動作は Z であると示しています」

5. コンテキストを提供する

   • 情報が古い場合は言及します
   • 機能が非推奨または開発中である場合は注記します

統合のパターン

パターン 1: 複数のソースが一致している

Stratus minions are background worker processes that handle async tasks.

According to the Confluence documentation, they process jobs from the queue and 
can be scaled horizontally. This is confirmed by several Jira tickets (PROJ-145, 
PROJ-203) which discuss minion configuration and scaling strategies.

パターン 2: ソースが異なる側面を提供している

The billing system has two main components:

**Payment Processing** (from Confluence "Billing Architecture" page)
- Handles credit card transactions
- Integrates with Stripe API
- Runs nightly reconciliation

**Invoice Generation** (from Jira PROJ-189)
- Creates monthly invoices
- Note: Currently has a bug where tax calculation fails for EU customers
- Fix planned for Q1 2024

パターン 3: 情報が矛盾している

There is conflicting information about the authentication timeout:

- **Official Documentation** (Confluence) states: 30-minute session timeout
- **Implementation Reality** (Jira PROJ-456, filed Oct 2023): Actual timeout is 
  15 minutes due to load balancer configuration
- **Status:** Engineering team aware, fix planned but no timeline yet

Current behavior: Expect 15-minute timeout despite docs saying 30 minutes.

パターン 4: 情報が不完全である

Based on available documentation:

[What we know about deployment process from Confluence and Jira]

However, I couldn't find information about:
- Rollback procedures
- Database migration handling

You may want to check with the DevOps team or search for additional documentation.

---

ステップ 5: 引用を提供する

ユーザーがさらに調べられるよう、常にソース資料へのリンクを含めてください。

引用の形式

Confluence ページの場合:

**Source:** [Page Title](https://yoursite.atlassian.net/wiki/spaces/SPACE/pages/123456)

Jira 課題の場合:

**Related Tickets:**
- [PROJ-123](https://yoursite.atlassian.net/browse/PROJ-123) - Brief description
- [PROJ-456](https://yoursite.atlassian.net/browse/PROJ-456) - Brief description

完全な引用セクション:

## Sources

**Confluence Documentation:**
- [Stratus Architecture Guide](https://yoursite.atlassian.net/wiki/spaces/DOCS/pages/12345)
- [Minion Configuration](https://yoursite.atlassian.net/wiki/spaces/DEVOPS/pages/67890)

**Jira Issues:**
- [PROJ-145](https://yoursite.atlassian.net/browse/PROJ-145) - Minion scaling implementation
- [PROJ-203](https://yoursite.atlassian.net/browse/PROJ-203) - Performance optimization

**Additional Resources:**
- [Internal architecture doc link if found]

---

検索のベストプラクティス

効果的な検索語

すべきこと:

• ✅ 具体的な技術用語を使用する: 「OAuth authentication flow」
• ✅ システム名を含める: 「Stratus minions」
• ✅ 一般的な頭字語は使用する: 「API rate limiting」
• ✅ 最初の検索が失敗したらバリエーションを試す: 「deploy process」→「deployment pipeline」

すべきでないこと:

• ❌ 一般的すぎる表現: 「how things work」
• ❌ 完全な文を使う: 代わりにキーワードを使用する
• ❌ つなぎ言葉を含める: 「the」「our」「about」

検索結果の品質

良い結果:

• 最近のドキュメント(1 年未満)
• 公式/正規のページ(「Guide」「Documentation」「Overview」というタイトル)
• 同じ情報を裏付ける複数のソース
• 詳細な実装メモ

疑わしい結果:

• 非常に古いチケット(2 年以上、古くなっている可能性がある)
• 重複または矛盾する情報
• 下書きページや作業中のドキュメント
• 個人ページ(公式でない可能性がある)

結果が乏しい場合:

• 別の検索語を試す
• 関連する概念を含めるよう検索を広げる
• 特定のエラーメッセージやコードを検索する
• ユーザーにさらなるコンテキストを求める

---

よくあるシナリオへの対応

シナリオ 1: 結果が見つからない

検索が結果を返さない場合:

I searched across Confluence and Jira but couldn't find information about "[topic]".

This could mean:
- The concept hasn't been documented yet
- It might be called something else (can you provide alternative names?)
- Documentation might be in a different system I don't have access to

Would you like me to:
1. Try searching with different terms?
2. Search for related concepts?
3. Look for mentions in recent Jira tickets?

シナリオ 2: 結果が多すぎる

検索が 50 件以上の結果を返す場合:

• 最も最近で最も関連性の高いものに焦点を当てる(上位 10〜15 件)
• 無作為なチケットよりも公式ドキュメントを優先する
• 類似の結果をグループ化する: 「認証バグに関連するチケットを 15 件見つけました...」
• 検索を絞り込むことを提案する: 「[specific aspect] に焦点を当てましょうか?」

シナリオ 3: 曖昧なクエリ

ユーザーの質問が曖昧な場合:

I found information about several topics related to "[term]":
1. [Topic A] - from Confluence page X
2. [Topic B] - from Jira tickets Y, Z
3. [Topic C] - from documentation W

Which aspect are you most interested in?

シナリオ 4: 情報が古い

情報が古いと判明した場合:

I found documentation about [topic], but note that it's from [date] and may be outdated.

[Provide the information anyway]

You may want to verify this is still current, especially if it's from more than 
a year ago.

シナリオ 5：アクセス制限のあるコンテンツ／非公開コンテンツ

検索結果にアクセスできないコンテンツが含まれている場合：

Search results mention [topic] in the following locations, but I don't have 
access to view the full content:
- Confluence page: [title] (Space: [SPACE])
- Jira issue: PROJ-123

You may need to access these directly or check your permissions.

---

例

例 1：明確なドキュメントがある場合

ユーザー：「Stratus minion とは何ですか？」

プロセス：

1. 検索：search(cloudId="...", query="Stratus minions")
2. 検索結果：Confluence ページ「Stratus Architecture」と Jira チケット 3 件
3. 取得：Confluence ページの全文を取得
4. 統合：アーキテクチャの概要と、チケットに記載された実装の詳細を組み合わせます
5. 引用：すべての情報源へのリンクを提示します

回答：

Stratus minions are background worker processes that handle asynchronous task 
processing in the Stratus system.

**Key Characteristics:**
- Run independently from web servers
- Process jobs from a Redis queue
- Can be scaled horizontally for increased throughput
- Handle tasks like email sending, report generation, and data processing

**Architecture:**
According to the Stratus Architecture documentation, minions follow a 
worker-queue pattern where:
1. Web application enqueues tasks
2. Minions poll the queue for work
3. Tasks are processed asynchronously
4. Results are stored in the database

**Implementation Notes:**
From Jira ticket PROJ-203, the current deployment runs 5 minion instances, 
with plans to scale to 10 for handling increased load.

## Sources
- [Stratus Architecture Guide](link)
- [PROJ-203](link) - Minion scaling implementation

例 2：情報が矛盾している場合

ユーザー：「セッションタイムアウトの時間はどれくらいですか？」

プロセス：

1. Confluence と Jira を横断して検索
2. 検索結果：ドキュメントには 30 分とありますが、チケットでは実際のタイムアウトは 15 分と報告されています
3. 両方の情報源を取得して、全体像を把握します
4. 食い違いがあることを明確に伝えます

回答：

There is a discrepancy between documented and actual behavior:

**Official Documentation** (Security Guidelines):
Session timeout is configured for 30 minutes of inactivity.

**Actual Behavior** (PROJ-456, reported Oct 2023):
Users are being logged out after 15 minutes due to a load balancer configuration 
that overrides the application setting.

**Current Status:**
The engineering team is aware of this issue. The load balancer timeout needs to 
be adjusted to match the application setting. No fix timeline has been set.

**Recommendation:** Plan for 15-minute timeout until this is resolved.

## Sources
- [Security Guidelines](link) - Official documentation
- [PROJ-456](link) - Timeout discrepancy bug report

例 3：情報が一部しかない場合

ユーザー：「デプロイプロセスについて説明してください」

プロセス：

1. 検索で一部の情報は見つかりますが、すべては揃いません
2. 入手できた情報を統合します
3. ドキュメントに記載されていない点を伝えます

回答：

Based on available documentation, here's what I found about the deployment process:

**Build Phase** (from Confluence "CI/CD Guide"):
1. Code pushed to main branch triggers GitHub Actions
2. Automated tests run (unit, integration)
3. Docker image built and pushed to registry

**Deployment Phase** (from Jira PROJ-789):
4. Staging deployment happens automatically
5. Manual approval required for production
6. Blue-green deployment strategy used

**Gaps in Documentation:**
I couldn't find documented information about:
- Rollback procedures
- Database migration handling
- Post-deployment verification steps

These details may exist in tribal knowledge or need to be documented.

## Sources
- [CI/CD Guide](link)
- [PROJ-789](link) - Deployment pipeline implementation

Would you like me to search for more specific aspects of deployment?

---

質の高い回答のためのヒント

すること：

✅ 回答する前に必ず検索します（一般知識だけに頼らないでください） ✅ すべての情報源をリンク付きで引用します ✅ 食い違いがあれば明示します ✅ 情報が古い場合はその旨を伝えます ✅ 背景情報や例を提示します ✅ 見出しを使って回答をわかりやすく構成します ✅ 関連ドキュメントへのリンクを掲載します

しないこと：

❌ 一般知識がこの会社にも当てはまると決めつけないでください ❌ 検索で何も見つからない場合に情報をでっち上げないでください ❌ 矛盾する情報を無視しないでください ❌ ドキュメント全体を引用しないでください（代わりに要約します） ❌ 情報源が多すぎて回答をわかりにくくしないでください（上位 5～10 件を選びます） ❌ 検索結果の抜粋だけでは不十分な場合に詳細の取得を忘れないでください

---

このスキルを使用しない場合

このスキルは社内の知識のみを対象としています。次の場合には使用しないでください。

❌ 一般的な技術に関する質問（学習済みの知識を使用してください） ❌ 外部ドキュメントに関する質問（web_search を使用してください） ❌ 特定の会社に限定されない質問 ❌ 他社に関する質問 ❌ 時事問題やニュース

このスキルを使用しない質問の例：

• 「機械学習とは何ですか？」（一般知識）
• 「React はどのように動作しますか？」（外部ドキュメント）
• 「天気はどうですか？」（知識検索ではありません）
• 「レストランを探してください」（仕事に関する質問ではありません）

---

クイックリファレンス

主要ツール： search(cloudId, query) - 最初に必ず使用します

後続のツール：

• getConfluenceContent(cloudId, content_id, content_format, detail="full") - ページの全文を取得
• getJiraIssue(cloudId, issueIdOrKey) - 課題の詳細をすべて取得
• searchConfluence(cloudId, cql) - Confluence を対象に絞って検索
• searchJiraIssuesUsingJql(cloudId, jql) - Jira を対象に絞って検索

回答の構成：

1. 直接的な回答
2. 詳細な説明
3. 情報源の明記
4. 食い違い（ある場合）
5. リンク付きの引用

覚えておくこと：

• 並列検索 ＞ 順次検索
• 情報を統合し、単に列挙するだけにしない
• 情報源を必ず引用する
• 矛盾は明示する
• ドキュメントに記載されていない点を明確に伝える