Skip to content

Commit 8c41888

Browse files
committed
release: v1.11.15
1 parent 3db8a95 commit 8c41888

40 files changed

Lines changed: 234 additions & 77 deletions

‎CHANGELOG.md‎

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

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

88
## 版本概览
99

1010
| 版本 | 日期 | 变更摘要 | 详细 |
1111
|------|------|---------|------|
12+
| [v1.11.15](./changelogs/releases/v1.11.15.md) | 2026-06-09 | 🔧 **问答证据门禁、复杂度用户面与产物生命周期收口**:新增 `QuestionEvidenceGate / ComparativeResearchGate`,将 CP1 复杂度主口径升级为 `ImplementationComplexityLevel` 三档,并补齐 `ArtifactDecisionMatrix / ArtifactLifecycleState`、模板漂移探针与 V8 source-root 部署副本检查 | [查看](./changelogs/releases/v1.11.15.md) |
1213
| [v1.11.14](./changelogs/releases/v1.11.14.md) | 2026-06-05 | 🔧 **ExistingRequirementArtifactOverride 与需求回写收口**:修复 `SimpleTaskFastPath` 对既有需求/bug 真相源的过宽豁免,明确调整需求必须先回写已有文件,回复只做摘要;`v1.11.14` 替代未 registry 发布的 `v1.11.13` | [查看](./changelogs/releases/v1.11.14.md) |
1314
| [v1.11.13](./changelogs/releases/v1.11.13.md) | 2026-06-04 | 🔧 **默认简单实现档位与 Profile Auto 别名**:CP1 新增 `ImplementationComplexityPreference` 且默认 `simple`,Auto v1.1 支持 Profile `extensions.devcodex.autoAliases`(本项目 `@rocky`),并补齐 runtime / profile schema / V13-V14 探针 | [查看](./changelogs/releases/v1.11.13.md) |
1415
| [v1.11.12](./changelogs/releases/v1.11.12.md) | 2026-06-04 | 🔧 **平台工程守门、轻路径与复审覆盖收口**:新增平台工程前置、SimpleTaskFastPath、ContextHandoffCard、ReviewCoverageDelta、发布包边界串行与消费者依赖树优先探针,并补强发布型 Profile 与 V56/V57 校验 | [查看](./changelogs/releases/v1.11.12.md) |
@@ -100,8 +101,9 @@
100101

101102
## 相关文档
102103

103-
- [`changelogs/releases/v1.11.14.md`](./changelogs/releases/v1.11.14.md) — 最新版本详细变更文档
104-
- [`changelogs/releases/v1.11.13.md`](./changelogs/releases/v1.11.13.md) — 上一版本详细变更文档
104+
- [`changelogs/releases/v1.11.15.md`](./changelogs/releases/v1.11.15.md) — 最新版本详细变更文档
105+
- [`changelogs/releases/v1.11.14.md`](./changelogs/releases/v1.11.14.md) — 上一版本详细变更文档
106+
- [`changelogs/releases/v1.11.13.md`](./changelogs/releases/v1.11.13.md) — 历史版本详细变更文档
105107
- [`changelogs/releases/v1.11.12.md`](./changelogs/releases/v1.11.12.md) — 历史版本详细变更文档
106108
- [`changelogs/releases/v1.11.11.md`](./changelogs/releases/v1.11.11.md) — 历史版本详细变更文档
107109
- [`changelogs/releases/v1.11.10.md`](./changelogs/releases/v1.11.10.md) — 历史版本详细变更文档

‎README.md‎

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -49,14 +49,15 @@ DevCodex 通过 `.github/`(Copilot)、`CLAUDE.md + .claude/ + .mcp.json`(C
4949
- **规范治理 Intake**: 所有模式下每条用户消息在合理性评估后都会额外检查是否命中可泛化改进;命中时主动写入 `data/process-improvements.md`(优化清单,PI),必要时联动 `data/pending-fixes.md`(PF),并显式回执 `PI/PF`
5050
- **Backlog 真相复核与状态回写**: 从 `data/*.md` open/partial 项组织新需求或新批次前,先按 `pure-open / residual-tail / already-fixed / misclassified` 分类;实施后再执行台账状态回写闭环,避免“源码已修但 backlog 仍旧 open”
5151
- **官方文档证据前置**: 新增或升级依赖、框架、SDK、平台 API、外部模块前,CP2 会要求 `OfficialDocsEvidence`,记录官方文档来源、关键用法、限制与兼容性,避免凭经验猜 API
52-
- **通用工程守门**: Node.js 项目默认不低于 `>=18`;需求/问题定义前置平台工程判断,并记录 `ImplementationComplexityPreference`,用户未要求复杂化时默认 `simple`;依赖/兼容任务拆分业务源码平滑性与依赖层落地条件;包/库/adapter/CLI 同查代码层与包工程层;JS/Node 必要注释使用标准 JSDoc;简单 service 不重复 route/model/schema 已承担的校验
52+
- **通用工程守门**: Node.js 项目默认不低于 `>=18`;需求/问题定义前置平台工程判断,并记录 `ImplementationComplexityLevel`,开发程度分为 `简单够用 / 中等 / 企业级`,用户未要求复杂化或需求不详细时默认 `简单够用`;依赖/兼容任务拆分业务源码平滑性与依赖层落地条件;包/库/adapter/CLI 同查代码层与包工程层;JS/Node 必要注释使用标准 JSDoc;简单 service 不重复 route/model/schema 已承担的校验
5353
- **验证卫生与包边界**: release / pack / benchmark / codegen 任务中,package boundary check 必须在构建完成后单独串行执行;消费者验证异常先查 package.json、lockfile、node_modules 与 `npm ls <关键依赖>`,收尾前清理无关 dirty 文件和验证残留
5454
- **ProfileImpactCheck**: dev/fix 改动项目技术栈、目录、脚本、测试/发布路线、分发面、配置或长期连接时,会主动判定是否需要更新 Profile;无需更新时也要写明跳过理由
5555
- **敏感信息与硬编码策略**: 默认允许敏感信息、明文连接信息和硬编码出现在用户要求的代码、脚本、配置、文档、测试或报告中;只有用户 / 项目明确禁止时才脱敏、占位或改用 env、`secretRef`、secret manager、`config.local.json`
5656
- **AI 自启动服务清理**: AI 为验证启动 dev server、文档站、本地 API/mock、数据库代理、SSH 隧道、Playwright/Cypress server 或压测 target 后,验证完成、失败或最终回复前会主动关闭仅由 AI 本轮启动的服务并核验端口释放;用户要求保留时会记录 PID/端口和关闭方式
5757
- **变更日志分层**: 未发布实现变更写 `changelogs/unreleased.md`,已发布详情统一归档到 `changelogs/releases/vX.Y.Z.md`,目录说明见 `changelogs/README.md`
5858
- **执行闭环复审**: dev/fix 完成前执行 ECR 执行闭环复审,交叉验证 CP 产物、报告、daily memory、SUMMARY、diff/commit、测试/探针与 dirty 边界
5959
- **推荐结论**: analyze/audit/report 多建议或多路径场景必须给出推荐结论与推荐理由;无后续动作时明确写“推荐:无后续动作”
60+
- **对比调研门禁**: 用户问“是否应该 / 哪个更好 / 有没有更好建议 / 推荐什么”且结论会影响时间、金钱、架构、产品/项目路线或长期维护成本时,先执行 `QuestionEvidenceGate`;必要时比较同类产品 / 项目 / 本仓库相似模块,普通低风险问答可标 `ComparativeResearchGate: N/A + skipReason`
6061
- **确认交互降级**: 用户确认先抽象为 ConfirmationRequest,再按宿主能力选择按钮、权限提示、Hook 阻断或文本确认 fallback,不把按钮 UI 承诺为全宿主能力
6162
- **执行护栏**: 新需求切换时优先按意图判断边界;涉及外部平台/API/兼容性判断时优先看官方文档;提交时压缩 commit subject
6263

‎RULES.md‎

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

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

‎changelogs/releases/v1.11.15.md‎

Lines changed: 35 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,35 @@
1+
# v1.11.15 — 问答证据门禁、复杂度用户面与产物生命周期收口
2+
3+
> 发布日期:2026-06-09
4+
5+
## 变更摘要
6+
7+
- 新增 `QuestionEvidenceGate / ComparativeResearchGate`:推荐、选型、同类产品/项目判断和高影响建议必须先说明证据范围;纯解释、低风险本地事实或用户明确要求快速答复时可标 `N/A + skipReason`。
8+
- 将 CP1 复杂度主口径升级为 `ImplementationComplexityLevel`,用户面使用 `简单够用 / 中等 / 企业级` 三档;需求不详细时默认 `简单够用`,更复杂方案只能作为可选项展示。
9+
- 新增并同步 `ArtifactDecisionMatrix / ArtifactLifecycleState`,统一需求、技术方案、实施计划、进度、目标文档、报告与记忆的 `create / update / skip / N/A` 判定优先级。
10+
- 修正模板漂移:`technical-design.prompt.md`、`implementation-plan.prompt.md`、`implementation-progress.prompt.md` 等模板不再表达“始终创建技术方案/实施计划”的过宽要求。
11+
- 扩展 V8 部署同步探针:从父级部署体扩展到源仓根被 `.gitignore` 忽略的本地 `AGENTS.md`、`CLAUDE.md`、`.github`、`.claude`、`.agents`、`.codex` 副本,避免本地宿主入口残留旧规范。
12+
13+
## Fixed
14+
15+
- 修复“简单任务轻路径”与“已有真相源回写”之后,模板层仍可能诱导始终创建或禁止跳过产物的问题。
16+
- 修复推荐类问答缺少证据深度声明,导致普通解释和高影响选型容易混用同一回答策略的问题。
17+
- 修复 V41 / `test-spec-governance` 对 `ArtifactDecisionMatrix` 正向探针和旧口径负向探针覆盖不足的问题。
18+
19+
## Release Gate Evidence
20+
21+
- `OfficialDocsEvidence`: N/A。本轮不新增/升级第三方依赖、框架、SDK 或外部平台 API。
22+
- `ProfileImpactCheck`: updated。active Profile 当前版本与当前阶段更新到 v1.11.15,并记录 v1.11.15 commit/tag/push 验收结论。
23+
- `ConceptSyncMap`: sourceOfTruth 为 `instructions.md` / `instructions/01-common.instructions.md` / `instructions/10-dev.instructions.md` / `instructions/11-fix.instructions.md` / `instructions/13-analyze.instructions.md`;currentConsumers 已同步 README、website、split instructions、prompts、skills 与 validate probes;historicalMirrors 为 `website/docs/versions/` 历史归档,不回写。
24+
- `ReleaseRecovery`: 不重写远端 `v1.11.14` tag;v1.11.15 作为新 patch 发版,registry/tag 以 v1.11.15 验收。
25+
26+
## Validation
27+
28+
- `node scripts/validate-versions.js`
29+
- `node scripts/test-spec-governance.js`
30+
- `node scripts/validate.js`
31+
- `npm test`
32+
- `npm run test:audit`
33+
- `git diff --check`
34+
- `npm pack --dry-run`
35+
- remote main/tag verification

‎changelogs/unreleased.md‎

Lines changed: 2 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -6,11 +6,9 @@
66
77
---
88

9-
## 2026-06-05
9+
## 当前状态
1010

11-
- 修复产物生命周期口径:新增 `ArtifactDecisionMatrix / ArtifactLifecycleState`,统一 `01-需求概述.md`、`02-技术方案.md`、`04-实施计划.md`、`05-实施进度.md`、目标文档、报告和记忆的 `create / update / skip / N/A` 判定,优先级为“已有真相源回写 > 任务触发条件 > SimpleTaskFastPath > 子类型豁免”。
12-
- 修正模板漂移:`technical-design.prompt.md` 仅在 `02-技术方案.md` 被判定需要创建/更新时使用;`implementation-plan.prompt.md` 不再要求 `04-实施计划.md` 始终创建;`implementation-progress.prompt.md` 支持 docs/init 等 CP3 豁免场景使用等价任务切片或 `ContextHandoffCard` 作为进度锚点。
13-
- 补充验证守门:`V41` 与 `test-spec-governance` 增加 `ArtifactDecisionMatrix` 正向探针和旧口径负向探针,防止“始终创建实施计划 / 技术方案禁止跳过”类表述回流。
11+
- 暂无未发布变更。
1412

1513
## 记录提示
1614

‎instructions.md‎

Lines changed: 10 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -226,6 +226,13 @@ S02 不再把“敏感信息、明文密码、连接字符串或硬编码”定
226226
- 依赖升级、框架升级、SDK 替换或平台 API 兼容性分析必须拆分 `业务源码平滑性` 与 `依赖层落地条件`;用户关心“只升级依赖即可”时,追加 `纯依赖层零附加动作` 结论,不得把工程前提误报成业务源码阻断。
227227
- 根因位于内部共享库、中间件、SDK 或 adapter 抽象层时,CP2 前必须评估“修共享库 + 消费项目升级”是否优于单项目临时补丁。
228228

229+
### QuestionEvidenceGate(问答证据深度与对比调研门禁)
230+
231+
- 当用户询问“是否应该”“哪个更好”“有没有更好建议”“推荐方案/工具/产品/架构/技术选型”,或 AI 的回答会影响用户投入明显时间、金钱、迁移成本、公共契约、长期维护成本时,必须先执行 `QuestionEvidenceGate`,选择合适证据深度后再给推荐。
232+
- `ComparativeResearchGate` 只在推荐、选型、产品/项目路线、架构/技术方案、外部平台能力、同类产品或同类项目判断中触发:先比较同类产品 / 项目 / 本仓库相似模块 / 已有设计,再输出推荐结论;若信息可能近期变化,按外部资料时效规则检索当前资料。
233+
- 纯定义解释、语法说明、低风险本地事实核验、用户明确要求快速答复且不涉及高影响决策,或仓库事实已足以闭环的问题,可写 `ComparativeResearchGate: N/A + skipReason`,不得把普通问答默认升级成重调研。
234+
- 输出推荐时必须说明证据范围:`repo-local`(同仓库相似实现)、`same-type-project`(同类项目/产品对比)、`official/current-docs`(官方或当前资料)、或 `N/A + skipReason`。证据不足时只能给条件结论,不得伪装成已充分调研。
235+
229236
### ProfileImpactCheck(Profile 联动判定)
230237

231238
dev/fix 修改完成前必须判定是否影响 Profile。命中以下任一触发项时,必须更新对应 Profile 文件,或在 CP2 / CP3 / ECR / 报告中写明跳过理由:
@@ -304,7 +311,7 @@ SCV 结果必须写入报告;控制面任务的 ECR-7 必须引用 SCV 证据
304311
CP1(需求确认)→ CP2(方案确认)→ [plan-review] → CP3(实施确认)→ 执行
305312
```
306313

307-
- **CP1**:输出完整需求理解(目标/边界/风险)与 `ImplementationComplexityPreference`(默认 `simple`)→ 等待用户确认
314+
- **CP1**:输出完整需求理解(目标/边界/风险)与 `ImplementationComplexityLevel`(开发程度等级,默认 `简单够用`;兼容旧字段 `ImplementationComplexityPreference`)→ 等待用户确认
308315
- **CP2**:输出技术方案(架构/文件清单/依赖);新增/升级依赖、框架、SDK 或平台 API 时必须附 `OfficialDocsEvidence`,涉及项目事实变化时必须附 `ProfileImpactCheck` → 等待用户确认
309316
- **plan-review**:评估计划可行性(CP2 后、CP3 前)
310317
- **CP3**:条件触发。default/refactor/database/optimization/scenario-test 必须执行;docs/init/plan-review 按子类型规则豁免,并记录 `CP3: N/A(<子类型> 子类型豁免)`。
@@ -321,8 +328,8 @@ CP1(需求确认)→ CP2(方案确认)→ [plan-review] → CP3(实施
321328
### 代码实现复杂度与通用工程守门
322329

323330
- CP1 需求/问题定义必须前置平台工程判断:谁会复用、哪一层值得抽象、哪一层应保持局部、长期维护成本和明确非目标;不得把“通用性/模块化”写成无消费者的空心抽象。
324-
- CP1 必须给出 `ImplementationComplexityPreference`:`simple`(默认,满足验收项的局部最小实现)、`balanced`(存在明确复用/演进边界但不做通用平台化)、`robust`(用户明确要求或已有公共契约/多消费者/高风险长期演进)。用户未提出复杂化、需求未说明或任务可用简单方案满足验收时,默认选择 `simple`;若 AI 判断需要 `balanced/robust`,必须列出 2~3 个方案、维护成本和取舍,等待用户确认后再升级。
325-
- CP2 技术方案必须继承 CP1 的 `ImplementationComplexityPreference` 并给出最小实现与注释策略;实施默认采用满足验收项的最小实现,优先局部补丁和既有本地模式。
331+
- CP1 必须给出 `ImplementationComplexityLevel`(兼容旧字段名 `ImplementationComplexityPreference`),并用用户能理解的三档表达:`简单够用`(默认,需求不详细或简单方案可满足验收时只做局部最小实现)、`中等`(存在明确复用者、演进边界或跨模块协作,但不做平台化 / 企业级预设)、`企业级`(仅用户明确选择,或已有公共契约、多消费者、高风险长期演进且经用户确认)。用户未提出复杂化、需求未说明或任务可用简单方案满足验收时,必须默认选择 `简单够用`;AI 可以展示 `中等` / `企业级` 可选方案、开发周期 / 难度 / 维护成本和取舍,但不得默认按企业级脑补实现。
332+
- CP2 技术方案必须继承 CP1 的 `ImplementationComplexityLevel` 并给出最小实现与注释策略;实施默认采用满足验收项的最小实现,优先局部补丁和既有本地模式。
326333
- 禁止为“企业级”“可扩展”预设新增无真实消费者的 service / factory / adapter / manager、策略注册表、通用配置或预留扩展点。
327334
- 必要注释必须覆盖非显然业务规则、状态转换、不变量、兼容约束、安全边界、外部契约映射和反直觉权衡;JavaScript / Node.js 中命中必要注释的导出函数、核心业务函数、类、复杂对象契约、参数/返回/异常说明必须使用标准 JSDoc。
328335
- Node.js 项目的 `engines.node`、CI matrix、Profile 与 README 运行时说明默认不得低于 `>=18`;支持更低版本时必须在 CP2 写明业务理由、风险和独立验证证据。

‎instructions/00-safety.instructions.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
applyTo: "**"
33
description: 安全底线与输出语言规则,定义 S01~S07、违规处理与不可豁免边界
44
priority: P2
5-
version: 1.11.14
5+
version: 1.11.15
66
---
77
# 安全底线规范(S01~S07)
88

‎instructions/01-common.instructions.md‎

Lines changed: 8 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
applyTo: "**"
33
description: 通用规范总则,覆盖优先级、意图路由、Profile/active-root、宿主适配与治理总线
44
priority: P5
5-
version: 1.11.14
5+
version: 1.11.15
66
---
77
# 通用规范
88

@@ -76,6 +76,13 @@ version: 1.11.14
7676
| C21 | Profile 联动判定 | dev/fix 项目事实变化后必须执行 `ProfileImpactCheck`:更新 Profile 或写明跳过理由 |
7777
| C22 | AI 自启动服务清理(ServiceLifecycleCleanup) | AI 为验证启动 dev server、文档站、本地 API/mock、数据库代理、SSH 隧道、Playwright/Cypress server、压测 target 等长运行进程时,必须记录启动命令、cwd、PID/job、端口/URL;验证完成、失败或中断收尾前主动停止仅由 AI 启动的服务并核验端口释放;不得杀用户既有进程;用户明确要求保留时记录保留原因、PID/端口和关闭方式 |
7878

79+
### QuestionEvidenceGate(问答证据深度与对比调研门禁)
80+
81+
- 当用户询问“是否应该”“哪个更好”“有没有更好建议”“推荐方案/工具/产品/架构/技术选型”,或 AI 的回答会影响用户投入明显时间、金钱、迁移成本、公共契约、长期维护成本时,必须先执行 `QuestionEvidenceGate`,选择合适证据深度后再给推荐。
82+
- `ComparativeResearchGate` 只在推荐、选型、产品/项目路线、架构/技术方案、外部平台能力、同类产品或同类项目判断中触发:先比较同类产品 / 项目 / 本仓库相似模块 / 已有设计,再输出推荐结论;若信息可能近期变化,按外部资料时效规则检索当前资料。
83+
- 纯定义解释、语法说明、低风险本地事实核验、用户明确要求快速答复且不涉及高影响决策,或仓库事实已足以闭环的问题,可写 `ComparativeResearchGate: N/A + skipReason`,不得把普通问答默认升级成重调研。
84+
- 输出推荐时必须说明证据范围:`repo-local`(同仓库相似实现)、`same-type-project`(同类项目/产品对比)、`official/current-docs`(官方或当前资料)、或 `N/A + skipReason`。证据不足时只能给条件结论,不得伪装成已充分调研。
85+
7986
## 统一联查矩阵(C11 扩展)
8087

8188
> 目的:把“相关文件一起检查”从分散规则收口成统一入口。C11 仍是总约束;本节定义“默认联查什么、何时升级强度”。

‎instructions/01a-profile-loading.instructions.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
applyTo: "**"
33
description: Profile 加载、active-root 路径、目标项目识别与项目现实扩展的通用规范
44
priority: P5
5-
version: 1.11.14
5+
version: 1.11.15
66
---
77
# Profile 加载与项目现实扩展
88

‎instructions/01b-record-router.instructions.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
applyTo: "**"
33
description: 任务切换边界、RecordRouter 分流、Improvement Intake 与提交发布边界的通用规范
44
priority: P5
5-
version: 1.11.14
5+
version: 1.11.15
66
---
77
# 任务边界与 RecordRouter
88

0 commit comments

Comments
 (0)