> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kodus.io/llms.txt
> Use this file to discover all available pages before exploring further.

# ビジネスロジック検証

> @kody -v business-logic を使用してプルリクエストをビジネスルールや仕様と照合します。

## 概要

ビジネスロジック検証を使用すると、プルリクエストが仕様書、ドキュメント、またはチケットに記載された期待される動作を実装しているかどうかを確認できます。Kody は PR の差分を分析し、参照されたビジネスコンテキストを取り込み、マージ前に不一致を検出します。

<img src="https://kodus.io/wp-content/uploads/2025/10/business-logic.gif" alt="ビジネスロジック検証の使用例" />

## 前提条件

* Jira、Linear、Notion、ClickUp などのツールからKodyが**タスクコンテキストを自動取得**するには、ワークスペースの[プラグイン](/how_to_use/ja/code_review/plugins)ページで対応するプラグインを接続する必要があります。
* 共有するリンク（Jira、Slack、Google Docs など）は、ワークスペースにインストールされているプラグインを通じてアクセス可能である必要があります。
* プラグインなしで**仕様をインラインで提供**することも可能です。PR コメントに要件を直接貼り付けるだけです。

## ビジネスロジック検証の有効化

ビジネスロジック検証は**デフォルトで有効**です。2 つの方法で制御できます：

**`kodus-config.yml` 経由：**

```yaml theme={null}
reviewOptions:
  business_logic: true
```

**Web UI 経由：**

**コードレビュー設定** → **リポジトリ** → **一般** → **分析タイプ** に移動し、**ビジネスロジック**をトグルします。

有効にすると、Kody はすべての PR レビュー時に自動的にビジネスロジック検証を実行します（オンデマンドコマンドに加えて）。

## オンデマンド実行

いつでも手動で検証を実行することもできます：

1. メインの PR コメントボックスを開きます（インラインコードサジェストの外側）。
2. Kody にメンションして検証コマンドを追加します：`@kody -v business-logic ...`
3. 仕様コンテンツをインラインで提供するか、利用可能なプラグイン経由で Kody が取得できるリンクを貼り付けます。
4. コメントを送信し、同じスレッドで Kody の応答を待ちます。

コマンドはメインの会話ボックスからのみ実行されます。インラインサジェスト内の返信は無視されます。

検証はいつでも再実行できます。新しいコメントでコマンドを再度投稿するだけです。フォローアップは新しいコマンドである必要があります。Git UI で Kody のメッセージに直接返信する方法はサポートされていません。

### 例

* Jira チケット：`@kody -v business-logic https://kodustech.atlassian.net/jira/software/c/projects/KC/boards/2?selectedIssue=KC-1292`
* Linear イシュー：`@kody -v business-logic https://linear.app/your-team/issue/TEAM-123`
* Notion ページ：`@kody -v business-logic https://www.notion.so/your-workspace/Feature-Spec-abc123`
* Google ドキュメント：`@kody -v business-logic https://docs.google.com/document/d/1234567890/edit`
* Slack 会話：`@kody -v business-logic https://kodustech.slack.com/archives/C070E5E97DE/p1727814000000000`
* インライン仕様スニペット：`@kody -v business-logic ルール XYZ — $500 以上の注文はキャッシュバッククレジットを発行する必要があります。`

## Kody が行うこと

1. **PR の差分**とプルリクエストのメタデータを取得します。
2. **タスクコンテキストを取得**します。リンクされたタスク管理ツール（Jira、Linear など）から、または提供されたインラインテキストから取得します。
3. **タスクコンテキストの品質を分類**します。利用可能な情報に基づいて分析の徹底度を決定します。
4. **要件に対して実装を比較**します。各受け入れ基準を PR の差分と照合します。
5. 重大度レベルと要件トレースを含む**調査結果を報告**します。

Kody がリソースにアクセスできない場合や権限がない場合は、それを通知するので、アクセスを調整するか別の方法で情報を提供できます。

## タスクコンテキストの品質

Kody は分析前にタスクコンテキストの品質を自動的に分類します。これにより検証の深さが影響を受けます：

| 品質      | 説明                   | 分析の動作                |
| ------- | -------------------- | -------------------- |
| **完全**  | タイトル、説明、受け入れ基準がある    | 基準ごとの徹底的な分析          |
| **部分的** | タイトルと説明があるが受け入れ基準がない | 説明された動作からのベストエフォート分析 |
| **最小限** | タイトルのみまたは非常に短い説明     | 保守的 — 明らかなギャップのみを検出  |
| **空**   | 意味のあるタスクコンテキストなし     | 「タスク情報が必要」という応答を返す   |

## 出力の理解

### 調査結果の重大度

各調査結果には重大度レベルが含まれます：

* **MUST\_FIX** — 必須のビジネスルールが実装されていない、正しくない、またはタスク要件と矛盾している
* **SUGGESTION** — 関連するエッジケース、堅牢性、または保守性のポイントがカバーされていない
* **INFO** — コンプライアンスをブロックしない有用な観察

### 根拠のある調査結果

すべての調査結果はタスクコンテキストの**特定の要件にトレース可能**です。各調査結果には以下が含まれます：

* **要件** — 要件を確立するタスクからの正確な引用
* **コードに欠けているもの** — PR の差分で何が欠けているか、または何が間違っているか
* **推奨アクション** — 具体的な実装アクション

Kody は要件を作り出しません。調査結果がタスク内の特定の文にトレースバックできない場合は報告されません。

### スコープの不一致検出

PR の差分がタスク自体とは異なるドメインで作業しているように見える場合、Kody はこれを**スコープの不一致**として検出し、誤解を招くギャップ分析を生成する代わりに、主要な調査結果として報告します。

### 出力例

```markdown theme={null}
## ビジネスルール検証

**タスク：** KC-1441 - チームスコープの Kody ルール
**タスクリンク：** https://kodustech.atlassian.net/browse/KC-1441
**ステータス：** 問題が見つかりました
**信頼度：** 高

### 調査結果

#### MUST_FIX：この PR の差分にチームスコープのルール解決の証拠なし
**要件：** 「ルールはクロスワークスペースの請求の不一致を避けるために
組織とチームによって解決される必要があります。」
**コードに欠けているもの：** この PR の差分に関連する永続化または
ルックアップパスへの `teamId` 追加の証拠なし。
**推奨アクション：** ルールの永続化とクエリフィルターに `teamId` を追加してください。

#### SUGGESTION：確定的な混合ライセンス処理の証拠なし
**要件：** 「チームが異なるサブスクリプション状態を持つ場合、
動作は確定的である必要があります。」
**コードに欠けているもの：** この PR の差分に混合サブスクリプション状態を
処理するロジックの証拠なし。
**推奨アクション：** チームにスコープされた確定的フォールバックと
エラー処理を追加してください。

### 検証済み要件
- AC #1：「チームスコープの読み取り/書き込み」— `rules.service.ts:42` で実装済み
- AC #2：「マルチワークスペースの請求パス」— `billing.service.ts:118` で実装済み

---
*Kodus AI ビジネスルールバリデーターによる分析*
```

## ヒント

* 大きな仕様をセクションに分割し、フィードバックを集中させるために個別に検証してください。
* プライベートリンクを共有する際は、必要なプラグイン（Jira、Slack、Google Drive など）がワークスペースにインストールされ、認可されていることを確認してください。
* 調査結果に対処した後、コマンドを再実行して PR がビジネスルールに沿っていることを確認してください。
* 最も徹底した分析のために、タスクに受け入れ基準を提供してください。明示的な基準を持つタスクは基準ごとの検証が行われます。