Skip to content

Commit f3df5b4

Browse files
committed
release: v1.11.1
1 parent eb11096 commit f3df5b4

37 files changed

Lines changed: 365 additions & 66 deletions

‎CHANGELOG.md‎

Lines changed: 4 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,14 +1,15 @@
11
# 变更日志 (CHANGELOG)
22

33
> **说明**: 版本概览摘要。最新版本的详细变更见下方表格首行的 `changelogs/vX.Y.Z.md` 链接;历史版本见对应详细变更文件
4-
> **最后更新**: 2026-05-26
4+
> **最后更新**: 2026-05-27
55
66
---
77

88
## 版本概览
99

1010
| 版本 | 日期 | 变更摘要 | 详细 |
1111
|------|------|---------|------|
12+
| [v1.11.1](./changelogs/v1.11.1.md) | 2026-05-27 | 🔧 **Codex 宿主闭环 + Hook 契约与执行复审增强**:补齐 Codex adapter 分发、宿主实际落点、Hook 拦截状态机、危险命令确认、MCP memory scope、宿主输出契约 direct replay,并新增 ECR、Intent Expansion Card、ConfirmationRequest 与报告推荐结论校验 | [查看](./changelogs/v1.11.1.md) |
1213
| [v1.11.0](./changelogs/v1.11.0.md) | 2026-05-26 | 🎯 **全模式入口检查 + 项目现实扩展**:PC0~PC7 从 dev-only 提升为所有模式基础入口状态,dev 模式保留 PC4 完整规范雷达与 FC/SC/RC/T;新增“语义初判 → Profile → 项目现实扩展 → 最终路由”链路,并同步 runtime bootstrap/Stop 提醒、模板、Skills、validate 探针、README 与网站文档 | [查看](./changelogs/v1.11.0.md) |
1314
| [v1.10.0](./changelogs/v1.10.0.md) | 2026-05-26 | 🎯 **工作区集中存储 + 真实迁移闭环**:新增 `migrate-layout` CLI 与迁移 smoke test,落地 `.devcodex` `workspace-namespace` 存储模型并完成真实 `E:\Worker` 工作区迁移;统一 MCP/Hook/validate/profile 对新布局的解析,收口 `pending-issues` 模板链、多客户端真相源、agent 枚举与治理探针,并同步 `.github/.claude` 部署副本 | [查看](./changelogs/v1.10.0.md) |
1415
| [v1.9.13](./changelogs/v1.9.13.md) | 2026-05-25 | 🔧 **目标文档前置 + 最终回复闭环提醒补强**:为 `dev` / `docs` 主链补入契约驱动型“目标文档前置”与执行后“轻量复审收敛”正式阶段表达,澄清 `dev-docs` 与 `api-verification` 的轻量文档 / 归档验证边界;同时在 `hooks/_runtime/lifecycle.cjs` 为 dev 模式最终回复补入合规状态块与 FC5 产物路径的 `Stop` 兜底提醒,并通过 `test-hooks-runtime.js` 覆盖 artifact section 边界误判样本 | [查看](./changelogs/v1.9.13.md) |
@@ -86,7 +87,8 @@
8687

8788
## 相关文档
8889

89-
- [`changelogs/v1.11.0.md`](./changelogs/v1.11.0.md) — 最新版本详细变更文档
90+
- [`changelogs/v1.11.1.md`](./changelogs/v1.11.1.md) — 最新版本详细变更文档
91+
- [`changelogs/v1.11.0.md`](./changelogs/v1.11.0.md) — 上一个版本详细变更文档
9092
- [`changelogs/v1.10.0.md`](./changelogs/v1.10.0.md) — 上一个版本详细变更文档
9193
- [`changelogs/v1.9.11.md`](./changelogs/v1.9.11.md) — 历史版本详细变更文档
9294
- [`changelogs/v1.9.10.md`](./changelogs/v1.9.10.md) — 历史版本详细变更文档

‎README.md‎

Lines changed: 9 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -21,6 +21,9 @@ DevCodex 通过 `.github/`(Copilot)、`CLAUDE.md + .claude/ + .mcp.json`(C
2121
- **宿主生命周期护栏**: Claude Code 与 OpenAI Codex 在已支持的 Hook 事件上提供 runtime 护栏;Copilot / JetBrains / Cursor 等无等价本地 Hook 时降级为 instruction-fallback;默认 `safety-only` 仅对危险命令硬拦,流程项提醒放行,`strict` 模式才升级可阻断事件
2222
- **全模式入口检查**: 所有模式在实质任务前显示 PC0~PC7;dev 模式额外执行 PC4 规范雷达与完整合规链
2323
- **项目现实扩展**: 先做语义意图初判,再结合目标项目 Profile、目录与当前任务上下文修正最终路由、产物落点和验证方式
24+
- **执行闭环复审**: dev/fix 完成前执行 ECR 执行闭环复审,交叉验证 CP 产物、报告、daily memory、SUMMARY、diff/commit、测试/探针与 dirty 边界
25+
- **推荐结论**: analyze/audit/report 多建议或多路径场景必须给出推荐结论与推荐理由;无后续动作时明确写“推荐:无后续动作”
26+
- **确认交互降级**: 用户确认先抽象为 ConfirmationRequest,再按宿主能力选择按钮、权限提示、Hook 阻断或文本确认 fallback,不把按钮 UI 承诺为全宿主能力
2427
- **执行护栏**: 新需求切换时优先按意图判断边界;涉及外部平台/API/兼容性判断时优先看官方文档;提交时压缩 commit subject
2528

2629
## 安装
@@ -92,10 +95,10 @@ AGENTS.md ← 与 instructions.md / copilot-instructions.md / CL
9295

9396
```
9497
帮我重构 user 模块的权限校验逻辑
95-
→ 自动识别为 dev 工作流 → CP1 需求确认 → CP2 方案确认 → CP3 实施计划 → 执行 → 轻量复审收敛 → 完成
98+
→ 自动识别为 dev 工作流 → CP1 需求确认 → CP2 方案确认 → CP3 实施计划 → 执行 → ECR 执行闭环复审 → 完成
9699
97100
这个接口返回 500 了
98-
→ 自动识别为 fix 工作流 → 根因分析 → 修复方案 → 执行 → 三步扫描 → 轻量复审收敛 → 完成
101+
→ 自动识别为 fix 工作流 → 根因分析 → 修复方案 → 执行 → 三步扫描 → ECR 执行闭环复审 → 完成
99102
100103
深度审查一下这个项目的代码质量
101104
→ 自动识别为 audit 工作流 → 多轮收敛审查 → 输出报告
@@ -114,7 +117,7 @@ AGENTS.md ← 与 instructions.md / copilot-instructions.md / CL
114117
- CP1:确认需求目标、用户交互、业务流程、验收结果与范围边界
115118
- CP2:确认实现流程、节点职责、公共契约、兼容性策略、边界问题与测试策略
116119
- CP3:确认实施顺序、里程碑、验证方式、风险与回滚
117-
- 执行后正式阶段:轻量复审收敛(确认实现、关键产物与完成结论一致)
120+
- 执行后正式阶段:ECR 执行闭环复审(确认实现、关键产物、报告、记忆、SUMMARY、diff/commit、测试与完成结论一致)
118121

119122
当需求属于契约驱动型场景(例如对外 API、前端联调接口、页面/组件契约)时,可在 CP2 前先冻结目标文档,再让技术方案与实施围绕该文档落地。
120123

@@ -129,7 +132,10 @@ AGENTS.md ← 与 instructions.md / copilot-instructions.md / CL
129132
- **意图优先**:当用户看起来切到新需求时,先基于上下文判断意图;只有意图不清晰时才用关键词辅助,而不是反过来。
130133
- **入口检查全模式显示**:无论 `prod` 还是 `dev`,都会先展示 PC0~PC7;`prod` 只显示基础状态,`dev` 追加规范雷达、合规检查和完成验证。
131134
- **项目现实扩展再路由**:识别用户意图后,会先加载目标项目 Profile,并用项目技术栈、目录结构、当前需求上下文修正最终工作流,避免只按字面关键词执行。
135+
- **Intent Expansion Card**:非 chat 工作流会在 CP1 / 问题确认前形成可审查卡片,记录项目、连续性、模块领域、风险、宿主能力、验证路线、置信度和备选路线。
132136
- **边界先确认**:若已判断为新需求切换,且当前工作区还有未提交变更,会先提醒是否应先提交当前变更。
137+
- **报告推荐项**:当报告中存在多个可执行建议或后续路径时,会明确给出推荐结论和推荐理由;没有建议时也会写明“推荐:无后续动作”。
138+
- **确认交互适配**:ConfirmationRequest 是确认语义的统一抽象;Claude Code SDK / VS Code 扩展可用按钮,Hook 宿主可用阻断原因,Cursor / JetBrains 等 fallback 宿主使用文本确认。
133139
- **高联动默认联查**:当任务涉及控制面规则、模板、接口契约/验证产物、工作区真相源/部署副本或发布口径变更时,会默认联查相关文件;若同时命中多真相源同步或模板-示例-校验链,会升级为交叉验证或 `CRS`。
134140
- **官方资料优先**:涉及平台能力、框架 API、版本兼容性或工具语义判断时,优先读取官方文档,再降级到其他资料。
135141
- **提交标题收短**:用户要求提交时,DevCodex 会优先生成一句简洁的 commit subject,而不是把整段会话摘要塞进标题。

‎RULES.md‎

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

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

‎changelogs/unreleased.md‎

Lines changed: 1 addition & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -8,14 +8,7 @@
88

99
## 2026-05-27
1010

11-
- 新增 Codex adapter:默认 `devcodex init/update` 升级为 Copilot + Claude Code + Codex 三宿主同步,`--codex` 提供 Codex-only 路径并与 `--claude` 互斥。
12-
- 补齐 Codex 入口与 Hook 链路:`instructions.md` 同源生成 `AGENTS.md`,`skills/` 同步到 `.agents/skills/`,新增 `codex/hooks.json` 并同步统一 `lifecycle.cjs` 到 `.codex/hooks/_runtime/`。
13-
- 修复 Codex 新会话无预检查风险:`UserPromptSubmit` 输出同时包含 `systemMessage` 与 `hookSpecificOutput.additionalContext`,并新增 Hook runtime 回归测试。
14-
- 扩展发布前校验:V6/V8/V13/V24 与 pack-clean 覆盖 Codex 打包资产、部署副本哈希、Hook 语义探针、文档/Profile 口径和 workspace adapter 同步状态。
15-
- 修复 Codex 边界诊断与文档口径:multi-project warning 同步注入 `additionalContext`,`status/doctor` 增加 Codex hook command 与 config/trust 诊断,README 支持矩阵区分 OpenAI Codex 与 ChatGPT 普通对话。
16-
- 修复记忆与报告 `<agent>` 落点规则:当前实际宿主优先,`profile/config.json` 的 `agent` 仅作为无法识别宿主时的兜底提示,并补 MCP/validate 回归探针。
17-
- 修复 Hook 拦截语义与 MCP 作用域边界:新增 `forbid / require_completion / warn_continue / log_only` 动作模型、`interceptions.jsonl` 审计日志、危险命令一次性确认令牌,收紧 doctor 的 Codex/VS Code Hook 能力口径,并要求 workspace-namespace 下 memory MCP 从工作区根调用时显式传 `project` 或 `scope:"workspace"`。
18-
- 修复 Hook 宿主输出契约:Codex `Stop/UserPromptSubmit` 改为顶层 `decision:"block"`,`PreCompact` 改为 `continue:false`;Claude `PreCompact` 纳入 strict 硬拦矩阵,危险命令 approval id 必须经用户确认后才可消费。
11+
- 暂无未发布变更。
1912

2013
## 2026-05-26
2114

‎changelogs/v1.11.1.md‎

Lines changed: 34 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,34 @@
1+
# v1.11.1 — Codex 宿主闭环与执行复审增强
2+
3+
> 发布日期:2026-05-27
4+
5+
## Highlights
6+
7+
- Codex adapter 闭环:默认 `devcodex init/update` 已覆盖 Copilot、Claude Code、Codex 三宿主同步,`instructions.md` 继续作为 AGENTS/CLAUDE/Copilot instructions 的单源规范。
8+
- Hook 宿主契约修复:补齐 `forbid / require_completion / warn_continue / log_only` 拦截状态机、危险命令一次性确认、Codex/Claude 输出契约 direct replay 与审计日志。
9+
- 执行闭环增强:新增 ECR 执行闭环复审、Intent Expansion Card、ConfirmationRequest 与报告推荐结论要求,降低长会话压缩后的假完成风险。
10+
11+
## Changed
12+
13+
- 更新 README、`instructions.md`、`instructions/01-common`、`10-dev`、`11-fix`、`13-analyze`、`17-compliance`,统一 ECR、意图扩展、确认请求与推荐结论语义。
14+
- 更新 `skills/compliance`、`cp-gate`、`dev-default`、`dev-plan-review`、`fix-default`、`intent`、`load-profile`、`report`,把闭环复审、宿主能力、推荐结论和确认抽象纳入执行规则。
15+
- 更新 report/precheck prompt 模板,要求多建议或决策场景必须输出推荐项和推荐理由。
16+
- 更新网站开发指南与执行/预检查/报告/流程图规范页,保持用户文档与运行规则同源。
17+
18+
## Fixed
19+
20+
- 修复 Codex 新会话入口提醒、multi-project warning、status/doctor Codex 诊断与 ChatGPT/Codex 能力表述边界。
21+
- 修复记忆与报告 `<agent>` 落点规则:当前实际宿主优先,profile `agent` 仅作为兜底。
22+
- 修复 workspace-namespace 下 MCP memory scope 从工作区根调用时的歧义,要求显式传 `project` 或 `scope:"workspace"`。
23+
- 修复 Codex `Stop/UserPromptSubmit/PreCompact` 与 Claude `PreCompact` 的宿主 block 输出契约,并补 direct replay 防回归探针。
24+
25+
## Validation
26+
27+
- `node scripts/validate.js`
28+
- `npm test`
29+
- `npm run test:all`
30+
- `npm publish --dry-run --access restricted`
31+
32+
## Included Unreleased Items
33+
34+
- 2026-05-27 所有 Codex adapter、Hook 宿主契约、MCP scope、ECR、Intent Expansion Card、ConfirmationRequest 与报告推荐结论相关未发布条目。

‎instructions.md‎

Lines changed: 11 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -105,6 +105,7 @@
105105
- 项目现实扩展必须结合目标项目的技术栈、目录结构、当前需求/bug 产物、测试/发布约束,修正或确认最终工作流/子类型。
106106
- 项目未识别时,不得为了扩展意图而无界扫描工作区;必须先询问用户。
107107
- PC1 应表达“语义初判 → 项目现实扩展后的最终路由”,PC3 应表达扩展结果与产物落点。
108+
- 非 chat 工作流在 CP1 / 问题确认前必须形成 Intent Expansion Card:`semantic`、`project`、`continuity`、`action`、`domain`、`artifact-impact`、`risk`、`host-capability`、`validation-route`、`confidence`、`alternatives`,用于 PC1/PC3、CP1 产物、压缩恢复与错路由复盘。
108109
- 当 `<工作区根>/.devcodex/layout.json` 启用 `workspace-namespace` 时,Profile 与运行态目录按**工作区集中命名空间**读取:
109110
- `config.json`:`<工作区根>/.devcodex/workspace/profile/` 作为 base,`<工作区根>/.devcodex/<project>/profile/` 作为 overlay
110111
- Profile 文档:项目命名空间文件优先,缺失回退到 `workspace/profile/`
@@ -132,6 +133,10 @@
132133

133134
所有 runtime 拦截都必须追加写入 `interceptions.jsonl`,记录 `eventName`、`platform`、`action`、`code`、`reason`、`nextStep`、`effective`。`effective=true` 表示宿主实际阻断;`effective=false` 表示本次仅提示/记录,AI 侧仍需按规范补完后续动作。非工具事件的 DevCodex 元数据只写审计日志,不写入不受宿主支持的 `hookSpecificOutput` 字段。
134135

136+
### ConfirmationRequest 与按钮降级
137+
138+
用户确认语义必须先表示为宿主无关的 `ConfirmationRequest`(`id/kind/severity/question/options/recommendedOption/evidence/fallbackText/auditLogRequired`),再由宿主适配层选择按钮、权限提示、Hook 阻断或文本 fallback。Claude Code SDK / VS Code Chat Extension 等明确支持结构化按钮时可使用按钮;Codex/Claude/Copilot Hooks 以阻断原因和下一步为主;Cursor/JetBrains/repository instructions 使用文本确认 fallback。禁止把按钮 UI 写成全宿主能力。
139+
135140
---
136141

137142
## ENV_MODE 行为总表
@@ -170,6 +175,7 @@ CP1(需求确认)→ CP2(方案确认)→ [plan-review] → CP3(实施
170175
- **CP2**:输出技术方案(架构/文件清单/依赖)→ 等待用户确认
171176
- **plan-review**:评估计划可行性(CP2 后、CP3 前)
172177
- **CP3**:条件触发。default/refactor/database/optimization/scenario-test 必须执行;docs/init/plan-review 按子类型规则豁免,并记录 `CP3: N/A(<子类型> 子类型豁免)`。
178+
- **ECR**:执行完成后、宣告完成前必须执行 ECR 执行闭环复审,覆盖 CP1/CP2/CP3、报告、daily tasks、SUMMARY、diff/commit、测试/探针与 dirty 边界。
173179

174180
> **无 Hooks 宿主软门禁**(v1.9.6+):当宿主为 `jetbrains-copilot`、`cursor` 或其他 `instruction-fallback` 模式时,`lifecycle.cjs` CP gate 不强制。AI 必须在每个 CP 输出末尾显式追加 `⏸ 等待用户确认(CP{N})`,收到明确回复前禁止 source mutation 工具调用。
175181
@@ -227,6 +233,7 @@ CP1(问题确认)→ CP2(方案确认)→ [impact-review] → 执行 →
227233
- **CP1**:输出问题分析(根因 + 影响范围)→ 等待确认
228234
- **CP2**:输出修复方案 → 等待确认
229235
- **CP3**:≥5 文件变更 或 含高风险操作时必须
236+
- **ECR**:执行完成并完成修复三步扫描后、宣告完成前必须执行 ECR 执行闭环复审,覆盖 CP1/CP2/CP3、报告、daily tasks、SUMMARY、diff/commit、测试/扫描证据与 dirty 边界。
230237

231238
### 确认后前置轻量复审
232239

@@ -247,6 +254,7 @@ CP1(问题确认)→ CP2(方案确认)→ [impact-review] → 执行 →
247254
- 只读工作流,禁止修改文件
248255
- 多轮收敛:至少 3 轮,连续 2 轮无新发现后收敛
249256
- 收敛前必须 CRS(关联文件全库 grep 核心关键词)
257+
- 多建议、多路径或技术选型时必须输出 `推荐结论` / `推荐方案` 与推荐理由;没有可推荐动作时写明 `推荐:无后续动作`。
250258

251259
---
252260

@@ -351,7 +359,7 @@ CP1(问题确认)→ CP2(方案确认)→ [impact-review] → 执行 →
351359
| FC4 | 输出语言正确 |
352360
| FC5 | 引用规范文件存在 |
353361
| FC6 | 合规块已输出 |
354-
| FC7 | 用户决策选项必带推荐 + 理由 |
362+
| FC7 | 用户决策选项与报告决策点必带推荐 + 理由 |
355363

356364
### SC 实质合规(选取适用项检查)
357365

@@ -371,7 +379,7 @@ CP1(问题确认)→ CP2(方案确认)→ [impact-review] → 执行 →
371379
| SC12 | 批量操作分批方案已确认(C16) |
372380
| SC13 | 过程改进 PI 已追加(C17) |
373381
| SC14 | 文件 UTF-8 编码安全(C09) |
374-
| SC15 | dev/fix 关键产物已完成轻量复审收敛 |
382+
| SC15 | dev/fix 关键产物已完成 ECR 执行闭环复审 |
375383

376384
### RC 恢复性检查
377385

@@ -392,7 +400,7 @@ CP1(问题确认)→ CP2(方案确认)→ [impact-review] → 执行 →
392400
| T4 | 关联文档已同步 |
393401
| T5 | 关联配置已更新 |
394402
| T6 | CHANGELOG / unreleased 已按发布状态追加(如属外部可见变更) |
395-
| T7 | 影响评估已记录(impact-review) |
403+
| T7 | 工作流验证已完成(dev/fix 含 ECR;audit/analyze 含 PCV 与推荐结论) |
396404
| T8 | 报告 V1~V6 验证通过 |
397405
| T9 | 记忆 + SUMMARY 写入完成 |
398406

‎instructions/01-common.instructions.md‎

Lines changed: 18 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -341,6 +341,24 @@ applyTo: "**"
341341
- 若扩展后发现初判意图不准确,应在 PC1 中表达为“语义初判 → 项目现实修正后的最终路由”,再进入对应工作流。
342342
- 若扩展不足以稳定判断,不得猜测;应在入口检查处提出最小澄清问题。
343343

344+
### Intent Expansion Card
345+
346+
非 chat 工作流在 CP1 / 问题确认前必须形成可审查的 Intent Expansion Card,作为 PC1/PC3、CP1 产物、压缩恢复与错路由复盘的共同锚点。
347+
348+
| 字段 | 说明 |
349+
|------|------|
350+
| `semantic` | 用户字面语义初判 |
351+
| `project` | 目标项目与 active-root |
352+
| `continuity` | 是否延续现有 requirement/bug/session |
353+
| `action` | 最终工作流与子类型 |
354+
| `domain` | 受影响模块/领域(如 hooks、memory、docs、mcp、runtime)|
355+
| `artifact-impact` | 影响源码、配置、规范、报告、记忆、部署体等哪类产物 |
356+
| `risk` | destructive / security / high-risk / normal |
357+
| `host-capability` | 是否涉及宿主能力差异及降级边界 |
358+
| `validation-route` | lint/test/typecheck/validate/direct replay/官方文档等验证路线 |
359+
| `confidence` | high / medium / low,并说明不确定点 |
360+
| `alternatives` | 被排除路线及原因 |
361+
344362
### Profile 标准文件
345363

346364
| 文件 | 说明 | 必须 |

0 commit comments

Comments
 (0)