Skip to content

Commit 2e99ff4

Browse files
committed
release: v1.11.7
1 parent d2370a3 commit 2e99ff4

42 files changed

Lines changed: 337 additions & 52 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
@@ -9,6 +9,7 @@
99

1010
| 版本 | 日期 | 变更摘要 | 详细 |
1111
|------|------|---------|------|
12+
| [v1.11.7](./changelogs/releases/v1.11.7.md) | 2026-06-01 | 🔧 **官方文档证据前置 + Profile 联动判定补强**:新增 `C20/C21`、`OfficialDocsEvidence` 与 `ProfileImpactCheck` 执行链,同步 dev/fix、plan-review、document-sync、Prompt、README/website 与 `V54` 探针,并补齐 CLI runtime helper 包边界 | [查看](./changelogs/releases/v1.11.7.md) |
1213
| [v1.11.6](./changelogs/releases/v1.11.6.md) | 2026-06-01 | 🔧 **治理台账长尾收口 + 发布/宿主/时间线守门补强**:收口 backlog governance、audit-release、ArtifactLinkSet、Codex PreCompact、S02 受控例外、changelog releases 与 Profile Freshness,并补齐 `V49` active-root 台账关闭时间线探针 | [查看](./changelogs/releases/v1.11.6.md) |
1314
| [v1.11.5](./changelogs/releases/v1.11.5.md) | 2026-05-29 | 🔧 **requirement 运行时产物结构探针 + 最近样本收口**:新增 `V41` 与 `test-requirement-artifacts`,把 `01/04/05` 的运行时最低结构纳入自动校验,并回补近期 requirement 样本的计划/进度漂移 | [查看](./changelogs/releases/v1.11.5.md) |
1415
| [v1.11.4](./changelogs/releases/v1.11.4.md) | 2026-05-29 | 🎯 **治理 Intake 全模式收口 + 本地 Profile overlay + README 专项治理**:将 Improvement Intake / 分流矩阵统一到所有模式,新增 `config.local.json` 受控 overlay、`V39/V40` 与 targeted tests,并补 `readme-authoring` / `audit-readme` / README 专项 review | [查看](./changelogs/releases/v1.11.4.md) |
@@ -92,9 +93,10 @@
9293

9394
## 相关文档
9495

95-
- [`changelogs/releases/v1.11.6.md`](./changelogs/releases/v1.11.6.md) — 最新版本详细变更文档
96-
- [`changelogs/releases/v1.11.4.md`](./changelogs/releases/v1.11.4.md) — 上一个版本详细变更文档
97-
- [`changelogs/releases/v1.11.3.md`](./changelogs/releases/v1.11.3.md) — 历史版本详细变更文档
96+
- [`changelogs/releases/v1.11.7.md`](./changelogs/releases/v1.11.7.md) — 最新版本详细变更文档
97+
- [`changelogs/releases/v1.11.6.md`](./changelogs/releases/v1.11.6.md) — 上一个版本详细变更文档
98+
- [`changelogs/releases/v1.11.5.md`](./changelogs/releases/v1.11.5.md) — 历史版本详细变更文档
99+
- [`changelogs/releases/v1.11.4.md`](./changelogs/releases/v1.11.4.md) — 历史版本详细变更文档
98100
- [`changelogs/releases/v1.11.1.md`](./changelogs/releases/v1.11.1.md) — 上一个版本详细变更文档
99101
- [`changelogs/releases/v1.11.0.md`](./changelogs/releases/v1.11.0.md) — 历史版本详细变更文档
100102
- [`changelogs/releases/v1.10.0.md`](./changelogs/releases/v1.10.0.md) — 历史版本详细变更文档

‎README.md‎

Lines changed: 4 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -47,6 +47,8 @@ DevCodex 通过 `.github/`(Copilot)、`CLAUDE.md + .claude/ + .mcp.json`(C
4747
- **Profile 新鲜度审查**: audit 会先执行 `Profile Freshness Check`,反向核对 Profile 是否仍匹配当前包版本、目录资产、脚本、发布状态、宿主能力和任务现实
4848
- **规范治理 Intake**: 所有模式下每条用户消息在合理性评估后都会额外检查是否命中可泛化改进;命中时主动写入 `data/process-improvements.md`(优化清单,PI),必要时联动 `data/pending-fixes.md`(PF),并显式回执 `PI/PF`
4949
- **Backlog 真相复核与状态回写**: 从 `data/*.md` open/partial 项组织新需求或新批次前,先按 `pure-open / residual-tail / already-fixed / misclassified` 分类;实施后再执行台账状态回写闭环,避免“源码已修但 backlog 仍旧 open”
50+
- **官方文档证据前置**: 新增或升级依赖、框架、SDK、平台 API、外部模块前,CP2 会要求 `OfficialDocsEvidence`,记录官方文档来源、关键用法、限制与兼容性,避免凭经验猜 API
51+
- **ProfileImpactCheck**: dev/fix 改动项目技术栈、目录、脚本、测试/发布路线、分发面、配置或长期连接时,会主动判定是否需要更新 Profile;无需更新时也要写明跳过理由
5052
- **Profile 本地私有配置**: `config.local.json` 支持长期连接、env 引用和 `extensions.<namespace>` 受控扩展位;文件应加入 `.gitignore`,且不能覆盖 `mode` / `agent`;核心秘密只允许 `*Env` / `secretRef`
5153
- **变更日志分层**: 未发布实现变更写 `changelogs/unreleased.md`,已发布详情统一归档到 `changelogs/releases/vX.Y.Z.md`,目录说明见 `changelogs/README.md`
5254
- **执行闭环复审**: dev/fix 完成前执行 ECR 执行闭环复审,交叉验证 CP 产物、报告、daily memory、SUMMARY、diff/commit、测试/探针与 dirty 边界
@@ -175,7 +177,8 @@ AGENTS.md ← 与 instructions.md / copilot-instructions.md / CL
175177
- **高联动默认联查**:当任务涉及控制面规则、模板、接口契约/验证产物、工作区真相源/部署副本或发布口径变更时,会默认联查相关文件;若同时命中多真相源同步或模板-示例-校验链,会升级为交叉验证或 `CRS`。
176178
- **Backlog Intake 真相复核**:若本轮需求、bug 或批次直接来源于 `data/*.md` 的 open/partial 项,会先核对源码、最新报告、测试和台账,把候选项分为 `pure-open / residual-tail / already-fixed / misclassified`,再决定是否继续纳入本轮。
177179
- **台账状态回写闭环**:当实施或复审改变了 VL / PF / PI / ISSUE / GAP 的真实状态时,会在完成前回写状态、验证证据、验证时间与关闭/部分完成说明,并再核对 open 计数、进度、报告和 SUMMARY 是否一致。
178-
- **官方资料优先**:涉及平台能力、框架 API、版本兼容性或工具语义判断时,优先读取官方文档,再降级到其他资料。
180+
- **官方资料优先**:涉及平台能力、框架 API、版本兼容性或工具语义判断时,优先读取官方文档,再降级到其他资料;新增/升级依赖、框架、SDK、平台 API 或外部模块时必须形成 `OfficialDocsEvidence`。
181+
- **ProfileImpactCheck**:项目事实变化后,DevCodex 会检查是否需要同步 Profile 的技术栈、目录边界、脚本/测试/发布路线、配置说明或当前阶段;若不更新,需要在报告中写明 `skipReason`。
179182
- **提交标题收短**:用户要求提交时,DevCodex 会优先生成一句简洁的 commit subject,而不是把整段会话摘要塞进标题。
180183

181184

‎RULES.md‎

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

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

‎changelogs/releases/v1.11.7.md‎

Lines changed: 41 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,41 @@
1+
# v1.11.7 — 官方文档证据与 Profile 联动规范补强
2+
3+
> 发布日期:2026-06-01
4+
5+
## Highlights
6+
7+
- 新增 `C20/C21`,把“引入依赖/框架/SDK/API 前必须读取官方文档”和“项目事实变化后必须联动 Profile”提升为强制约束。
8+
- 建立 `OfficialDocsEvidence` 执行链,要求 CP2 / 技术方案记录官方来源、版本或日期、关键用法、限制、兼容性与降级依据。
9+
- 建立 `ProfileImpactCheck` 执行链,要求 dev/fix 在技术栈、目录边界、脚本、测试/发布路线、配置或本地 overlay schema 变化时主动同步 Profile 或写明 `skipReason`。
10+
- 新增 `V54` 与 targeted governance probes,覆盖 instructions、skills、prompts、README、website、changelog 与测试消费者,防止规则新增后消费者漂移。
11+
- 发布前安装烟测发现并修复 CLI 包边界:补齐 `scripts/lib/cli-host-utils.js`、`scripts/lib/cli-runtime-utils.js`、`scripts/lib/profile-bootstrap-utils.js`,避免 pack 后运行 `devcodex status` 缺少 runtime helper。
12+
13+
## Changed
14+
15+
- `instructions.md`、`instructions/01-common.instructions.md`、`instructions/01b-record-router.instructions.md`、`instructions/10-dev.instructions.md`、`instructions/11-fix.instructions.md` 同步官方文档证据与 Profile 联动规则。
16+
- `skills/dev-plan-review`、`skills/document-sync`、`skills/test-router`、`skills/report` 增加 `OfficialDocsEvidence` / `ProfileImpactCheck` 守门与报告要求。
17+
- `prompts/technical-design`、`implementation-plan`、`implementation-progress`、`delivery-checklist`、`report-dev`、`report-fix` 增加对应证据字段。
18+
- README 与 website 开发指南同步用户可见说明,明确何时需要官方证据、何时需要 Profile 联动。
19+
20+
## Added
21+
22+
- `scripts/lib/validate-governance-tail.js` 新增 `checkV54`。
23+
- `scripts/test-spec-governance.js` 新增官方文档证据与 Profile 联动消费者探针。
24+
- `scripts/test-pack-clean.js` 会从 `index.js` 反向收集本地 runtime require,防止 CLI 运行时依赖漏发。
25+
- `scripts/validate-versions.js` 增加 `RULES.md` 与 `instructions/**/*.md` frontmatter 版本一致性检查。
26+
27+
## Validation
28+
29+
- `node scripts/validate-versions.js`
30+
- `node scripts/validate.js`
31+
- `node scripts/test-spec-governance.js`
32+
- `npm test`
33+
- `npm run test:audit`
34+
- `npm pack --dry-run`
35+
- `npm publish --dry-run --access restricted`
36+
- `git diff --check`
37+
- `node .\devcodex-v1\index.js update`
38+
39+
## Included Changes
40+
41+
- 2026-06-01 `官方文档与 Profile 联动规范补强`:收口用户提出的“引入模块/框架必须先读官方文档”和“项目调整后 Profile 联动”两项规范缺口,关闭 `PI-016`、`PI-017`、`PF-017`、`PF-018`。

‎instructions.md‎

Lines changed: 28 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -45,7 +45,7 @@ S02 的核心秘密禁止项不可豁免;“私有仓库”“本地使用”
4545

4646
---
4747

48-
## 强制约束(C01~C19)
48+
## 强制约束(C01~C21)
4949

5050
| # | 约束 | 规则 |
5151
|:-:|------|------|
@@ -68,6 +68,8 @@ S02 的核心秘密禁止项不可豁免;“私有仓库”“本地使用”
6868
| C17 | 过程改进记录 | 用户建议的策略经确认更优,或揭示规范未定义/不完整且可泛化时,必须走 Improvement Intake:将策略写入 `data/process-improvements.md`(优化清单,PI);若同时暴露规范缺口,再联动 `data/pending-fixes.md`(PF)。不得询问是否记录;所有模式命中后都必须显式回执已记录的 `PI-xxx / PF-xxx` |
6969
| C18 | 全模式入口检查不可跳过 | 同 S07 |
7070
| C19 | 确认后前置复审 | 每次用户明确确认后、进入下一阶段前,必须先对当前已确认产物做 1 轮轻量前置复审,并显式输出结果;控制面 / 多文件联动 / 真相源同步 / 模板-示例-校验链场景必须追加交叉验证;若发现阻断性问题,先修正并告知用户,再重新确认;无阻断问题方可推进 |
71+
| C20 | 官方文档证据前置 | 新增/升级第三方依赖、框架、SDK、平台 API 或外部模块前,必须先读取官方使用文档/官方参考资料并形成 `OfficialDocsEvidence`;缺失证据时不得进入编码 |
72+
| C21 | Profile 联动判定 | dev/fix 修改项目技术栈、目录边界、脚本、测试/发布路线、分发面、配置项、长期连接或本地 overlay schema 时,必须执行 `ProfileImpactCheck`:更新 Profile 或写明跳过理由 |
7173

7274
---
7375

@@ -209,6 +211,29 @@ S02 的核心秘密禁止项不可豁免;“私有仓库”“本地使用”
209211
- 非 `pure-open` 项不得原样沿用旧 open 统计;必须先回写台账、修正本轮范围和 CP1/CP2/CP3 口径,再继续推进。
210212
- 用户面至少要显式说明:候选编号、复核分类、是否缩减本轮范围。
211213

214+
### OfficialDocsEvidence(官方文档证据)
215+
216+
- 新增/升级第三方依赖、引入框架、SDK、平台 API、外部模块或需要依据外部平台能力设计方案时,CP2 前必须读取官方使用文档或官方参考资料。
217+
- CP2 / 技术方案必须记录 `OfficialDocsEvidence`:官方文档来源、版本或发布日期、关键用法、限制条件、兼容性 / 弃用 / Breaking Change 判断,以及本方案采用的具体 API / 配置依据。
218+
- 若官方文档不可用,按顺序降级到官方源码 / 官方仓库说明、项目内已确认文档、社区资料;降级原因和风险必须写入方案与报告。
219+
- 本地纯实现问题、仓库内现有能力可闭环验证且不新增/升级外部依赖的任务,可标 `OfficialDocsEvidence: N/A`,但必须写明 N/A 理由。
220+
- `dev-plan-review` 的 PR-2 必须检查该证据;触发场景缺失 `OfficialDocsEvidence` 时视为阻断,回 CP2 修订。
221+
222+
### ProfileImpactCheck(Profile 联动判定)
223+
224+
dev/fix 修改完成前必须判定是否影响 Profile。命中以下任一触发项时,必须更新对应 Profile 文件,或在 CP2 / CP3 / ECR / 报告中写明跳过理由:
225+
226+
| 触发项 | Profile 同步目标 |
227+
|--------|------------------|
228+
| 技术栈、框架、SDK、依赖管理器变化 | `01-项目信息.md` 技术栈 / 依赖说明 |
229+
| 目录结构、模块边界、分发面、宿主能力变化 | `02-架构约束.md` 目录与边界 |
230+
| 代码风格、脚本、测试、构建、发布命令变化 | `03-代码风格.md` 或 `01-项目信息.md` 验证路线 |
231+
| 共享配置、环境变量、本地长期连接、`config.local.json` schema 或 `extensions.<namespace>` 变化 | Profile README / `01-项目信息.md` / `config.local.json` 说明 |
232+
| 当前阶段、活跃版本、任务现实、发布状态变化 | `01-项目信息.md` 当前开发重点 |
233+
234+
- `document-sync` 必须把 `ProfileImpactCheck` 作为 dev/fix 后置检查项,不得只依赖 audit 的 Profile Freshness 事后发现。
235+
- 若判断无需更新 Profile,必须留下 `skipReason`,例如“仅修正文案 typo,不影响技术栈/目录/配置/验证路线”。
236+
212237
### 台账落点与关闭证据
213238

214239
- `data/*.md` 是运行时逻辑台账路径,实际写入必须按当前 active-root 映射:旧布局写 `<项目根>/.devcodex/data/`,workspace-namespace 单项目写 `<工作区根>/.devcodex/<project>/data/`,全工作区写 `<工作区根>/.devcodex/workspace/data/`。
@@ -265,7 +290,7 @@ CP1(需求确认)→ CP2(方案确认)→ [plan-review] → CP3(实施
265290
```
266291

267292
- **CP1**:输出完整需求理解(目标/边界/风险)→ 等待用户确认
268-
- **CP2**:输出技术方案(架构/文件清单/依赖)→ 等待用户确认
293+
- **CP2**:输出技术方案(架构/文件清单/依赖);新增/升级依赖、框架、SDK 或平台 API 时必须附 `OfficialDocsEvidence`,涉及项目事实变化时必须附 `ProfileImpactCheck` → 等待用户确认
269294
- **plan-review**:评估计划可行性(CP2 后、CP3 前)
270295
- **CP3**:条件触发。default/refactor/database/optimization/scenario-test 必须执行;docs/init/plan-review 按子类型规则豁免,并记录 `CP3: N/A(<子类型> 子类型豁免)`。
271296
- 若执行过程中新增范围触发 CP3 条件(例如最初判断 <5 文件但实际扩展到 ≥5 文件,或新增高风险操作/控制面联动),必须暂停执行,回补或重开 CP3 后再继续。
@@ -325,7 +350,7 @@ CP1(问题确认)→ CP2(方案确认)→ [impact-review] → 执行 →
325350
```
326351

327352
- **CP1**:输出问题分析(根因 + 影响范围)→ 等待确认
328-
- **CP2**:输出修复方案 → 等待确认
353+
- **CP2**:输出修复方案;若修复涉及依赖/框架/SDK/平台 API 变更必须附 `OfficialDocsEvidence`,涉及项目事实变化时必须附 `ProfileImpactCheck` → 等待确认
329354
- **CP3**:≥5 文件变更 或 含高风险操作时必须
330355
- 若执行过程中新增范围触发 CP3 条件(例如实际修改文件数扩展到 ≥5,或修复途中引入高风险/控制面联动),必须暂停执行,先补做 CP3,再继续修复。
331356
- **ECR**:执行完成并完成修复三步扫描后、宣告完成前必须执行 ECR 执行闭环复审,覆盖 CP1/CP2/CP3、报告、daily tasks、SUMMARY、diff/commit、测试/扫描证据与 dirty 边界。

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

0 commit comments

Comments
 (0)