Skip to content

Commit 1fc7e8a

Browse files
committed
release: v1.11.21
1 parent ed1d712 commit 1fc7e8a

49 files changed

Lines changed: 390 additions & 577 deletions

Some content is hidden

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

‎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-12
4+
> **最后更新**: 2026-06-17
55
66
---
77

88
## 版本概览
99

1010
| 版本 | 日期 | 变更摘要 | 详细 |
1111
|------|------|---------|------|
12+
| [v1.11.21](./changelogs/releases/v1.11.21.md) | 2026-06-17 | 🔧 **审查发现 intake 分流门禁**:新增 `ReviewFindingIntakeGate` / `DesignIntentAndDocsConsistencyGate` 与 V64 探针,要求外部审查报告、AI review finding、audit issue 和代码评审发现先经本地证据、设计取舍、用户决策、文档漂移与测试缺口分流 | [查看](./changelogs/releases/v1.11.21.md) |
1213
| [v1.11.20](./changelogs/releases/v1.11.20.md) | 2026-06-12 | 🔧 **最新 data 吸纳守门补强**:新增全工作区 data 扫描、流程图节点说明、文档站视觉验收、遗漏专审、方法级泄漏压测与 v2 正式方案包守门,并补齐 V63 探针 | [查看](./changelogs/releases/v1.11.20.md) |
1314
| [v1.11.19](./changelogs/releases/v1.11.19.md) | 2026-06-12 | 🔧 **剩余 data 吸纳守门扩展与 v2 MCP-first 路线纠偏**:新增产品原文追溯、本机可执行配置、人工复核数据留存、相邻范围扩大、包名权限、性能 benchmark-first、公开模块差异化与 V2 MCP-first 规划守门,并补齐 V62 探针 | [查看](./changelogs/releases/v1.11.19.md) |
1415
| [v1.11.18](./changelogs/releases/v1.11.18.md) | 2026-06-11 | 🔧 **前端体验质量门禁与跨项目吸纳守门收口**:新增 `FrontendExperienceQualityGate`、UI/UX 体验门禁、8 项 `CrossProjectLearnedGuards`,并同步 dev/fix/audit/test Skill、CP/报告模板、README、website、活动版本 P1 需求页与 V61 探针 | [查看](./changelogs/releases/v1.11.18.md) |
@@ -106,8 +107,9 @@
106107

107108
## 相关文档
108109

109-
- [`changelogs/releases/v1.11.20.md`](./changelogs/releases/v1.11.20.md) — 最新版本详细变更文档
110-
- [`changelogs/releases/v1.11.18.md`](./changelogs/releases/v1.11.18.md) — 上一版本详细变更文档
110+
- [`changelogs/releases/v1.11.21.md`](./changelogs/releases/v1.11.21.md) — 最新版本详细变更文档
111+
- [`changelogs/releases/v1.11.20.md`](./changelogs/releases/v1.11.20.md) — 上一版本详细变更文档
112+
- [`changelogs/releases/v1.11.18.md`](./changelogs/releases/v1.11.18.md) — 历史版本详细变更文档
111113
- [`changelogs/releases/v1.11.17.md`](./changelogs/releases/v1.11.17.md) — 历史版本详细变更文档
112114
- [`changelogs/releases/v1.11.15.md`](./changelogs/releases/v1.11.15.md) — 历史版本详细变更文档
113115
- [`changelogs/releases/v1.11.13.md`](./changelogs/releases/v1.11.13.md) — 历史版本详细变更文档

‎README.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -54,7 +54,7 @@ DevCodex 通过 `.github/`(Copilot)、`CLAUDE.md + .claude/ + .mcp.json`(C
5454
- **Backlog 真相复核与状态回写**: 从 `data/*.md` open/partial 项组织新需求或新批次前,先按 `pure-open / residual-tail / already-fixed / misclassified` 分类;实施后再执行台账状态回写闭环,避免“源码已修但 backlog 仍旧 open”
5555
- **官方文档证据前置**: 新增或升级依赖、框架、SDK、平台 API、外部模块前,CP2 会要求 `OfficialDocsEvidence`,记录官方文档来源、关键用法、限制与兼容性,避免凭经验猜 API
5656
- **通用工程守门**: Node.js 项目默认不低于 `>=18`;需求/问题定义前置平台工程判断,并记录 `ImplementationComplexityLevel`,开发程度分为 `简单够用 / 中等 / 企业级`,用户未要求复杂化或需求不详细时默认 `简单够用`;依赖/兼容任务拆分业务源码平滑性与依赖层落地条件;包/库/adapter/CLI 同查代码层与包工程层;JS/Node 必要注释使用标准 JSDoc;简单 service 不重复 route/model/schema 已承担的校验
57-
- **跨项目经验吸纳守门**: 字段/本地化/状态新增前执行 `ExistingDomainContractAudit`,业务策略常量执行 `ConfigOwnershipMatrix`,接口文档合同执行 `ApiDocVerificationSync`,数据迁移执行 `DataMutationPlan`,值得吸纳建议执行 `AbsorptionDecision`,完整首版执行 `FullV1ScopeGuard`,启动优化执行 `StartupPhaseTrace`;新增吸纳 `CodeTruthRequirementGate`、`ManualReviewEvidenceRetention`、`DocumentationTranslationParityGuard`、`FormalDocsDevCodexBoundary`、`LLMPromptContractTriage`、`VerificationScopeBudgetGate`、`LiveVerificationExecutionObligation`、`AdapterBenchmarkAttribution`、`ProductRequirementTraceabilityGate`、`LocalExecutionConfigProbe`、`ManualReviewEvidenceDataRetention`、`AdjacentScopeExpansionGuard`、`PackageNameAuthorityGate`、`PerformanceBenchmarkFirstGate`、`PublicModuleDifferentiationGate`、`V2MCPFirstPlanningGate`、`WorkspaceDataAbsorptionScopeGate`、`FlowchartNodeExplanationGate`、`DocsSiteVisualAcceptanceGate`、`OmissionOnlyReviewGate`、`MethodLevelLeakPressureProbe` 与 `V2FormalSolutionPackage`
57+
- **跨项目经验吸纳守门**: 字段/本地化/状态新增前执行 `ExistingDomainContractAudit`,业务策略常量执行 `ConfigOwnershipMatrix`,接口文档合同执行 `ApiDocVerificationSync`,数据迁移执行 `DataMutationPlan`,值得吸纳建议执行 `AbsorptionDecision`,完整首版执行 `FullV1ScopeGuard`,启动优化执行 `StartupPhaseTrace`;新增吸纳 `CodeTruthRequirementGate`、`ManualReviewEvidenceRetention`、`DocumentationTranslationParityGuard`、`FormalDocsDevCodexBoundary`、`LLMPromptContractTriage`、`VerificationScopeBudgetGate`、`LiveVerificationExecutionObligation`、`AdapterBenchmarkAttribution`、`ProductRequirementTraceabilityGate`、`LocalExecutionConfigProbe`、`ManualReviewEvidenceDataRetention`、`AdjacentScopeExpansionGuard`、`PackageNameAuthorityGate`、`PerformanceBenchmarkFirstGate`、`PublicModuleDifferentiationGate`、`V2MCPFirstPlanningGate`、`WorkspaceDataAbsorptionScopeGate`、`FlowchartNodeExplanationGate`、`DocsSiteVisualAcceptanceGate`、`OmissionOnlyReviewGate`、`ReviewFindingIntakeGate`、`MethodLevelLeakPressureProbe` 与 `V2FormalSolutionPackage`
5858
- **验证卫生与包边界**: release / pack / benchmark / codegen 任务中,package boundary check 必须在构建完成后单独串行执行;消费者验证异常先查 package.json、lockfile、node_modules 与 `npm ls <关键依赖>`,收尾前清理无关 dirty 文件和验证残留
5959
- **ProfileImpactCheck**: dev/fix 改动项目技术栈、目录、脚本、测试/发布路线、分发面、配置或长期连接时,会主动判定是否需要更新 Profile;无需更新时也要写明跳过理由
6060
- **敏感信息与硬编码策略**: 默认允许敏感信息、明文连接信息和硬编码出现在用户要求的代码、脚本、配置、文档、测试或报告中;只有用户 / 项目明确禁止时才脱敏、占位或改用 env、`secretRef`、secret manager、`config.local.json`

‎RULES.md‎

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

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

‎changelogs/releases/v1.11.21.md‎

Lines changed: 42 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,42 @@
1+
# v1.11.21 — 审查发现 intake 分流门禁
2+
3+
> 发布日期:2026-06-17
4+
> 变更类型:规范治理 / 审查分流 / 测试门禁
5+
> 风险级别:P1
6+
> 向后兼容:✅ 兼容
7+
8+
## 变更摘要
9+
10+
本版本吸纳 `PF-054 / PI-051`,新增 `ReviewFindingIntakeGate` / `DesignIntentAndDocsConsistencyGate`,把外部审查报告、AI review finding、audit issue 和代码评审发现进入 analyze/audit/fix 前的分流流程固化为可执行门禁,并补齐 V64 探针。
11+
12+
## Added
13+
14+
- 新增 `ReviewFindingIntakeGate`:审查发现进入修复前必须先分类为 `must-fix`、`user-decision-required`、`docs-implementation-drift`、`test-coverage-gap`、`already-fixed-or-not-reproduced` 或 `intentional-design-accepted`。
15+
- 新增 `DesignIntentAndDocsConsistencyGate`:对兼容设计、产品取舍、文档/实现漂移和测试覆盖缺口做明确归因,避免把“需用户决策”或“只需补测试/文档”的事项误修成 runtime bug。
16+
- 新增 5 个子探针:`AuditReportIsSignalNotEvidence`、`IntentionalDesignClassification`、`UserDecisionBeforeMutation`、`DocsImplementationDriftAttribution`、`TestCoverageGapOnly`。
17+
- 新增 `V64` validate 探针和 `test-spec-governance` 覆盖。
18+
19+
## Changed
20+
21+
- 同步 `instructions.md`、dev/fix/audit/analyze instructions、audit/analyze/fix/dev/report/test/document-sync Skill、CP/report prompts、README、website guide、活动版本 changelog 与 Profile。
22+
- 同步工作区 `.github/`、`.claude/`、`AGENTS.md`、`.agents/` 与 `.codex/` 部署副本。
23+
- `PF-054` 已关闭,`PI-051` 已标记已吸纳。
24+
- 发布前审计修复 website 锁文件:`@rspress/core` 更新到 2.0.14,`dompurify` 更新到 3.4.10,`npm --prefix website audit --omit=dev` 归零。
25+
26+
## 验证
27+
28+
```bash
29+
node scripts/validate.js
30+
node scripts/test-spec-governance.js
31+
npm test
32+
npm run test:audit
33+
node .\devcodex-v1\index.js update
34+
git diff --check
35+
```
36+
37+
全部通过。
38+
39+
## 相关资源
40+
41+
- `website/docs/versions/v1/1.0.1/requirements/p1/latest-data-absorption-guards/`
42+
- `.devcodex/devcodex-v1/reports/self-fix/codex/20260617/01--审查发现intake门禁吸纳实施与复审.md`

‎instructions.md‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -290,6 +290,7 @@ dev/fix 修改完成前必须判定是否影响 Profile。命中以下任一触
290290
- `LLMPromptContractTriage`:变更 prompt、Agent 指令、Hook 输出、MCP 工具描述或面向 LLM 的契约时,必须区分人读说明、模型指令、结构化输出字段和宿主能力边界;字段级契约、示例、失败降级和验证探针需同步。
291291
- `VerificationScopeBudgetGate`:验证路线必须与风险和变更面匹配;高风险、控制面、发布、资源生命周期或前端体验不能只跑轻量检查,低风险纯文档/纯计算也不得为形式引入重压测、E2E 或外部依赖。
292292
- `LiveVerificationExecutionObligation`:声明“已验证 / 可运行 / 可点击 / 已发布 / 已安装”前必须真实执行对应命令、页面、接口、pack/install、registry/tag 查询或项目等价验证;无法执行时只能写阻塞/降级证据,不能用预期代替结果。
293+
- `ReviewFindingIntakeGate` / `DesignIntentAndDocsConsistencyGate`:外部审查报告、AI review finding、audit issue 或代码评审发现进入 analyze/audit/fix 处理前,必须先按 5 个子探针分流:`AuditReportIsSignalNotEvidence`(报告只是线索,需本地代码/文档/测试/运行证据,无法复现标 `not-reproduced` 或 `needs-evidence`)、`IntentionalDesignClassification`(识别 intentional design、兼容设计、性能取舍或产品策略并记录依据)、`UserDecisionBeforeMutation`(公共契约、兼容风险、设计取舍或文档/实现二选一时,修改源码前先用户确认)、`DocsImplementationDriftAttribution`(文档与实现不一致时先判断文档是否代表产品目标或历史承诺,再决定修代码/文档/示例/测试)、`TestCoverageGapOnly`(仅测试浅、回归缺失或证据不足时优先补测试/复现/验证证据,不直接改 runtime)。该门禁是审查发现 intake 场景的组合门禁,不作为 5 个独立顶层守门。
293294
- `AdapterBenchmarkAttribution`:adapter、provider、connector、SDK 或性能优化 benchmark 必须写清基线、环境、版本、负载、归因边界和不可比较因素;不得把框架、网络、缓存预热、依赖树或测试环境差异误归因给业务代码。
294295
- `ProductRequirementTraceabilityGate`:从 PRD、Word、原型、截图、会议纪要或用户补充消息整理需求时,必须保留需求来源、条款/页码/截图/消息锚点、结构化提取口径和遗漏/冲突处理;不得把 AI 归纳当成唯一真相源。
295296
- `LocalExecutionConfigProbe`:脚本、本机验证、数据库/SSH/HTTP 连接或跨环境执行需要本地配置时,必须先核对项目指定配置入口、Profile `config.local.json` 模型或既有脚本约定;未指定时按 S02 默认可直写/沿用现状,禁止臆造 env/secret/config.local 层。

‎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.20
5+
version: 1.11.21
66
---
77
# 安全底线规范(S01~S07)
88

‎instructions/01-common.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.20
5+
version: 1.11.21
66
---
77
# 通用规范
88

‎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.20
5+
version: 1.11.21
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.20
5+
version: 1.11.21
66
---
77
# 任务边界与 RecordRouter
88

‎instructions/01c-intent-expansion.instructions.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
applyTo: "**"
33
description: 意图识别、Intent Expansion Card、上下文重建与可见回复证据的通用规范
44
priority: P5
5-
version: 1.11.20
5+
version: 1.11.21
66
---
77
# 意图扩展与上下文重建
88

0 commit comments

Comments
 (0)