@@ -44,11 +44,11 @@ export NODE_AUTH_TOKEN=YOUR_GITHUB_PAT
4444
4545``` bash
4646npm install @vextjs/devcodex
47- npx devcodex init # Copilot
48- npx devcodex init --claude # Claude Code
47+ npx @vextjs/ devcodex init # 默认双部署: Copilot + Claude Code adapter
48+ npx @vextjs/ devcodex init --claude # 仅 Claude Code adapter
4949```
5050
51- ` init ` 会将规范文件复制到项目的 ` .github/ ` 目录:
51+ 默认 ` init ` 会先将 Copilot 规范文件复制到项目的 ` .github/ ` 目录,再链式部署 Claude Code adapter( ` CLAUDE.md + .claude/ + .mcp.json ` ) :
5252
5353```
5454.github/
@@ -64,7 +64,7 @@ npx devcodex init --claude # Claude Code
6464└── RULES.md ← 使用入口
6565```
6666
67- ` init --claude ` 会写入 ` CLAUDE.md ` 、` .claude/{instructions,skills,prompts,hooks/_runtime,mcp,data} ` 与 ` .mcp.json ` ,并同步开启项目级 hooks / MCP / permissions 配置。
67+ ` init --claude ` 是 Claude Code-only 路径:只写入 ` CLAUDE.md ` 、` .claude/{instructions,skills,prompts,hooks/_runtime,mcp,data} ` 与 ` .mcp.json ` ,并同步开启项目级 hooks / MCP / permissions 配置。
6868
6969> ⚠️ 请确保 IDE 的 "Use Instruction Files" 设置已开启(默认开启)。
7070>
@@ -125,16 +125,17 @@ npx devcodex init --claude # Claude Code
125125
126126| 命令 | 说明 |
127127| ------| ------|
128- | ` devcodex init ` | 初始化:复制 Copilot 规范文件到 ` .github/ ` |
129- | ` devcodex init --claude ` | 初始化:复制 Claude Code 规范文件到 ` CLAUDE.md ` 、` .claude/ ` 与 ` .mcp.json ` |
130- | ` devcodex update ` | 更新:同步最新规范到 ` .github/ ` |
128+ | ` devcodex init ` | 初始化:同步 Copilot ` .github/ ` ,并链式部署 Claude Code adapter |
129+ | ` devcodex init --claude ` | 初始化:仅同步 Claude Code adapter 到 ` CLAUDE.md ` 、` .claude/ ` 与 ` .mcp.json ` |
130+ | ` devcodex update ` | 更新:覆盖同步 Copilot ` .github/ ` ,并链式覆盖 Claude Code adapter |
131+ | ` devcodex update --claude ` | 更新:仅覆盖同步 Claude Code adapter |
131132| ` devcodex migrate-layout plan ` | 生成 ` .devcodex ` 工作区集中布局迁移清单 |
132133| ` devcodex migrate-layout apply --manifest <path> ` | 按 manifest 执行集中布局切换 |
133134| ` devcodex migrate-layout rollback --manifest <path> ` | 回滚集中布局迁移 |
134135| ` devcodex status ` | 状态:检查已安装的组件 |
135136| ` devcodex init --dry-run ` | 预览模式:仅显示将复制的文件 |
136137
137- ## ` .devcodex ` 工作区集中布局(v1.9.14 +)
138+ ## ` .devcodex ` 工作区集中布局(v1.10.0 +)
138139
139140当工作区根存在 ` <workspace>/.devcodex/layout.json ` 且 ` mode = workspace-namespace ` 时,DevCodex 会从“项目根各自持有 ` .devcodex ` ”切换到集中命名空间模型:
140141
@@ -194,10 +195,10 @@ node /path/to/devcodex/index.js status
194195
195196### 在 IDE 中验证规则自动生效
196197
197- 1 . 在目标项目执行 ` devcodex init ` (将文件复制到 ` .github/ ` )
198+ 1 . 在目标项目执行 ` devcodex init ` (默认同步 ` .github/ ` ,并链式部署 ` CLAUDE.md + .claude/ + .mcp.json ` )
1981992 . 重启 IDE
1992003 . Copilot:直接在 Copilot Chat 中输入普通需求,确认无需 ` @DevCodex ` 也会按规则工作
200- 4 . Claude Code:执行 ` devcodex init --claude ` 后,新开会话并确认 ` CLAUDE.md ` 、` .claude/settings.json ` 、` .mcp.json ` 已生效
201+ 4 . Claude Code-only:仅需单独部署 Claude Code adapter 时执行 ` devcodex init --claude ` ,随后新开会话并确认 ` CLAUDE.md ` 、` .claude/settings.json ` 、` .mcp.json ` 已生效
2012025 . 若在 VS Code 中启用了 Hooks,可在输出面板检查 ` GitHub Copilot Chat Hooks ` ,确认 ` .github/hooks/devcodex.lifecycle.json ` 已被加载
202203
203204### 文档站本地预览
@@ -232,13 +233,13 @@ devcodex/
232233
233234| AI 客户端 | 注入路径 | Bootstrap 硬门禁 | CP 门控 | 记忆/MCP | 等级 |
234235| ---| ---| :---:| :---:| :---:| :---:|
235- | ** GitHub Copilot (VS Code)** | ` .github/instructions/*.md ` + ` copilot-instructions.md ` + hooks | ✅ ` lifecycle.cjs ` PreToolUse | ✅ Hook | ✅ MCP | 🟢 Full |
236- | ** GitHub Copilot (JetBrains)** | 同上但无 hooks(instruction-fallback) | ⚠️ 仅文本约束 | ⚠️ 仅文本 | ⚠️ 部分 | 🟡 Beta |
236+ | ** GitHub Copilot (VS Code)** | ` .github/instructions/*.md ` + ` copilot-instructions.md ` + ` .github/agents/ ` | ⚠️ instruction-fallback | ⚠️ 文本/本地 fallback | ❌ 未内置 MCP | 🟡 Beta |
237+ | ** GitHub Copilot (JetBrains)** | 同上但无 hooks(instruction-fallback) | ⚠️ 仅文本约束 | ⚠️ 仅文本 | ❌ 未内置 MCP | 🟡 Beta |
237238| ** Claude Code (CLI/桌面端)** | ` CLAUDE.md ` + ` .claude/{instructions,skills,prompts,hooks/_runtime,mcp}/ ` + ` settings.json ` hooks + ` .mcp.json ` | ✅ ` lifecycle.cjs ` v1.9.2+ | ✅ Hook | ✅ MCP | 🟢 Full |
238239| ** Cursor IDE** | 通过 ` .github/instructions/ ` 兼容读取(实测) | ❌ 不支持 hooks | ⚠️ 仅文本 | ❌ | 🟡 Best-effort |
239240| ** ChatGPT / OpenAI Codex** | ❌ 无官方适配路径 | ❌ | ❌ | ❌ | 🔴 Unsupported |
240241
241- > ** 安装命令** :Copilot → ` npx devcodex init ` ;Claude Code → ` npx devcodex init --claude ` (v1.9.0+);Codex → 暂无(如需要可手工复制 ` prompts/ ` 模板使用,但无记忆/合规自动化)。
242+ > ** 安装命令** :默认双部署 → ` npx @vextjs/ devcodex init ` ;仅 Claude Code adapter → ` npx @vextjs/ devcodex init --claude ` (v1.9.0+);Codex → 暂无(如需要可手工复制 ` prompts/ ` 模板使用,但无记忆/合规自动化)。
242243>
243244> ** 能力差异** :🟢 Full = 硬门禁 + MCP + 自动同步;🟡 Beta/Best-effort = 仅 instruction 注入,无运行时拦截;🔴 Unsupported = 不在当前发布范围。
244245
0 commit comments