Skip to content

Commit ae94e6c

Browse files
committed
docs: document skill route retirement gate
1 parent cf8e707 commit ae94e6c

2 files changed

Lines changed: 3 additions & 2 deletions

File tree

‎README.md‎

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -141,7 +141,7 @@ devcodex profile plan|init
141141
| 工作区 skill(W 优先) | `.devcodex/workspace/skills/<id>/SKILL.md` |
142142
| 全局 skill(hidden) | `~/.agents/devcodex/skills/<id>/`(菜单可能不显示,仍可加载) |
143143

144-
**未发布源码候选**:渐进式 Skill 路由会在每轮建立 W + managed G 动态快照,再按 catalog → commit → stage 分页加载正文;全程使用宿主按需启动的本地 stdio MCP 子进程,不监听端口,也不需要服务端。新增或修改 `.devcodex/workspace/skills/<id>/SKILL.md` 会让旧快照失效,并在下一轮重新发现。
144+
**未发布源码候选**:渐进式 Skill 路由会在每轮建立 W + managed G 动态快照,再按 catalog → commit → stage 分页加载正文;全程使用宿主按需启动的本地 stdio MCP 子进程,不监听端口,也不需要服务端。新增或修改 `.devcodex/workspace/skills/<id>/SKILL.md` 会让旧快照失效,并在下一轮重新发现。旧路由只会在五个精确宿主入口均取得当前版本的生产证据,并连续满足 72 小时、每宿主 20 次、总计 100 次和零异常后退役;维护者可运行 `npm run check:skill-route-retirement` 查看门禁。
145145

146146
Codex/Claude 等宿主自己的 `AGENTS.md`、`CLAUDE.md`、原生个人/项目 Skill 仍由宿主负责发现。DevCodex 不扫描、复制、合并、覆盖或删除这些用户资产;同名也不视为 DevCodex 所有权。Codex 项目指令使用 `AGENTS.md`(不是 `codex.md`),Claude 项目指令使用精确文件名 `CLAUDE.md`,Skill 入口使用精确文件名 `SKILL.md`。
147147

@@ -227,6 +227,7 @@ cd <devcodex-source-root>
227227
npm install
228228
npm run test:stop-gate
229229
npm run test:docs-surface-inventory
230+
npm run check:skill-route-retirement
230231
npm run global-adapters:apply
231232
```
232233

‎changelogs/unreleased.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@
44
> **当前**: v1.15.3 已归档到 `changelogs/releases/v1.15.3.md`;本文件仅保留历史锚点索引与镜像供 validate 探针消费。发版后新实现再写入下方「当前未发布」。
55
66
## 当前未发布实现候选
7-
- **工作区 Skill 意图结构化与渐进路由**:83 个 active Skill 增加 `SkillIntentV1`;运行时构建 W + managed G 动态快照,经单一 `skill_route` MCP Tool 执行 catalog/commit/load_stage/status、0/1 自由选择、依赖闭包、冲突与预算校验、分阶段正文加载、条件重规划、幂等重放、上下文截断恢复和有锁 GC。仅有新鲜能力证据的 exact `grok-cli-single/global-launcher-local-stdio` 可进入 unified;其他宿主 fail-closed 到 legacy。MCP 为宿主按需启动的本地 stdio 子进程,无端口、HTTP、远程服务或常驻 daemon。W 在每轮动态发现;用户原生 `AGENTS.md` / `CLAUDE.md` / `SKILL.md` 与个人 Skill 保持宿主所有权,同名不构成清理或覆盖权限。完整 full `86/86`、profile-deploy、package-release 与真实 tarball global-install 均通过。
7+
- **工作区 Skill 意图结构化与渐进路由**:83 个 active Skill 增加 `SkillIntentV1`;运行时构建 W + managed G 动态快照,经单一 `skill_route` MCP Tool 执行 catalog/commit/load_stage/status、0/1 自由选择、依赖闭包、冲突与预算校验、分阶段正文加载、条件重规划、幂等重放、上下文截断恢复和有锁 GC。仅有新鲜能力证据的 exact `grok-cli-single/global-launcher-local-stdio` 可进入 unified;其他宿主 fail-closed 到 legacy。五精确宿主身份、Copilot camelCase Hook、直接 S15 与 `SkillRouteRetirementGateV1` 已落地;legacy 只有在当前 runtime/adapter digest 下连续 72 小时、每宿主 20 次、总计 100 次且六类异常全为 0 后才可退役。当前真实检查 accepted=1/100,因此 legacy 保留。MCP 为宿主按需启动的本地 stdio 子进程,无端口、HTTP、远程服务或常驻 daemon。W 在每轮动态发现;用户原生 `AGENTS.md` / `CLAUDE.md` / `SKILL.md` 与个人 Skill 保持宿主所有权,同名不构成清理或覆盖权限。完整 full/staged `87/87`、profile-deploy、package-release 与真实 tarball global-install 均通过。
88
- **公共 README 校验迁移**:以严格 `PublicReadmeContractV1` 替代要求公共 README 罗列内部 Gate/Skill/控制面术语的历史断言;README/client/release/workflow/brand/turn/execution consumers 共用该边界,并用损坏核心安装路径的负向探针防止宽松绕过。
99
- **全局验证 skill `skill-load-verify`**:触发「验证技能 / skill load verify」;用户可见仅固定句 `SKILL-LOAD-VERIFY-OK`;Skill 规模 85→**86**(83 active + 3 gray)。
1010
- **取消用户可见 SkillLoadReceipt 元行**:不再强制/注入 `【DevCodex 技能】…`;加载可见性靠宿主过程时间线 + `skill-load-verify`;Stop 仅 enforce 命中 skill 的 must-reply/body。

0 commit comments

Comments
 (0)