Skip to content

Commit 8c2a5d6

Browse files
committed
fix: harden skill route context recovery
1 parent 9f46288 commit 8c2a5d6

34 files changed

Lines changed: 712 additions & 210 deletions

‎CHANGELOG.md‎

Lines changed: 5 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -2,14 +2,15 @@
22

33
> **说明**: 版本概览摘要。最新版本的详细变更见下方表格首行的 `changelogs/releases/vX.Y.Z.md` 链接;历史版本见对应详细变更文件
44
> **最后更新**: 2026-07-31
5-
> **当前未发布**: v1.15.6 已归档;后续未发布实现继续记录到 [`changelogs/unreleased.md`](./changelogs/unreleased.md)。
5+
> **当前未发布**: v1.15.7 已归档;后续未发布实现继续记录到 [`changelogs/unreleased.md`](./changelogs/unreleased.md)。
66
77
---
88

99
## 版本概览
1010

1111
| 版本 | 日期 | 变更摘要 | 详细 |
1212
|------|------|---------|------|
13+
| [v1.15.7](./changelogs/releases/v1.15.7.md) | 2026-07-31 | 🔧 **SkillRoute MCP schema + closeout/rebind 防复发**:`skill_route` schema 改为 per-op `oneOf`,禁止 `catalog/load_stage/status` 接收 `contextBinding`;`CONTEXT_BINDING_PENDING/STALE` 返回结构化恢复建议,Stop closeout 阻断给出可执行 `load_stage` 调用 | [查看](./changelogs/releases/v1.15.7.md) |
1314
| [v1.15.6](./changelogs/releases/v1.15.6.md) | 2026-07-31 | 🔧 **README 目录导航 + SkillRoute stale receipt 防复发**:README 增加用户章节目录导航并纳入公共 README 契约;修复 MCP source observation 遇到 stale receipt 时复用旧 receipt 导致 `skill_route commit` 继续 pending 的复发路径 | [查看](./changelogs/releases/v1.15.6.md) |
1415
| [v1.15.5](./changelogs/releases/v1.15.5.md) | 2026-07-31 | 🔧 **README 自动推进说明 + SkillRoute MCP 来源观测修复 + package runtime 闭包**:补齐 `@rocky` / `autoAliases` 用户配置说明,修复 MCP-only 路径下已读 profile/memory 但 `skill_route commit` pending 的阻断,并确保 npm 包内置 Skill portfolio 与 runtime contract digest 同步 | [查看](./changelogs/releases/v1.15.5.md) |
1516
| [v1.15.4](./changelogs/releases/v1.15.4.md) | 2026-07-31 | 🔧 **SkillRoute Context Binding 防复发 + 用户 README 收口 + npmjs 发布候选**:ContextRead mandatory source 硬闸门、deferred MCP tool discovery 提示、用户向 README 简化安装/更新/卸载与工作区 Skill 路径,CI 全绿后进入 npmjs public 发布链 | [查看](./changelogs/releases/v1.15.4.md) |
@@ -130,8 +131,9 @@
130131

131132
## 相关文档
132133

133-
- [`changelogs/releases/v1.15.6.md`](./changelogs/releases/v1.15.6.md) — 最新版本详细变更文档
134-
- [`changelogs/releases/v1.15.5.md`](./changelogs/releases/v1.15.5.md) — 上一版本详细变更文档
134+
- [`changelogs/releases/v1.15.7.md`](./changelogs/releases/v1.15.7.md) — 最新版本详细变更文档
135+
- [`changelogs/releases/v1.15.6.md`](./changelogs/releases/v1.15.6.md) — 上一版本详细变更文档
136+
- [`changelogs/releases/v1.15.5.md`](./changelogs/releases/v1.15.5.md) — 历史版本详细变更文档
135137
- [`changelogs/releases/v1.15.0.md`](./changelogs/releases/v1.15.0.md) — 上一版本详细变更文档
136138
- [`changelogs/releases/v1.14.0.md`](./changelogs/releases/v1.14.0.md) — 历史版本详细变更文档
137139
- [`changelogs/releases/v1.11.21.md`](./changelogs/releases/v1.11.21.md) — 历史版本详细变更文档

‎RULES.md‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
1-
# DevCodex v1.15.6 — 使用入口
1+
# DevCodex v1.15.7 — 使用入口
22

3-
> AI workflow injector for Copilot / Claude Code / Codex / Gemini / Grok · publisher: Rocky · version: 1.15.6
3+
> AI workflow injector for Copilot / Claude Code / Codex / Gemini / Grok · publisher: Rocky · version: 1.15.7
44
55
## 正式主支持客户端
66

‎changelogs/releases/v1.15.7.md‎

Lines changed: 43 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,43 @@
1+
# v1.15.7
2+
3+
> 发布日期:2026-07-31
4+
> 类型:Patch
5+
6+
## 摘要
7+
8+
本版本发布 SkillRoute MCP 契约与 closeout/rebind 防复发修复:`skill_route` 的 MCP schema 改为按操作分支声明字段,避免客户端继续把 `contextBinding` 传给 `catalog/load_stage/status`;Context Binding 失败不再只返回裸 `CONTEXT_BINDING_PENDING/STALE`,而是返回可执行的 refresh/rebind/load_stage 恢复建议;Stop hook 的 closeout 阻断也会给出下一步 `load_stage` 参数。
9+
10+
## 主要变更
11+
12+
- `skill_route` MCP `inputSchema` 改为 per-op `oneOf`:`catalog/load_stage/status` 不接收 `contextBinding`,`commit/rebind` 必须接收 `contextBinding`。
13+
- `REQUEST_FIELD_UNSUPPORTED` 返回 `SkillRouteRequestShapeErrorV1`,包含不支持字段、允许字段和下一步建议。
14+
- `CONTEXT_BINDING_PENDING/STALE` 返回 `SkillRouteContextRecoveryV1` 与 `nextOperation`,覆盖缺 receipt、identity mismatch、stale receipt、mandatory source 未满足等路径。
15+
- `status` 和 Stop closeout pending 返回 `SkillRouteNextActionV1`,明确下一次应调用 `load_stage` 还是 `rebind`,并附带可直接使用的参数。
16+
- canonical progressive Skill route schema 增加 `rebind` 操作,host capability runtime/adapter digest 同步刷新。
17+
- 回归测试覆盖 MCP schema、请求字段负例、stale receipt 恢复、closeout pending、Stop stale rebind 和 package release 路径。
18+
19+
## 验证
20+
21+
- `npm run test:skill-route-state`
22+
- `node scripts/test-mcp-servers.js`
23+
- `npm run test:skill-route`
24+
- `npm run test:context-read`
25+
- `npm run test:global-adapters-cli`
26+
- `npm run test:global-host-config`
27+
- `npm run test:package-projection`
28+
- `npm run test:pack-clean`
29+
- `npm run test:profile-governance`
30+
- `npm run test:release-metadata`
31+
- `npm run test:context-binding`
32+
- `npm run test:skill-route-closure`
33+
- `npm test` — `validation-20260731112755018-9ad8e1d5`,87/87
34+
- `npm run test:audit`
35+
- `npm run test:package-release` — `validation-20260731113505903-4581ed7d`,62/62
36+
- `npm run release:dry-run:all` — npmjs/GitHub registry dry-run 均 exitCode=0
37+
38+
## 发布说明
39+
40+
- npm 包名:`devcodex`
41+
- registry:`https://registry.npmjs.org/`
42+
- 发布分支:`main`
43+
- 发布路径:tag `v1.15.7` 触发 GitHub Actions `Publish to npm`

‎changelogs/unreleased.md‎

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,9 +1,10 @@
11
# 未发布变更(Unreleased)
22

33
> **用途**: 记录尚未正式发版的实现级变更。
4-
> **当前**: v1.15.6 已归档到 `changelogs/releases/v1.15.6.md`;本文件仅保留历史锚点索引与镜像供 validate 探针消费。发版后新实现再写入下方「当前未发布」。
4+
> **当前**: v1.15.7 已归档到 `changelogs/releases/v1.15.7.md`;本文件仅保留历史锚点索引与镜像供 validate 探针消费。发版后新实现再写入下方「当前未发布」。
55
66
## 当前未发布实现候选
7+
- **v1.15.7 已归档**:SkillRoute MCP schema 与 closeout/rebind 防复发已进入 `changelogs/releases/v1.15.7.md`。
78
- **v1.15.6 已归档**:README 目录导航与 SkillRoute stale receipt 防复发修复已进入 `changelogs/releases/v1.15.6.md`。
89
- **v1.15.5 已归档**:README 产品入口与 `@rocky` 自动推进说明、SkillRoute package runtime portfolio、MCP 来源观测桥接和 runtime contract digest 已进入 `changelogs/releases/v1.15.5.md`。
910
- **README 产品入口改版**:公共 README 从最低安装说明升级为面向使用者的产品入口;首屏补充问题、价值和 `npm install -g devcodex` CTA,突出上下文、记忆、80+ 内置 Skill、五宿主、报告验证闭环、工作区 Skill 与宿主原生资产共存边界;安装、更新、卸载仍保持一个命令,内置 Skill 新会话自动按意图生效。

‎content/duplication-inventory.json‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
{
22
"schemaVersion": "ControlContentDuplicationInventoryV1",
3-
"sourceBundleDigest": "a4136d87af36baba6f52a30fa4d63cb8806df7a56448fee6833fd20467a79b72",
3+
"sourceBundleDigest": "0083839a35d50d6c1a94065c4a501439c70a1abe63e9cf2970394c04442bc9e8",
44
"thresholds": {
55
"minParagraphChars": 100,
66
"sectionThreshold": 0.94,

‎content/instructions/00-safety.instructions.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
applyTo: "**"
33
description: 安全底线与输出语言规则,定义 S01~S07、违规处理与不可豁免边界
44
priority: P2
5-
version: 1.15.6
5+
version: 1.15.7
66
---
77
# 安全底线规范(S01~S07)
88

‎content/instructions/01-common.instructions.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
applyTo: "**"
33
description: 通用规范总则,覆盖优先级、意图路由、Profile/active-root、宿主适配与治理总线
44
priority: P5
5-
version: 1.15.6
5+
version: 1.15.7
66
---
77
# 通用规范
88

‎content/instructions/01a-profile-loading.instructions.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
applyTo: "**"
33
description: 意图驱动的 Profile 加载、active-root 路径、目标项目识别与项目现实扩展规范
44
priority: P5
5-
version: 1.15.6
5+
version: 1.15.7
66
---
77
# Profile 加载与项目现实扩展
88

‎content/instructions/01b-record-router.instructions.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
applyTo: "**"
33
description: 任务切换边界、RecordRouter 分流、Improvement Intake 与提交发布边界的通用规范
44
priority: P5
5-
version: 1.15.6
5+
version: 1.15.7
66
---
77
# 任务边界与 RecordRouter
88

‎content/instructions/01c-intent-expansion.instructions.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
applyTo: "**"
33
description: 意图识别、Intent Expansion Card、上下文重建与可见回复证据的通用规范
44
priority: P5
5-
version: 1.15.6
5+
version: 1.15.7
66
---
77
# 意图扩展与上下文重建
88

0 commit comments

Comments
 (0)