Skip to content

Commit a453c2a

Browse files
committed
release: v1.11.31
1 parent 334dffa commit a453c2a

55 files changed

Lines changed: 883 additions & 53 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: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,14 +1,15 @@
11
# 变更日志 (CHANGELOG)
22

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

88
## 版本概览
99

1010
| 版本 | 日期 | 变更摘要 | 详细 |
1111
|------|------|---------|------|
12+
| [v1.11.31](./changelogs/releases/v1.11.31.md) | 2026-07-09 | 🔧 **最新吸纳执行包与 Profile 三档闭环**:归档 A1~A10 `LatestAbsorptionExecutionPack`、新增 V82/V83,固化配置 canonical namespace、Profile runtime contract、文档/示例真相、派生消费者、功能清单证据矩阵、多批次状态进度、Profile 三档标准与全 `.devcodex` 校验 | [查看](./changelogs/releases/v1.11.31.md) |
1213
| [v1.11.30](./changelogs/releases/v1.11.30.md) | 2026-07-08 | 🔧 **用户侧文档 review 与规范吸纳执行入口收口**:新增 `audit-user-manual` 与 `spec-absorption`,固化用户侧文档、项目文档、菜单导航、sidebar、信息架构审查聚合,以及 `.devcodex/*/data` 候选通用性证明、消费者证明和项目独有规则剔除;新增 V80/V81 探针 | [查看](./changelogs/releases/v1.11.30.md) |
1314
| [v1.11.29](./changelogs/releases/v1.11.29.md) | 2026-07-08 | 🔧 **coverage 与外部 runtime 生命周期验证收口**:新增 V79,固化 `CoverageGateDecision`、`ExternalRuntimePluginLifecycleGate`、`ExternalRegistryLifecycleMatrixGate`、`FunctionSourceFingerprintMatrixGate`、`ClusterEscalationGate` 与 `RiskBasedValidationLadder` | [查看](./changelogs/releases/v1.11.29.md) |
1415
| [v1.11.28](./changelogs/releases/v1.11.28.md) | 2026-07-08 | 🔧 **分析默认 Skill、复审收敛与发布退出码门禁收口**:归档 V75~V78,新增 `analyze-default`、`SpecRadarSubgate` / `GovernanceGateRegistry`、`PromptLongGateListDriftProbe`、`ReviewEscapeRecordGate`、`NativeCommandExitCodeGate`、`PostConfirmationReviewScopeGate`、`DevelopmentDriftGate` 与文档 IA / 中文主表达探针 | [查看](./changelogs/releases/v1.11.28.md) |

‎README.md‎

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -49,13 +49,15 @@ DevCodex 通过 `.github/`(Copilot)、`CLAUDE.md + .claude/ + .mcp.json`(C
4949
- **实施偏移与文档 IA 守门**: `DevelopmentDriftGate` 在编码前和实施中核对 `allowedFirstBatch / blockedScope / driftTriggers / validationRoute`;`VerificationPlanMaterializationProbe` 要求技术方案物化验证计划、验收标准和退出条件;`ChinesePrimaryExpressionGate`、`SidebarPageRoleMaterializationProbe` 与 `SidebarGroupSemanticModelProbe` 要求用户文档中文主表达、页面角色和 sidebar 分组语义可验证
5050
- **自我进化治理能力**: `evolution-governance` 负责自我进化、自动吸纳、模型辅助规范优化、自动补 Skill / Prompt / Probe 和自动治理候选的控制面,执行 `EvolutionCapabilityControlPlaneGate`,冻结授权、模型配置、租户 / 权限、配额、数据边界、审计、回滚和发布审批;模型输出只能进入候选态,不能直接写 active 规范或发版
5151
- **Profile 新鲜度审查**: audit 会先执行 `Profile Freshness Check`,反向核对 Profile 是否仍匹配当前包版本、目录资产、脚本、发布状态、宿主能力和任务现实
52+
- **Profile 三档闭环校验**: Profile 按 `profile-lite` / `profile-standard` / `profile-closed-loop` 三档维护,执行 `ProfileTierStandardGate` 与 `ProfileLifecycleClassificationGate` 区分稳定基线、活文档和条件 / 本地文档;规范维护、SDK/CLI、文档站、public API 或用户要求全工作区校验时执行 `AllDevCodexProfileValidationGate`,通过 `node scripts/validate-all-profiles.js --workspace <workspace-root>` 扫描 `.devcodex/workspace/profile` 与 `.devcodex/<project>/profile`
5253
- **项目工程泄漏审查**: 项目工程 / 代码质量审查执行 `PE-12 资源生命周期与泄漏风险`,必须检查内存泄露、资源泄漏、监听器/定时器/连接/流未释放、缓存无界增长和组件卸载清理缺失
5354
- **泄漏风险稳定性压测**: 写测试用例或回归验证时先执行 `LeakRiskStabilityPressureTest` 条件判定;命中长运行、高并发、缓存/连接/监听器/定时器/流/socket/worker/订阅/组件生命周期或 `PE-12` 风险时,TestRoute 纳入场景/负载/稳定性压测并记录基线、冷却后回落和资源指标前后对比;低风险任务写 `N/A + skipReason`
5455
- **coverage 与外部 runtime 生命周期验证**: 项目存在 coverage 阈值、CI coverage 或发布覆盖率要求时执行 `CoverageGateDecision`,区分断言通过与覆盖率门禁通过;外部 runtime/plugin/registry/adapter/provider、injected runtime、owner mutation 或 function source fingerprint 风险执行 `ExternalRuntimePluginLifecycleGate`、`ExternalRegistryLifecycleMatrixGate`、`FunctionSourceFingerprintMatrixGate`、`ClusterEscalationGate` 与 `RiskBasedValidationLadder`
5556
- **前端体验质量门禁**: 前端页面、组件、控制台、官网、文档站、可视化工具或游戏任务执行 `FrontendExperienceQualityGate` 条件判定,覆盖设计来源、UI 还原度、风格主题、响应式状态、视觉验证、用户流、交互反馈、输入方式/可访问性、错误恢复和动效转场;Figma/截图/既有页面还原追加 `FigmaHighFidelityRestorationGate`、`ScopedVisualChangeGate`、`InstalledPluginVisualVerificationGate`、`ActualPreviewChainAndMockFallbackGate`、`FrontendRuntimeNetworkProbeGate`、`UIStateScopeRegressionGate`、`FigmaProductionAssetBudgetGate`、`RuntimeI18nArtifactVerificationGate`、`VisualDeviationTypeGate` 与 `DesignFramePurposeClassificationGate`;浏览器验证先执行 `FrontendBrowserVerificationBudgetGate`,用户明确自验或禁止浏览器/截图时执行 `UserSelfVerificationOverrideGate`;命中时 TestRoute 纳入 Browser/截图、Playwright/E2E、console/network/resource/runtime、代码级替代验证或人工复核证据
5657
- **复审覆盖增量与维度增量**: audit / review / ECR 的连续零发现必须附 `ReviewCoverageDelta`(覆盖面增量)与 `ReviewDimensionDeltaGate`(维度焦点增量),优先阅读此前未审查但相关联的代码、配置、测试、文档、部署副本和消费者链,并避免每轮机械重复同一组维度;无新增覆盖、无新增维度焦点且无证据化理由时,不计入有效零发现
5758
- **规范治理 Intake**: 所有模式下每条用户消息在合理性评估后都会额外检查是否命中可泛化改进;命中时主动写入 `data/process-improvements.md`(优化清单,PI),必要时联动 `data/pending-fixes.md`(PF),并显式回执 `PI/PF`
5859
- **规范吸纳执行能力**: `spec-absorption` 负责最新可吸纳、仍需吸纳和 `.devcodex/*/data` 候选扫描,先执行 `CommonNormGeneralizationGate` 与 `AbsorptionCandidateConsumerProofGate`,证明通用规范价值、剔除项目独有残留、绑定 DevCodex 当前消费者和 targetOwner,再进入分层实现与验证;`ServiceSpecReadGate` 等项目私有规则只作负向样例,不吸纳为通用规范
60+
- **最新吸纳执行包 A1~A10**: 最新可吸纳清单确认实施时,`LatestAbsorptionExecutionPack` 按 `GovernanceGateRegistry` 分组同步配置 canonical namespace、Profile/runtime contract、行为语义与负向翻译、示例与 callback 真相面、派生消费者与失败注入、FeatureInventoryProfileGate / FeatureChecklistEvidenceMatrixGate、BatchEvidenceLedgerStateGate / BatchProgressCardGate,并用 V82 探针核对 Skill、Prompt、TestRoute、report、README/website/changelog、Profile、部署副本和来源台账回写
5961
- **分层吸纳架构(兼容 Skill-first 吸纳架构)**: 规范吸纳、data 台账治理、用户确认可泛化建议或新增门禁时,先执行 `LayeredAbsorptionGate`,并兼容 `SkillFirstAbsorptionGate` / `CapabilityToSkillPromotionGate`;输出 `LayeredAbsorptionDecision`(含 `SkillAbsorptionDecision`),逐层覆盖通用指令、Skill、prompts/templates、执行消费者、validate/test 探针、README/website/changelog 和部署副本。采纳用户建议前同步执行 `ProactiveBetterAlternativeGate`,有更优方案必须先提出取舍;采纳用户纠正时执行 `AcceptedSuggestionRootCauseGate`,报告 whyMissed、采纳依据、台账编号和防复发动作
6062
- **历史通用规范分层迁移**: 迁移此前已堆入通用 instructions、prompt、report 模板或 README 的规范时执行 `HistoricalCommonNormLayeringGate`,先冻结逐文件审查矩阵,再按 `targetLayer / targetOwner / semanticStrength / validation / skipReason` 下沉到 Skill、Prompt、执行消费者、V74/V75 validate 探针、公开文档和部署副本;`PromptLongGateListDriftProbe` 会用 SCV 负向样例防止旧 Gate 长清单回流,当前 README、website 和 prompts 只写 `GovernanceGateRegistry` 分组与代表锚点;无法立即下沉的旧规则只保留为 `legacy-index-retained`,不再作为新增长清单容器
6163
- **完整吸纳补强门禁**: 用户确认“未完整吸纳 / 半覆盖 / 仍需吸纳”时执行 `ConfirmedAbsorptionCompletenessGates`,按 `public-surface / user-manual / review-checklist / frontend-runtime / profile-service / release-parity / evolution-control-plane` 分组补齐 Skill、Prompt、执行消费者、探针、公开文档和部署副本;代表锚点包括 `PublicSurfaceClosureGate`、`UserManualProductizationGate`、`ReviewAnchorMaterializationGate`、`FrontendAsyncCacheRenderGate`、`RemoteCIParityPushGate`、`NativeCommandExitCodeGate` 与 `DocsThemeRuntimeVisualProbeGate`
@@ -396,6 +398,7 @@ DevCodex Hook runtime 不再把所有拦截都等同为“停止”。拦截会
396398
2. **Profile 没加载或 workspace-namespace 路径不对**
397399
- 先运行 `devcodex doctor`
398400
- 再用 `devcodex help` 查看 `profile init` 和 `migrate-layout` 子命令,核对 `.devcodex/workspace/profile/` 与项目命名空间路径
401+
- 维护 DevCodex 源仓或 workspace-namespace 时,运行 `node scripts/validate-all-profiles.js --workspace <workspace-root>` 校验所有 Profile;发布前需要严格处理 warning 时追加 `--strict-warnings`
399402
3. **Codex / Copilot 想用 MCP**
400403
- 先确认宿主本身是否支持本地 MCP
401404
- DevCodex 当前只会自动写 Claude Code 的 `.mcp.json`;Codex / Copilot 需要手工配置

‎RULES.md‎

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

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

‎changelogs/releases/v1.11.31.md‎

Lines changed: 57 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,57 @@
1+
# v1.11.31 最新吸纳执行包与 Profile 三档闭环
2+
3+
## 版本信息
4+
5+
| 项目 | 内容 |
6+
|------|------|
7+
| 版本号 | v1.11.31 |
8+
| 发布日期 | 2026-07-09 |
9+
| 变更类型 | 规范增强 / Profile 治理 / 治理探针 |
10+
| 风险级别 | P2 (Low) |
11+
| 向后兼容 | ✅ 兼容 |
12+
13+
## 变更摘要
14+
15+
本版本收口两批治理能力:A1~A10 `LatestAbsorptionExecutionPack` 将最新可吸纳项按分层吸纳架构落到 Skill、Prompt、执行消费者、探针、公开文档与部署副本;Profile 三档闭环将项目 Profile 标准拆为 `profile-lite`、`profile-standard`、`profile-closed-loop`,并新增全 `.devcodex` Profile 校验脚本。
16+
17+
## 新增能力
18+
19+
- 新增 A1~A10 `LatestAbsorptionExecutionPack`,覆盖配置 canonical namespace、Profile runtime contract、行为语义与负向翻译、示例真相面、callback 示例范围、派生消费者、失败注入、功能清单证据矩阵和多批次进度状态。
20+
- 新增 V82 探针,反查 A1~A10 是否同步到 Skill、Prompt、TestRoute、report、README、website、changelog、Profile、部署副本和来源台账回写。
21+
- 新增 `ProfileTierStandardGate`、`ProfileLifecycleClassificationGate` 与 `AllDevCodexProfileValidationGate`,明确 `conditional-required` 是文件级触发规则,不是项目档位。
22+
- 新增 `scripts/validate-all-profiles.js`,用于扫描 `.devcodex/workspace/profile` 与 `.devcodex/<project>/profile`,汇总 error / warning 并支持 strict warning 模式。
23+
- `devcodex-v1` active Profile 升级为 `profile-closed-loop` 示例,补齐 `06-功能清单.md` 与 `07-用户文档与契约规范.md`。
24+
25+
## Skill 与执行链调整
26+
27+
- `load-profile` 与 `profile-bootstrap` 同步三档 Profile 标准、文件生命周期和全项目 Profile 校验触发条件。
28+
- `test-router` 与 `report` 同步 `ProfileTierValidation / AllDevCodexProfileValidation` 证据要求。
29+
- `spec-absorption`、`spec-governance`、文档审查、测试、复审清单和用户文档相关 Skill 同步 A1~A10 执行包的 gate 分组与报告字段。
30+
- `prompts/technical-design.prompt.md`、`implementation-plan.prompt.md`、`implementation-progress.prompt.md` 与 report prompts 同步最新吸纳执行包和验证证据口径。
31+
32+
## 公开文档与 Profile
33+
34+
- README 新增 Profile 三档闭环校验说明和 `validate-all-profiles` 命令。
35+
- website development guide 同步 Profile 三档标准与全工作区校验说明。
36+
- `changelogs/unreleased.md` 增加 Profile 三档与全项目校验的发布前提示,归档后重置为空未发布池。
37+
- active Profile 的当前焦点、功能清单、用户文档与契约规范已同步到最新发布口径。
38+
39+
## 兼容性
40+
41+
- 不改变 CLI 命令、Hook 入口、包公开 API、安装方式或既有 Skill 触发语义。
42+
- 历史项目 Profile 未声明档位时默认按 `profile-lite` 兼容处理,并输出 warning;默认全项目校验不因历史 warning 阻断。
43+
- `--strict-warnings` 可用于后续治理批次,把历史 warning 升级为失败信号。
44+
45+
## 验证摘要
46+
47+
- `node scripts/test-validate-profile.js`
48+
- `node scripts/validate-all-profiles.js --workspace E:\Worker`
49+
- `node scripts/test-spec-governance.js`
50+
- `node scripts/validate.js` V1~V83
51+
- `npm test`
52+
- `npm run test:audit`
53+
- `npm pack --dry-run`
54+
- `npm publish --dry-run --registry=https://npm.pkg.github.com`
55+
- pack install smoke
56+
57+
> 完整发布验证证据见本版本发布报告。

‎changelogs/unreleased.md‎

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -29,5 +29,7 @@
2929
- coverage 与外部 runtime 生命周期类变更需显式标明 `CoverageGateDecision`、`ExternalRuntimePluginLifecycleGate`、`ExternalRegistryLifecycleMatrixGate`、`FunctionSourceFingerprintMatrixGate`、`ClusterEscalationGate`、`RiskBasedValidationLadder` 和 V79 探针,避免测试断言通过、happy path 或单例函数对象被误当成完整验证。
3030
- 用户侧文档 review 聚合入口变更需显式标明 `audit-user-manual`、`UserManualReviewScope`、`DocsNavigationReviewMatrix`、`SidebarPageRoleMaterializationProbe`、`GeneratedSiteGate`、`DocsThemeRuntimeVisualProbeGate` 和 V80 探针,避免只补写作 Skill 而遗漏项目文档、菜单导航、生成站点和报告证据。
3131
- 规范吸纳执行入口变更需显式标明 `spec-absorption`、`CommonNormGeneralizationGate`、`AbsorptionCandidateConsumerProofGate`、`project-local`、`case-evidence-only`、`targetOwner` 和 V81 探针,避免把项目独有规则误吸纳为通用规范。
32+
- A1~A10 最新吸纳执行包需显式标明 `LatestAbsorptionExecutionPack`、`ConfigCanonicalNamespaceGate`、`ProfileRuntimeContractSyncGate`、`BehaviorSemanticDocsParityGate`、`NegativeTranslationParityProbe`、`DocsExampleTruthSurfaceGate`、`CallbackExampleScopeProbe`、`DerivedMetricConsumerProbe`、`DerivedConsumerFailureInjectionProbe`、`FeatureInventoryProfileGate`、`FeatureChecklistEvidenceMatrixGate`、`BatchEvidenceLedgerStateGate`、`BatchProgressCardGate` 和 V82 探针,避免名称只停留在扫描报告或候选表。
33+
- Profile 三档与全项目校验变更需显式标明 `ProfileTierStandardGate`、`ProfileLifecycleClassificationGate`、`AllDevCodexProfileValidationGate`、`profile-lite`、`profile-standard`、`profile-closed-loop`、`validate-all-profiles` 和 V83 探针,避免只更新单项目 Profile 而遗漏 `.devcodex` 下其他项目。
3234
- 宿主输出、Hook 或项目现实扩展相关条目,建议显式写出 `verified-present / verified-missing / unverified`、sticky `activeProject` 与用户可见 `意图扩展摘要` 是否发生变化。
3335
- 执行闭环、确认机制或发布门禁相关条目,建议补充 `Intent Expansion Card`、`ConfirmationRequest`、`ECR` 与验证证据,方便正式发版时直接归档到版本 changelog。

‎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.30
5+
version: 1.11.31
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.30
5+
version: 1.11.31
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.30
5+
version: 1.11.31
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.30
5+
version: 1.11.31
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.30
5+
version: 1.11.31
66
---
77
# 意图扩展与上下文重建
88

0 commit comments

Comments
 (0)