Skip to content

Commit 727f27a

Browse files
committed
fix: close audit repair backlog
1 parent a037f92 commit 727f27a

63 files changed

Lines changed: 841 additions & 287 deletions

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

‎.mcp.json‎

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -4,19 +4,19 @@
44
"type": "stdio",
55
"command": "node",
66
"args": [
7-
"${CLAUDE_PROJECT_DIR:-.}/.claude/mcp/memory-server.js",
8-
"${CLAUDE_PROJECT_DIR:-.}"
7+
".claude/mcp/memory-server.js",
8+
"."
99
],
1010
"_note": "Reads/writes .devcodex/.memory/ session files and records CP confirmations."
1111
},
1212
"devcodex-profile": {
1313
"type": "stdio",
1414
"command": "node",
1515
"args": [
16-
"${CLAUDE_PROJECT_DIR:-.}/.claude/mcp/profile-server.js",
17-
"${CLAUDE_PROJECT_DIR:-.}"
16+
".claude/mcp/profile-server.js",
17+
"."
1818
],
1919
"_note": "Loads .devcodex/profile/ files and returns ENV_MODE / agent config."
2020
}
2121
}
22-
}
22+
}

‎README.md‎

Lines changed: 14 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -44,11 +44,11 @@ export NODE_AUTH_TOKEN=YOUR_GITHUB_PAT
4444

4545
```bash
4646
npm 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`)
198199
2. 重启 IDE
199200
3. 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` 已生效
201202
5. 若在 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

‎agents/README.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -29,7 +29,7 @@
2929

3030
## 使用建议
3131

32-
- **默认**:不引入 agents/,直接用 Copilot Chat(通过 instructions/ 自动注入规则)
32+
- **默认**:保留 `devcodex init/update` 自动分发的 `.github/agents/`;日常可直接用 Copilot Chat,只有需要显式入口时再 `@devcodex` / `@devcodex-auto`
3333
- **高频维护**:引入 `@devcodex-auto`,在确保仓库可回滚的前提下加速执行
3434
- **严格审查**:引入 `@devcodex`,确保每个关键节点有人工确认
3535

‎changelogs/TEMPLATE.md‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -95,8 +95,8 @@ npx @vextjs/devcodex update
9595

9696
## 🔗 相关资源
9797

98-
- [需求文档](../website/docs/requirements/)
99-
- [进度追踪](../website/docs/progress/)
98+
- 需求文档:填写实际 `website/docs/versions/.../requirements/...` 或 `.devcodex/.../requirements/...` 路径
99+
- 进度追踪:填写实际任务进度、报告或发布验证路径
100100

101101
---
102102

‎changelogs/unreleased.md‎

Lines changed: 16 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -8,5 +8,21 @@
88

99
## 2026-05-26
1010

11+
- 澄清 init/update 同步语义:默认 `init/update` 会同步 Copilot `.github/` 并链式部署 Claude Code adapter,`--claude` 为 Claude-only 路径;同步更新 README、CLI help 与项目 Profile。
12+
- 修复本轮全面审查问题清单:补齐 validate V2/V3/V6/V8/V19 覆盖,新增 `scripts/check-syntax.js`,并将 `test:all` 扩展为发布前全量验证链路(validate、Hook/MCP/fallback/migrate、pack、website build、root/website audit、语法检查)。
13+
- 修复 Hook/MCP/fallback 运行时边界:支持 `optimizations`、`scenario-tests` 任务根,避免只读搜索危险命令字样被误拦,补充无 `WHERE` 的 `DELETE FROM` 阻断与回归测试。
14+
- 修复 CLI 与分发一致性:`init`/`init --claude` 自动创建 `.devcodex/.audit-state/` 并写入 `.gitignore`,`status`/`doctor` 支持 workspace-namespace profile,`detectAgent` 优先宿主环境变量。
15+
- 同步规范、模板与文档站:统一 active-root/workspace-namespace、报告产物 Markdown 链接、G1~G11、data runtime/template 语义与 analyze 子类型口径。
16+
- 清理维护态记录分发边界:将源仓真实治理台账迁入 `.devcodex/.maintainer-state/` 本地维护态,npm 包仅保留空模板与示例说明。
17+
- 修复 Stop hook 可见回复读取根因:Copilot Stop payload 只提供 `transcript_path` 时,Hook 会从 JSONL transcript 解析最新 assistant 正文,再执行入口检查、合规块与产物路径检测,避免把“未读取 transcript”误报为用户未输出产物。
18+
- 明确 devcodex-v1 本地开发同步边界:修改分发源后必须在工作区根同步 `.github/.claude`,不再把源码仓根 `.github/.claude` 作为部署副本目标。
19+
- 修复复审遗留问题:MCP `.mcp.json` smoke test 改为在临时目标项目中验证 `.claude/mcp` 部署产物,避免依赖源码仓未跟踪副本假绿。
20+
- 修复产物路径单行链接边界:Hook 现在能识别位于回复末尾的产物区 Markdown 链接,并补充 Stop reminder 回归测试。
21+
- 修复 V8 部署同步误报:父级 `.github/.claude` 同步检查改为内容哈希优先,避免内容一致但 mtime 较旧时继续产生 stale warning。
22+
- 同步 audit-state finding 状态枚举:规范与校验统一支持 `pending`、`in-progress`、`transferred`、`superseded` 等状态,并阻断终态未解决 findings。
23+
- 修复 hook 关闭阶段与 bootstrap 阶段重复提醒:同一轮相同缺失项只提示一次,并同步当前工作区 `.github/.claude` 部署副本。
24+
- 修复产物路径检测兼容性:支持反引号包裹的 Windows 绝对路径,并允许产物区单行 Markdown 链接被识别为已输出产物。
25+
- 修复 Claude Code MCP 启动契约:`.mcp.json` 改为跨平台相对路径参数,新增按真实 `.mcp.json` 启动服务器的 smoke test。
26+
- 修复 `devcodex status` 在 workspace namespace 项目目录下误判 profile 缺失的问题,并收紧 audit-state 终态 open findings 校验。
1127
- 调整 lifecycle hook 默认执行策略为 `safety-only`:bootstrap、CP gate、Auto 白名单等流程问题改为提醒放行,仅危险命令继续硬拦,避免多项目/附件场景下读取与澄清工具被自锁。
1228
- 增强多项目目标识别:支持从提示词裸项目名和附件路径推断目标项目,并补充 hook runtime 回归测试。

‎changelogs/v1.1.0.md‎

Lines changed: 5 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -104,9 +104,11 @@ npm run test:version
104104

105105
## 🔗 相关资源
106106

107-
- [需求概述](../../.devcodex/devcodex-v1/requirements/instructions-first架构迁移/01-需求概述.md)
108-
- [技术方案](../../.devcodex/devcodex-v1/requirements/instructions-first架构迁移/02-技术方案.md)
109-
- [审查报告](../../.devcodex/devcodex-v1/requirements/instructions-first架构迁移/reports/copilot/20260410/01--instructions-first技术方案深度审查.md)
107+
本版本发布时关联的需求、技术方案与审查报告属于迁移前本地 `.devcodex` 运行态产物,当前仓库不再保留为可点击相对链接;历史路径仅作审计线索:
108+
109+
- `requirements/instructions-first架构迁移/01-需求概述.md`
110+
- `requirements/instructions-first架构迁移/02-技术方案.md`
111+
- `requirements/instructions-first架构迁移/reports/copilot/20260410/01--instructions-first技术方案深度审查.md`
110112

111113
---
112114

‎changelogs/v1.9.5.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -9,7 +9,7 @@
99
### 1.1 `instructions/17-compliance.instructions.md` — 新增 FC7
1010
- FC 表第 7 行:所有 AskUserQuestion / 多选项决策节点必须有且仅有 1 个 🟢 推荐项(首位置 + 标签含 `(推荐)`) + 一句话推荐理由(实证依据/风险权衡/性价比)。
1111
- 适用范围:CP1/CP2/CP3 范围选择、方案对比、audit/analyze 报告 §决策点。
12-
- 关联:[PI-005](../data/process-improvements.md#pi-005)。
12+
- 关联:PI-005(维护态记录:`.devcodex/.maintainer-state/process-improvements.md`)。
1313

1414
### 1.2 `skills/cp-gate/SKILL.md` — 新增 §用户决策节点
1515
- AskUserQuestion JSON 调用模板:1 推荐项首位 + 描述以"推荐理由:"开头;其他选项列 "代价/适用场景"。

‎data/README.md‎

Lines changed: 6 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -24,7 +24,11 @@ data/
2424

2525
## init 行为
2626

27-
`devcodex init` / `devcodex init --claude` 将 `data/templates/*.md` 复制到目标项目的运行时数据目录(当前分发骨架仍落到 `.github/data/*.md` 或 `.claude/data/*.md` 对应结构)。
27+
`devcodex init` / `devcodex init --claude` 将 `data/templates/*.md` 复制到目标项目的运行时数据目录:
28+
29+
- Copilot:`.github/data/*.md`
30+
- Claude Code:`.claude/data/*.md`
31+
- 规范正文中写 `data/*.md` 时,表示目标项目运行时台账的逻辑路径,不表示源仓根 `data/` 保存真实记录。
2832

2933
## 路径语义
3034

@@ -37,7 +41,7 @@ data/
3741

3842
而在**源仓**里:
3943

40-
- `data/templates/*.md`:仅提供空模板
44+
- `data/templates/*.md`:仅提供空模板与允许的 EXAMPLE 行
4145
- `.devcodex/.maintainer-state/`:维护者自己的实际记录,不参与 npm 分发
4246

4347
换句话说,规范里写 `data/*.md` 时,表达的是“应该把记录落到运行时台账”,不是说源仓根 `data/` 目录里直接保存真实记录。

‎data/pending-issues.md‎

Lines changed: 0 additions & 27 deletions
This file was deleted.

‎data/process-improvements.md‎

Lines changed: 0 additions & 53 deletions
This file was deleted.

0 commit comments

Comments
 (0)