Skip to content

Commit 334dffa

Browse files
committed
release: v1.11.30
1 parent 197b67f commit 334dffa

52 files changed

Lines changed: 657 additions & 93 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: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -9,6 +9,7 @@
99

1010
| 版本 | 日期 | 变更摘要 | 详细 |
1111
|------|------|---------|------|
12+
| [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) |
1213
| [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) |
1314
| [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) |
1415
| [v1.11.27](./changelogs/releases/v1.11.27.md) | 2026-07-07 | 🔧 **分层吸纳架构与历史通用规范迁移收口**:归档 V71~V74,新增 Skill-first / 分层吸纳架构、最终用户文档与复审清单独立 Skill、自我进化治理 Skill、完整吸纳补强、历史通用规范逐文件矩阵迁移和 V74 探针 | [查看](./changelogs/releases/v1.11.27.md) |

‎README.md‎

Lines changed: 6 additions & 5 deletions
Large diffs are not rendered by default.

‎RULES.md‎

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

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

‎changelogs/releases/v1.11.30.md‎

Lines changed: 51 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,51 @@
1+
# v1.11.30 用户侧文档 review 与规范吸纳执行入口收口
2+
3+
## 版本信息
4+
5+
| 项目 | 内容 |
6+
|------|------|
7+
| 版本号 | v1.11.30 |
8+
| 发布日期 | 2026-07-08 |
9+
| 变更类型 | 规范增强 / Skill 聚合 / 治理探针 |
10+
| 风险级别 | P2 (Low) |
11+
| 向后兼容 | ✅ 兼容 |
12+
13+
## 变更摘要
14+
15+
本版本同时收口两条治理执行入口:新增 `audit-user-manual` Skill,将用户侧文档审查从分散规则收口为独立聚合入口;新增 `spec-absorption` Skill,将规范吸纳执行面从 `spec-governance` 中拆出,要求最新可吸纳 / 仍需吸纳 / `.devcodex/*/data` 候选先证明通用规范价值、剔除项目独有残留并绑定 DevCodex 当前消费者。
16+
17+
## 新增能力
18+
19+
- 新增 `audit-user-manual`,作为用户侧文档 review、项目文档审查、菜单导航、sidebar 和信息架构审查的薄封装入口。
20+
- 新增 `UserManualReviewScope` 与 `DocsNavigationReviewMatrix` 输出证据,要求审查先冻结目标文档、受众、真相源、发布边界、页面角色、route、label 与 sidebar group。
21+
- 将 `SidebarPageRoleMaterializationProbe`、`SidebarGroupSemanticModelProbe`、`GeneratedSiteGate` 与 `DocsThemeRuntimeVisualProbeGate` 接入用户侧文档审查聚合路径。
22+
- 新增 `spec-absorption`,作为规范吸纳执行入口,覆盖 `.devcodex/*/data` 候选扫描、通用性证明、消费者证明、项目独有规则剔除、分层决策、消费者同步和验证回写。
23+
- 新增 `CommonNormGeneralizationGate` 与 `AbsorptionCandidateConsumerProofGate`,要求 `ServiceSpecReadGate`、`docs/services/<name>`、单项目 route/model/schema 命名等项目私有规则只作为负向样例或 case evidence,不进入 DevCodex 通用规范。
24+
25+
## Skill 与执行链调整
26+
27+
- `routing`、`dev-docs`、`audit-document`、`audit-readme`、`user-manual-authoring`、`audit-execution-guide`、`document-sync`、`test-router` 与 `report` 已同步 `audit-user-manual` 入口。
28+
- dev/fix/audit 报告模板补充 `audit-user-manual / UserManualReviewScope / DocsNavigationReviewMatrix` 证据字段。
29+
- `routing`、`spec-governance`、`test-router`、`report`、`document-sync`、`source-consumer-sync` 与 technical-design / implementation-plan / report prompts 已同步 `spec-absorption` 执行链。
30+
- README、website、Profile 与 `plugin.json` 同步 Skill 数量为 50,并显式说明用户侧文档 review 聚合入口与规范吸纳执行入口。
31+
- `instructions.md`、`instructions/01-common.instructions.md` 与 `instructions/12-audit.instructions.md` 同步审查路由:用户侧文档 / 文档站 / 项目文档 review 叠加 `audit-user-manual`,README / 主入口文档再叠加 `audit-readme`。
32+
33+
## 验证与探针
34+
35+
- 新增 V80 `audit-user-manual aggregation skill sync`,反查 Skill 本体、plugin 注册、routing、执行消费者、报告模板、README、website、Profile、changelog、`validate.js` 与 `test-spec-governance.js`。
36+
- 新增 V81 `spec-absorption execution skill sync`,反查 Skill 本体、plugin 注册、routing、执行消费者、prompt/report 字段、README、website、Profile、changelog、负向样例、`validate.js` 与 `test-spec-governance.js`。
37+
- 更新 V19 / V43 / V71 / V73 相关探针,避免旧 48 Skill 口径和旧 README 审查路由误报。
38+
39+
## 兼容性
40+
41+
- 不改变 CLI 命令、Hook 入口、包公开 API 或既有 Skill 的触发语义。
42+
- 新 Skill 是审查聚合入口,复用既有用户文档、通用文档、README、复审清单、文档同步和测试路由能力。
43+
- `spec-absorption` 是规范治理执行入口,不改变 RecordRouter 或 SCV 的既有台账分流语义;`spec-governance` 继续负责治理控制面。
44+
45+
## 验证摘要
46+
47+
- `node scripts/test-spec-governance.js`
48+
- `node scripts/validate.js` V1~V81
49+
- `npm test`
50+
51+
> 完整发布验证证据见本版本发布报告。

‎changelogs/unreleased.md‎

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -27,5 +27,7 @@
2727
- 发布 / pack / install smoke 验证需显式标明 `NativeCommandExitCodeGate`、真实 `exitCode`、PowerShell `$LASTEXITCODE` 或等价 wrapper、auth/config 来源和 V77 探针,避免命令失败后仍输出成功文案。
2828
- 确认后复审、开发偏移、验证计划、用户建议采纳和文档 IA 相关变更需显式标明 `PostConfirmationReviewScopeGate`、`DevelopmentDriftGate`、`VerificationPlanMaterializationProbe`、`AcceptedSuggestionRootCauseGate`、`ChinesePrimaryExpressionGate`、`SidebarPageRoleMaterializationProbe`、`SidebarGroupSemanticModelProbe` 和 V78 探针。
2929
- coverage 与外部 runtime 生命周期类变更需显式标明 `CoverageGateDecision`、`ExternalRuntimePluginLifecycleGate`、`ExternalRegistryLifecycleMatrixGate`、`FunctionSourceFingerprintMatrixGate`、`ClusterEscalationGate`、`RiskBasedValidationLadder` 和 V79 探针,避免测试断言通过、happy path 或单例函数对象被误当成完整验证。
30+
- 用户侧文档 review 聚合入口变更需显式标明 `audit-user-manual`、`UserManualReviewScope`、`DocsNavigationReviewMatrix`、`SidebarPageRoleMaterializationProbe`、`GeneratedSiteGate`、`DocsThemeRuntimeVisualProbeGate` 和 V80 探针,避免只补写作 Skill 而遗漏项目文档、菜单导航、生成站点和报告证据。
31+
- 规范吸纳执行入口变更需显式标明 `spec-absorption`、`CommonNormGeneralizationGate`、`AbsorptionCandidateConsumerProofGate`、`project-local`、`case-evidence-only`、`targetOwner` 和 V81 探针,避免把项目独有规则误吸纳为通用规范。
3032
- 宿主输出、Hook 或项目现实扩展相关条目,建议显式写出 `verified-present / verified-missing / unverified`、sticky `activeProject` 与用户可见 `意图扩展摘要` 是否发生变化。
3133
- 执行闭环、确认机制或发布门禁相关条目,建议补充 `Intent Expansion Card`、`ConfirmationRequest`、`ECR` 与验证证据,方便正式发版时直接归档到版本 changelog。

‎instructions.md‎

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -211,7 +211,7 @@ S02 不再把“敏感信息、明文密码、连接字符串或硬编码”定
211211

212212
### LayeredAbsorptionGate(分层吸纳架构)
213213

214-
每条可泛化 PI / PF / GAP / ISSUE 或用户确认“值得吸纳”的策略,在进入规范源实施前必须先执行 `LayeredAbsorptionGate`,并兼容执行 `SkillFirstAbsorptionGate` / `CapabilityToSkillPromotionGate`。AI 不得把成组能力默认继续追加到 `CrossProjectLearnedGuards`、`LatestAbsorptionGuards` 或通用 instructions 长列表,也不得只在通用规范或 Skill 二选一。
214+
每条可泛化 PI / PF / GAP / ISSUE 或用户确认“值得吸纳”的策略,在进入规范源实施前必须先读取 `spec-absorption`,执行 `CommonNormGeneralizationGate` 与 `AbsorptionCandidateConsumerProofGate`,证明通用规范价值、剔除项目独有残留、绑定 DevCodex 当前消费者和 targetOwner;随后执行 `LayeredAbsorptionGate`,并兼容执行 `SkillFirstAbsorptionGate` / `CapabilityToSkillPromotionGate`。AI 不得把成组能力默认继续追加到 `CrossProjectLearnedGuards`、`LatestAbsorptionGuards` 或通用 instructions 长列表,也不得只在通用规范或 Skill 二选一。
215215

216216
吸纳归属必须四选一:`global-invariant`(全局底线 / 路由 / 优先级)、`existing-skill-subgate`(并入既有 Skill 子门禁)、`new-skill-required`(新增独立 Skill)、`docs-only`(只作说明或历史镜像)。若能力具备多步骤流程、独立产物、状态/清单/模板、专属验证、跨工作流复用、或 3 条以上相关子规则,应优先判定为 `new-skill-required`。
217217

@@ -239,14 +239,14 @@ CP2 / 技术方案 / 报告必须记录 `LayeredAbsorptionDecision`:`candidate
239239

240240
### ConfirmedAbsorptionCompletenessGates(确认吸纳完整性补强)
241241

242-
用户确认“仍需吸纳清单”或复审指出“未完整吸纳 / 半覆盖 / 只有概念没有 Gate 或探针”时,必须把该批规则作为 `ConfirmedAbsorptionCompletenessGates` 处理:先复核是否仍有价值,再按 `LayeredAbsorptionGate` 分配到通用规范、既有 Skill 子门禁、新 Skill、Prompt、执行消费者、验证探针、公开文档和部署副本。不得因某个概念已经在文档里出现过,就跳过独立 Gate、探针或消费者同步。
242+
用户确认“仍需吸纳清单”或复审指出“未完整吸纳 / 半覆盖 / 只有概念没有 Gate 或探针”时,必须把该批规则作为 `ConfirmedAbsorptionCompletenessGates` 处理:先由 `spec-absorption` 复核是否仍有价值,剔除已完整吸纳、项目独有或仅适合作为 case evidence 的项,再按 `LayeredAbsorptionGate` 分配到通用规范、既有 Skill 子门禁、新 Skill、Prompt、执行消费者、验证探针、公开文档和部署副本。不得因某个概念已经在文档里出现过,就跳过独立 Gate、探针或消费者同步。
243243

244-
本批确认吸纳项按 `GovernanceGateRegistry` 分组执行,未触发时写 `N/A + skipReason`。本节在通用层只保留索引和触发面;每个 Gate 的执行正文、证据字段和验证路线以 `spec-governance`、目标 Skill、Prompt/Report 模板和 validate 探针为准。
244+
本批确认吸纳项按 `GovernanceGateRegistry` 分组执行,未触发时写 `N/A + skipReason`。本节在通用层只保留索引和触发面;候选扫描、通用性证明和消费者证明以 `spec-absorption` 为准,记录分流与 SCV 以 `spec-governance` 为准,每个 Gate 的执行正文、证据字段和验证路线以目标 Skill、Prompt/Report 模板和 validate 探针为准。
245245

246246
| gateGroup | 目标承接 |
247247
|------|----------|
248248
| `public-surface` | `PublicSurfaceClosureGate`、`SemanticLegacyRouteExposureGate`、`ReferenceCodeTruthSamplingGate`、`RemoteCIParityPushGate`、`PortableExternalArtifactGate` → `audit-release` / `release-verification` / `audit-readme` |
249-
| `user-manual` | `UserManualProductizationGate`、`UserManualRenderedFlowAndRealWorkflowProbe`、`DocsPageRoleMatrixGate`、`CompleteUserManualSiteMatrixGate`、`DocsThemeRuntimeVisualProbeGate` → `user-manual-authoring` |
249+
| `user-manual` | `UserManualProductizationGate`、`UserManualRenderedFlowAndRealWorkflowProbe`、`DocsPageRoleMatrixGate`、`CompleteUserManualSiteMatrixGate`、`DocsThemeRuntimeVisualProbeGate` → `user-manual-authoring` / `audit-user-manual` |
250250
| `review-checklist` | `SampleIssueExpansionGate`、`RequirementDimensionBindingGate`、`RequirementPriorityAndPhaseGate`、`ReviewAnchorMaterializationGate` → `review-checklist` / `audit-requirements` |
251251
| `frontend-runtime` | `FrontendAsyncCacheRenderGate`、`StaleWhileRevalidateGate`、`AsyncDbTruthSourceVerificationGate` → `audit-project` / `test-router` / `api-verification` |
252252
| `profile-service` | `StrongestProfileSourceGate`、`ServiceSpecificResidueSweep`、`ProfileReadChainGate`、`ServiceNormCoverageGate`、`RouteNamespaceResponsibilityGate` → `load-profile` / `profile-bootstrap` |
@@ -329,7 +329,7 @@ dev/fix 修改完成前必须判定是否影响 Profile。命中以下任一触
329329

330330
### CrossProjectLearnedGuards(跨项目已吸纳守门)
331331

332-
来自 `data/*.md`、复审、发布验证、同类项目实践或用户纠偏的可泛化规范被吸纳后,必须先走 `LayeredAbsorptionGate`、`SkillFirstAbsorptionGate` / `CapabilityToSkillPromotionGate` 与 `HistoricalCommonNormLayeringGate`。本节只保留 `legacy-index-retained` 索引、触发面和跨 Skill 路由;执行正文由 `GovernanceGateRegistry`、目标 Skill、TestRoute、report、document-sync、release-verification、audit 维度与 validate 探针承接。
332+
来自 `data/*.md`、复审、发布验证、同类项目实践或用户纠偏的可泛化规范被吸纳前,必须先走 `spec-absorption` 的通用性证明和消费者证明,再走 `LayeredAbsorptionGate`、`SkillFirstAbsorptionGate` / `CapabilityToSkillPromotionGate` 与 `HistoricalCommonNormLayeringGate`。本节只保留 `legacy-index-retained` 索引、触发面和跨 Skill 路由;执行正文由 `GovernanceGateRegistry`、目标 Skill、TestRoute、report、document-sync、release-verification、audit 维度与 validate 探针承接。
333333

334334
| gateGroup | legacy-index-retained anchors |
335335
|------|------|
@@ -536,7 +536,7 @@ CP1(问题确认)→ CP2(方案确认)→ [impact-review] → 执行 →
536536
| 需求文档/PRD | RQ-1~RQ-8(加载 `audit-common` + `audit-requirements` Skill)|
537537
| 项目工程/代码质量 | PE-1~PE-12(加载 `audit-common` + `audit-project` Skill;含资源生命周期与泄漏风险审查)|
538538
| 报告文件 | RA-1~RA-6(加载 `audit-common` + `audit-report` Skill)|
539-
| 通用文档 | DA-1~DA-6(加载 `audit-common` + `audit-document` Skill)|
539+
| 通用文档 | DA-1~DA-6(加载 `audit-common` + `audit-document` Skill;用户侧文档 / 文档站 / 项目文档 review 额外叠加 `audit-user-manual`,README / 主入口文档再叠加 `audit-readme`)|
540540
| 发布前审查 | RL-1~RL-10(加载 `audit-common` + `audit-release` Skill;审查 release readiness,不替代 `release-verification` R0~R7)|
541541

542542
---

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

‎instructions/01-common.instructions.md‎

Lines changed: 2 additions & 2 deletions
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.29
5+
version: 1.11.30
66
---
77
# 通用规范
88

@@ -194,7 +194,7 @@ version: 1.11.29
194194
| audit.需求文档 | `audit-common` · `audit-requirements` · `audit-session` |
195195
| audit.项目工程 | `audit-common` · `audit-project` · `audit-session` |
196196
| audit.报告 | `audit-common` · `audit-report` · `audit-session` |
197-
| audit.通用文档 | `audit-common` · `audit-document` · `audit-session`(README / 用户使用文档额外叠加 `audit-readme`) |
197+
| audit.通用文档 | `audit-common` · `audit-document` · `audit-session`(用户侧文档 / 文档站 / 项目文档 review 额外叠加 `audit-user-manual`;README / 主入口文档再叠加 `audit-readme`) |
198198
| audit.发布前审查 | `audit-common` · `audit-release` · `audit-session` |
199199
| analyze.default | (Instruction 已完整,无需额外 Skill)|
200200
| analyze.research | `analyze-research` |

‎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.29
5+
version: 1.11.30
66
---
77
# Profile 加载与项目现实扩展
88

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

Lines changed: 2 additions & 2 deletions
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.29
5+
version: 1.11.30
66
---
77
# 任务边界与 RecordRouter
88

@@ -59,7 +59,7 @@ version: 1.11.29
5959
- 一次性偏好或业务局部诉求 → 不写台账
6060
- 所有模式命中后都必须显式回执 `已记录 PI-xxx`、`已记录 PF-xxx` 或 `已记录 PI-xxx / PF-xxx`。
6161
- 支持 Hook 的宿主可把疑似治理输入标记为 `governanceIntakeCandidate` 并在收尾提醒未分流候选;该提醒只防止漏记,不替代语义判断。最终仍必须由 AI 给出 RecordRouter 判定,或明确 `record.none + skipReason`。
62-
- PI / PF / GAP / ISSUE 或用户确认“值得吸纳 / 未完整吸纳 / 半覆盖 / 仍需吸纳”的策略进入规范源前,必须执行 `LayeredAbsorptionGate`;若是半覆盖补强,追加 `ConfirmedAbsorptionCompletenessGates`,逐项检查 Gate 名、目标 Skill、Prompt、执行消费者、validate 探针、公开文档和部署副本是否闭环。自我进化、自动吸纳或模型辅助治理候选必须进入 `evolution-governance`。
62+
- PI / PF / GAP / ISSUE 或用户确认“值得吸纳 / 未完整吸纳 / 半覆盖 / 仍需吸纳”的策略进入规范源前,必须先读取 `spec-absorption`,执行 `CommonNormGeneralizationGate` 与 `AbsorptionCandidateConsumerProofGate`,证明通用规范价值、剔除项目独有残留并绑定 DevCodex 当前消费者;随后执行 `LayeredAbsorptionGate`。若是半覆盖补强,追加 `ConfirmedAbsorptionCompletenessGates`,逐项检查 Gate 名、目标 Skill、Prompt、执行消费者、validate 探针、公开文档和部署副本是否闭环。自我进化、自动吸纳或模型辅助治理候选必须进入 `evolution-governance`。
6363

6464
## Backlog Intake 真相复核
6565

0 commit comments

Comments
 (0)