---
name: intent-routing
scope:
  - '*'
products:
  - '*'
id: ka-hard-rule-意图路由规则
asset_kind: governance_rule
lifecycle_status: active
authority: canonical
owner_mechanism_id: mc-intent-router
routes: ['*']
primary_triggers:
  - 意图路由规则
secondary_triggers: []
negative_triggers: []
priority: P0
specificity: 5
consumes:
  - mc-classifier
hard_blocks:
  - 路由未裁决
  - degraded未记录
fallback: manual_required
required_evidence:
  - route_decision
  - execution_shape
version: 1.1.0
last_reviewed: '2026-06-01'
type: governance_rule
when: 意图路由规则
stages: ["*"]
---

# 意图路由规则

## 核心原则

意图路由是 SoloForge 的入口裁决机制。所有用户意图必须先经过 intent_router 裁决，再进入后续流程。

## 规则

1. **入口唯一性**: routeIntent 是入口裁决的唯一来源，classifier 不可重新夺回入口裁决权
2. **路由完整性**: 每个用户意图必须产出一个有效的 route_decision，包含 route、execution_shape、mutation_allowed
3. **降级处理**: 路由失败时默认降级为 code_change，写入 `route_decision.degraded=true`
4. **只读保护**: source_extraction 路由必须为 read-only，不允许 mutation
5. **产物区分**: direct_answer 与 artifact_generation 必须严格区分

## 失败模式

- artifact_generation 被 skip → 应路由到 code_change 或 artifact_generation
- source_extraction 允许 mutation → 应为 read-only
- direct_answer 与产物语义混淆 → 应区分回答与生成

## 验收标准

- [ ] 所有 IntentRoute 类型都有对应的路由分支
- [ ] route_decision 包含完整字段
- [ ] degraded 路由标记为 degraded=true
- [ ] read-only 路由不包含 mutation 指令
