Skip to content

Commit 2c0a7c4

Browse files
committed
docs: close out skill visibility with ECR links and loading guide
Add user-facing guide for skill-load-verify and no meta-line behavior, link it from development CLI, and record B1-B3 process closeout in unreleased. Workspace ECR and 00-05 backfill live under .devcodex/devcodex requirements.
1 parent e243136 commit 2c0a7c4

4 files changed

Lines changed: 104 additions & 1 deletion

File tree

‎changelogs/unreleased.md‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -8,6 +8,7 @@
88
- **取消用户可见 SkillLoadReceipt 元行**:不再强制/注入 `【DevCodex 技能】…`;加载可见性靠宿主过程时间线 + `skill-load-verify`;Stop 仅 enforce 命中 skill 的 must-reply/body。
99
- **技能过程文案**:inject 引导过程侧写「正在加载 <id> 技能」,避免「命中 … 正在读取并按该技能执行」。
1010
- **宿主 skill 目录隐私**:PreToolUse 拦截 List/扫描 `~/.grok/skills`、`bundled/skills` 等用户主目录 skill 树,避免过程 UI 暴露 `C:\\Users\\…`;只允许读单个已知 SKILL.md。
11+
- **过程关账回填(B1–B3)**:ECR `reports/requirements/grok/20260727/01–03`;需求目录 `技能加载可见性收敛与验证` 00–05;用户站 `website/docs/guide/skills-loading.md`;Profile **N/A**。
1112
- **控制面 ImplementStartGate 防过程跳过**:`classifyImplementStartGate` 对控制面 mutation **禁止 unbound 放行**(`implement-start-without-task-binding`);绑定任务后除 04/05/复审清单外还须 **00/01 + 02 技术方案**(`implement-start-without-design`);lifecycle PreTool 无任务也 enforce。探针 `test-implement-start-gate.js`。需求:`VSCode全局MCP与五宿主同刷`(过程事故:承诺按流程却直接改码)。
1213
- **VS Code 全局 MCP 与五宿主同刷**:`global-adapters apply` / 全局安装在 Copilot host 事务中合并写入用户级 `Code/User/mcp.json`(及已存在的 Code - Insiders)的 `servers.devcodex-memory|profile`(stdio→copilot runtime mcp),保留既有 `inputs`/其它 server;测试与边界见 `global-host-target.resolveVscodeUserMcpPaths`。
1314
- **SkillsDeployModeV1(隐蔽运行时 + PR-1 防假绿)**:默认 `skillsDeployMode=hidden` 将 active skills 部署到 `~/.agents/devcodex/skills`(G_RUNTIME),停写/目录 prune `~/.agents/skills`、`~/.claude/skills`、`~/.copilot/skills` 中的包 managed id;`resolveGlobalSkillsRoot` 随 mode 切换(ENV `DEVCODEX_GLOBAL_SKILLS_ROOT` 仍最高优先);`global-adapters apply --mode=hidden|legacy` 与 npm lifecycle 透传;receipt 记录 mode。强化 `pr1EvidenceOk`:有 `02` 须独立实质 `03` 复审(长度+blocker=0+实质章节),拒绝 thin open-blocker / sessions-only;改写 stop-gate 负向探针。需求:`全局Skill与插件隐蔽运行时`。

‎website/docs/guide/development.md‎

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -20,7 +20,8 @@
2020
| `devcodex doctor` | 宿主诊断(`--completion` / `--json`) |
2121
| `devcodex probe` | 有界本地探针(`--json`) |
2222
| `devcodex trace show\|replay` | LocalTaskTrace |
23-
| `devcodex skill plan\|resolve\|match` | Skill bundle 计划 / W>G resolve / 工作区 Skill 匹配 |
23+
| `devcodex skill plan\|resolve\|match\|intent` | Skill bundle 计划 / W>G resolve / 工作区 match / 意图路由(含全局 verify 启发式) |
24+
| 技能加载怎么验 | 见 [技能加载与验证](/guide/skills-loading)(`验证技能加载` → `SKILL-LOAD-VERIFY-OK`;无强制元行) |
2425
| `devcodex task resolve\|verify\|risk` | 任务名续接 / 对账 / 可放弃风险 |
2526

2627
常用验证(维护者):`npm run test:core` · `npm run test:workflow-capabilities` · `npm run test:docs-surface-inventory` · `npm run test:process-enforcement-e2e` · `npm run test:host-parity` · `npm run test:public-text-integrity` · `npm run test:stop-gate`。站点构建见 `website/`(Rspress,Node `^20.19 \|\| >=22.12`)。

‎website/docs/guide/index.md‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -35,4 +35,5 @@
3535
- [Profile 使用指南](./profile) — Profile 分档 plan/init、功能清单 Schema
3636
- [需求管理](./requirements) — 新建需求、优先级判断、文件模板
3737
- [开发规范](./development) — CLI 速查、组件使用、进度与条件门禁索引
38+
- [技能加载与验证](./skills-loading) — 无元行、`skill-load-verify`、CLI intent/resolve
3839
- [版本与发布](./release) — 版本规则、CHANGELOG 写入规范
Lines changed: 100 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,100 @@
1+
# 技能加载与验证
2+
3+
> 面向使用者:如何确认 DevCodex 技能是否加载,以及 **不要** 期望什么。
4+
5+
---
6+
7+
## 你会看到什么
8+
9+
| 位置 | 行为 |
10+
|------|------|
11+
| **最终回复正文** | **不**强制出现 `【DevCodex 技能】…` 元信息行(已收敛取消) |
12+
| **宿主过程时间线** | 可能看到工具/Skill 步骤;推荐文案 **「正在加载 &lt;id&gt; 技能」** |
13+
| **IDE skill 菜单** | `skillsDeployMode=hidden` 时全局包 skill 可能**不显示**(不等于未加载) |
14+
15+
全局 skill 真实目录(hidden):
16+
17+
```text
18+
~/.agents/devcodex/skills/<id>/SKILL.md
19+
```
20+
21+
工作区 skill:
22+
23+
```text
24+
<workspace>/.devcodex/workspace/skills/<id>/SKILL.md
25+
```
26+
27+
---
28+
29+
## 一键验证(推荐)
30+
31+
在对话中发送:
32+
33+
```text
34+
验证技能加载
35+
```
36+
37+
(或 `skill load verify` / `用 skill-load-verify skill`)
38+
39+
**期望用户可见固定句:**
40+
41+
```text
42+
SKILL-LOAD-VERIFY-OK
43+
```
44+
45+
无需再检查元信息行。该 skill 不写代码、不做项目分析。
46+
47+
---
48+
49+
## CLI 验证
50+
51+
源码仓或已 `npm install -g .` / 正式包安装后:
52+
53+
```bash
54+
devcodex skill intent "验证技能加载" --json
55+
devcodex skill resolve skill-load-verify
56+
devcodex skill plan intent
57+
devcodex skill match "用 test skill" # 仅工作区 AutoMatch
58+
```
59+
60+
| 子命令 | 作用 |
61+
|--------|------|
62+
| `skill intent` | 工作区意图 + 全局 author/verify 启发式 |
63+
| `skill resolve` | W>G 解析单 skill |
64+
| `skill match` | 工作区 AutoMatch(不覆盖全局 verify 启发式) |
65+
| `skill plan` | 依赖闭包 bundle 计划(需包内 `skills/portfolio.json`) |
66+
67+
未发布 npm 时请从源码根:
68+
69+
```bash
70+
cd <devcodex-source>
71+
npm install -g .
72+
npm run global-adapters:apply
73+
```
74+
75+
若 PATH 仍指向旧包 `@vextjs/devcodex`,先卸载再安装。
76+
77+
---
78+
79+
## 隐私提示
80+
81+
请勿在过程中 **List** 用户主目录下的宿主 skill 树(例如 `~/.grok/skills`、`~/.grok/bundled/skills`),以免过程 UI 暴露 `C:\Users\…` 路径。
82+
应 **Read 单个** 已知 `SKILL.md` 路径。Hook 对经 PreToolUse 的此类 List 会拦截(`host-skill-inventory-ban`)。
83+
84+
---
85+
86+
## 宿主差异(诚实上限)
87+
88+
| 宿主 | 说明 |
89+
|------|------|
90+
| Codex 等 UPS 较完整 | 更易注入 skill 正文;验证句更稳 |
91+
| Grok Partial | 无可靠 UserPromptSubmit inject;依赖模型读 skill + 条件 Stop |
92+
93+
详见 [Grok 宿主对齐](/intro/host-parity-grok)。
94+
95+
---
96+
97+
## 相关
98+
99+
- 维护者 CLI 速查:[开发规范](/guide/development#cli-速查)
100+
- 变更台账:`changelogs/unreleased.md`(skill-load-verify / 取消元行)

0 commit comments

Comments
 (0)