WeirdSky924/project-change-router-skill

安装

这表示：系统对“应该落到哪个 capability”没有把握，但对当前 action 建议很有把握。是否可以写产品代码必须另读 `execution_gate.state`；例如相关路径未索引时会是 `blocked`，而只有无关且不扩大的可信历史债务时可为 `conditional`。

## 仓库阶段策略

router 会根据仓库成熟度推断 `repo_stage`：

- `seed`：空仓或极早期仓，默认只允许明显的新边界或 `review`。
- `emerging`：已有少量结构，但 capability 边界仍保守，provisional 不自动成为强复用目标。
- `structured`：模块边界较稳定，可以更完整地使用 `reuse`、`extend`、`extract`。
- `governed`：以 profile、owner、public entry、evaluation 和 guardrail 为主要依据。

capability 自身也有阶段：

- `provisional`
- `candidate`
- `stable`
- `governed-capability`
- `deprecated`

早期仓库不要过早固化 generated capability。推荐先写最小 ownership/profile，再随着真实开发逐步补 capability、public entry、contract、test binding 和 evaluation case。

## 一体化路由报告

route report 不是只给一个 action。它是一个完整路由契约，核心字段包括：

- `action`
- `decision_basis`
- `routing_confidence`
- `routing_confidence_level`
- `decision_confidence`
- `decision_confidence_level`
- `primary_capability`
- `primary_capability_stage`
- `secondary_capabilities`
- `candidate_capabilities`
- `required_reads`
- `required_checks`
- `recommended_next_action`
- `recommended_next_steps`
- `why_not_actions`
- `confidence_reasons`
- `veto_reasons`
- `positive_signals`
- `negative_signals`
- `risk_signals`
- `authorization_context`
- `route_fingerprint`
- `runtime_identity`
- `typed_findings`
- `execution_gate`
- `gate_shadow`
- `must_read_targets`
- `inventory_targets`
- `unresolved_read_targets`
- `authorization_request`

七类治理输出也是同一个 route report 的一等字段，不是外挂能力：

- `review` 后处理：`block_reason`、`missing_evidence`、`analysis_directions`、`safe_next_steps`、`suggested_questions`、`override_requirements`
- 写入约束：`allowed_write_paths`、`forbidden_write_paths`、`must_read_before_edit`
- profile 修复方向：`profile_repair_hints`，治理审计报告中还有 `repair_suggestions`
- 变更后收口：`post_change_closeout`
- 删除、合并、废弃能力治理：`capability_lifecycle_action`
- 跨栈复合路由：`composite_route`
- 真实回归沉淀：`evaluation_regression_hints`

详细契约见 [references/governance-outputs.md](./references/governance-outputs.md)。

![Integrated route contract](./assets/readme-route-contract.svg)

### 0.4 执行门禁与证据模型

PCR 0.4 把“路由建议”和“是否可写”彻底拆开：

| 字段 | 作用 |
| --- | --- |
| `action` | `reuse / extend / extract / new / review`，只提供工程调查与处理方向 |
| `execution_gate.state=pass` | 相关证据完整且没有任务相关阻塞项；仍须遵守读写 envelope |
| `execution_gate.state=conditional` | 只剩已证明无关或不扩大的可信历史债务；必须执行前置命令并保持有界写入 |
| `execution_gate.state=blocked` | 存在 unknown/incomplete、任务相关 P0/P1、owner/canonical/public API/lifecycle/高风险问题或硬不变量冲突 |

门禁不重新扫描仓库，也不做第二套路由推理。所有结果都由一个版本化 policy table 对 schema-valid typed findings 做确定性归约。每条 finding 包含稳定 `finding_id`、来源、严重级、全局/闭包/局部不变量分类、delta、task relevance、evidence status、policy rule、路径/能力、相关性链路与证据摘要。

`gate_shadow` 仅保留旧门禁与新门禁的对照诊断；0.4 中 `execution_gate.authoritative=true`，旧门禁不再决定写入。`output_complete=false` 或无法满足新版精度的 schema-v1 输入必须形成 unknown/incomplete finding 并阻塞，不能用乐观默认值补齐。

统一入口：

把 WeirdSky924/project-change-router-skill 加入你的 DSH 配置（web profile）即可启用。