Skip to content

Commit 1e77ed1

Browse files
committed
feat: release DevCodex 1.14.0
1 parent ea34406 commit 1e77ed1

127 files changed

Lines changed: 6226 additions & 2620 deletions

File tree

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-13
4+
> **最后更新**: 2026-07-14
55
66
---
77

88
## 版本概览
99

1010
| 版本 | 日期 | 变更摘要 | 详细 |
1111
|------|------|---------|------|
12+
| [v1.14.0](./changelogs/releases/v1.14.0.md) | 2026-07-14 | ✨ **Profile 生成、控制面契约与发布效率治理**:发布 Profile plan/分档安全迁移、canonical workflow/tenant/gate/report/TestRoute 契约、返工预防补强、六组剩余规范吸纳门禁与 V96 | [查看](./changelogs/releases/v1.14.0.md) |
1213
| [v1.13.0](./changelogs/releases/v1.13.0.md) | 2026-07-14 | ✨ **控制面模块化、返工预防与消费者验证**:新增 2 个 gray Skill、V92~V95、确定性 Skill portfolio、运行态/部署 manifest、受检命令、控制面模块拆分并以 GitHub Packages 发布 | [查看](./changelogs/releases/v1.13.0.md) |
1314
| [v1.12.0](./changelogs/releases/v1.12.0.md) | 2026-07-13 | ✨ **Skill 缺口、规模路由与专业 Owner 扩展**:新增 `skill-gap-analysis`、`skill-lifecycle-governance` 及分布式系统、性能工程、隐私合规、AI 评测 4 个专家 Owner;Skill 68→74、专家 Owner 17→21,并新增 `ProjectArtifactScaleRoutingGate` 与 V91 | [查看](./changelogs/releases/v1.12.0.md) |
1415
| [v1.11.33](./changelogs/releases/v1.11.33.md) | 2026-07-10 | 🔧 **修复协作、Profile 真相与发布闭环**:归档模型无关双层修复契约、MCP/Profile/audit/生成站点阻断修复,并新增 `ProfileTruthReconciliationGate`、`AuthorizedLocalSecurityAuditPresentationGate`、`PublisherCredentialTopologyGate` 与 V87~V90 | [查看](./changelogs/releases/v1.11.33.md) |

‎README.md‎

Lines changed: 12 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -47,14 +47,14 @@ DevCodex 通过 `.github/`(Copilot)、`CLAUDE.md + .claude/ + .mcp.json`(C
4747
- **支撑型 Skill**: `execution-contract` / `test-router` / `release-verification` / `host-contract-verification` / `source-consumer-sync` 为控制面、多批次、测试路线、宿主契约验证与真相源-消费者同步提供可审计支撑,不新增工作流分支
4848
- **模型无关双层修复协作契约**: AI 判断任务目标为 repair task 时至少建立 `lightweight` 决策/验收层 + 执行/验证层契约;P0/P1、安全、控制面、公共契约、多批次、角色交接或发布风险升级 `full`,用 `findingToPatchMap`、`handoffIntegrity` 与 `independentReReview` 防止范围漂移和补丁作者唯一自证。模型名称或是否切换 Agent 不是触发条件
4949
- **返工预防与信任链**: `rework-prevention-engineering` 以 WorkUnit/ReworkEvent、双重根因、FirstPassYield 和前瞻 trial 把“复审又发现问题”前移为可度量预防;新 Skill 当前保持 `gray`,只有跨任务前瞻证据证明有效才可升级。`CandidateDiffCompletenessGate` 在 commit/tag/publish 前用 staged candidate snapshot 覆盖 tracked/untracked,并执行 cached diff、name-status、secret-shape 与 intended scope 对账;普通 working diff 不能替代。`ReviewCoverageClaimIntegrityGate`、`ArtifactDeliveryCompletenessGate`、`ReleaseAuthorityBeforeCompatibilityGate`、`ConfigurationErgonomicsGate` 与 `InteractiveSemanticProbe` 分别约束审查真实性、产物交付、兼容判断、配置易用性和交互语义
50-
- **跨仓消费者验证**: `consumer-validation-engineering` 以 RepositoryBinding、SourceConsumerIdentity、ValidationDenominatorMatrix、packed artifact、跨仓 CI 与 freshness drift 约束 SDK/CLI/框架/公共包的独立消费者仓;realpath、link smoke 或单一 100% 分母不能冒充完整验证。该 Skill 当前保持 `gray`,并由 V95 正负向探针守门
51-
- **发布前审查能力**: `audit-release` 负责 release readiness、发布说明质量、兼容/迁移风险、package/plugin 元数据、文档/Profile/website 同步、回滚策略、registry/tag 风险与发布后验收 review;`release-verification` 仍负责 R0~R7 执行验证链
50+
- **跨仓消费者验证**: `consumer-validation-engineering` 以 RepositoryBinding、SourceConsumerIdentity、ValidationDenominatorMatrix、packed artifact、跨仓 CI 与 freshness drift 约束 SDK/CLI/框架/公共包的独立消费者仓;`DesignFitnessGate` 额外判断主路径、默认值、配置层级、框架约定和维护成本,`ValidationFindingRepairLoop` 在 source mutation 后使旧 identity/证据 stale 并按影响矩阵重跑。realpath、行为全绿或单一 100% 分母不能冒充完整验证。该 Skill 保持 `gray`,由 V95 正负探针守门
51+
- **发布前审查与关键路径治理**: `audit-release` 负责 release readiness、说明、兼容、包与发布风险;`release-verification` 执行 R0~R7,并以 `ReleaseEfficiencyControlGate` 的 `CandidateFreezeGate`、`ReleaseCriticalPathBudgetGate`、`ValidationEvidenceReuseGate` 管理候选 generation、预算和证据失效。pack/install smoke 额外执行 `IsolatedConsumerCwdGate`:显式 consumer manifest、真实 consumer cwd、source identity 前后对账;禁止用 `npm init --prefix` 冒充 cwd 隔离。无可比较基线时预算只能 advisory,不能削弱 version/pack/registry/R7
5252
- **审计与修复授权分离**: `AuditMutationBoundaryGate` 规定 audit 只写报告、audit-state、记忆和运行态台账;任何源码/规范/配置/测试/文档/部署副本修复都需用户显式授权后进入独立 fix/self-fix,audit 不自动改源、`git add` 或继承修复权限
53-
- **分析与用户文档能力**: `analyze-default` 承接默认只读多轮分析、代码事实优先、analyze-lite CRS 与 PCV 收敛验证;`analyze-research` 承接技术调研/选型。`user-manual-authoring` 负责站点文档、最终用户使用文档、README、quick start、接入手册和 docs-first 用户手册的用户路径、信息架构、配置/排错和真实工作流;`readme-authoring` 是 README 专项分支,`audit-user-manual` 是用户侧文档 / 项目文档 / 菜单导航 / 信息架构专项 review 聚合入口,`audit-readme` 负责 README / 用户使用文档专项 review;`UserPerspectiveDocsGate` 要求文档按使用者第一次成功、常见任务、字段/参数/状态/错误解释、排错恢复和低心智负担组织,`UserDocsImmediateComprehensionGate` 要求用户文档输出功能完整性、配置易懂性和首次读者即时理解三轴结论,`UserDocsPrimarySurfaceGate` 要求站点文档 / README / quick start 先冻结 targetSurface、documentLocation 与 primaryAudience,首页首屏、quick start、nav/sidebar、CTA 和 reference 主路径必须服务用户使用而不是开发契约,`FinalUserManualFirstGate` / `DocsSiteInformationArchitectureGate` / `UserManualFlowAndFailureGate` / `QueueDocsRealWorkflowGate` 要求需求概况后优先产出最终用户使用文档,文档站按任务组织并覆盖成功、失败恢复和队列/异步真实工作流,`PublicUserDocsMaintainerBoundaryGate` 要求公开用户文档不混入维护者 checklist、内部同步清单或台账状态,`DocsConsumerSweep` 与 `UserPathContractSweep` 负责同步 README、website、Profile、示例、模板、导航、validate、部署副本和代码消费点
53+
- **分析与用户文档能力**: `analyze-default` / `analyze-research` 承接分析与调研;`user-manual-authoring`、`audit-user-manual`、`readme-authoring` 和 `audit-readme` 收口站点文档 / README / quick start 的用户路径、信息架构、配置排错和真实工作流。声称场景完整时必须执行 `ScenarioCoverageMatrixProbe`;队列/批处理还要执行 `DurableBatchOrchestrationProbe`,页面或关键词存在、一次 `addBulk`、进程内 callback 都不能替代持久 run、故障恢复与 executable evidence
5454
- **专家型产物质量能力**: `expert-output-quality` 负责代码、文档、示例、fixture、quick start、技术方案和报告的专家型输出质量;`ExpertOutputQualityGate` 要求先给生产推荐路径、框架原生能力和项目既有能力,再说明 fixture/mock/demo 边界、反模式和证据矩阵。V84 探针会阻止把测试夹具、硬编码单例或每个 route 重复声明包装成生产推荐实践。
5555
- **专家 Owner Skill 能力**: 21 个专家 Owner Skill 分别承接产品策略、开发者体验、UX 交互、前端架构、后端领域架构、生产可用性 / SRE、API 契约、外部集成、平台生态、AI Agent 系统、数据架构、安全威胁建模、质量策略、设计系统、无障碍/国际化、增长分析和商业模型;`growth-analytics` 与 `business-model-review` 为 P3 条件触发,未命中时写 `N/A + skipReason`;`ExpertOwnerSkillGate` 要求报告 ownerSkill、triggerReason、requiredFields、validationRoute、skipReason 和 V85/targeted probe 证据,避免“专家视角”只停留在泛泛口号。
5656
- **复审清单能力**: `review-checklist` 负责正式复审、ECR、发布前复审、多轮收敛和外部 finding 批次的清单创建、范围冻结、逐项证据执行、遗漏逃逸分析、状态新鲜度和收敛关闭;`PostConfirmationReviewScopeGate` 要求 CP 确认后按风险选择轻量或全面复审;`ReviewEscapeRecordGate` 要求发现遗漏时先在清单写入 `whyMissed / prevention / checklistPatch / rerunEvidence`,再补清单和重跑验证;`ChecklistStateMaterializationGate` 在 clean/closed 前核对 header、items、round、ledger、progress、closure 六区块一致快照
57-
- **实施偏移与文档 IA 守门**: `DevelopmentDriftGate` 在编码前和实施中核对 `allowedFirstBatch / blockedScope / driftTriggers / validationRoute`;`VerificationPlanMaterializationProbe` 要求技术方案物化验证计划、验收标准和退出条件;`ChinesePrimaryExpressionGate`、`SidebarPageRoleMaterializationProbe` 与 `SidebarGroupSemanticModelProbe` 要求用户文档中文主表达、页面角色和 sidebar 分组语义可验证
57+
- **范围、契约与阶段语义守门**: `DevelopmentDriftGate`、`CurrentBatchScopeDiffProbe` 与 `NewValidationConsumerRebindProbe` 约束当前批次及新增 CI/validator/deploy 消费者;`ContractVariantIsolationMutationGate` 以 sibling-field injection 和 completion-evidence deletion 防止合同假绿;`PhaseDeliverySemanticGate` 区分 planning coverage 与 source delivery;文档 IA 仍由 `ChinesePrimaryExpressionGate`、页面角色与 sidebar 语义探针约束。上述剩余吸纳控制由 V96 正负探针守门
5858
- **Skill 缺口与生命周期能力**: `skill-gap-analysis` 负责 `ProjectArtifactScaleRoutingGate`,`skill-lifecycle-governance` 负责 portfolio 生命周期;`distributed-systems-architecture`、`performance-engineering`、`privacy-compliance-architecture`、`ai-evaluation-engineering` 为新增专业 Owner,V85/V91 守门。
5959
- **自我进化治理能力**: `evolution-governance` 负责自我进化、自动吸纳、模型辅助规范优化、自动补 Skill / Prompt / Probe 和自动治理候选的控制面,执行 `EvolutionCapabilityControlPlaneGate`,冻结授权、模型配置、租户 / 权限、配额、数据边界、审计、回滚和发布审批;模型输出只能进入候选态,不能直接写 active 规范或发版
6060
- **Profile 新鲜度审查**: audit 会先执行 `Profile Freshness Check`,反向核对 Profile 是否仍匹配当前包版本、目录资产、脚本、发布状态、宿主能力和任务现实
@@ -91,11 +91,11 @@ DevCodex 通过 `.github/`(Copilot)、`CLAUDE.md + .claude/ + .mcp.json`(C
9191

9292
## 5 分钟快速开始
9393

94-
先区分两个版本概念:npm package 的当前已发布版本是 **v1.13.0**;文档站的 **1.0.1** 是活动需求文档版本,不是可安装包版本。
94+
先区分两个版本概念:npm package 的当前已发布版本是 **v1.14.0**;文档站的 **1.0.1** 是活动需求文档版本,不是可安装包版本。
9595

9696
| 通道 | 当前状态 | 用途 |
9797
|---|---|---|
98-
| GitHub Packages | ✅ v1.13.0 已发布 | 当前唯一发布通道;安装需要 GitHub Packages `read:packages` 认证 |
98+
| GitHub Packages | ✅ v1.14.0 已发布 | 当前唯一发布通道;安装需要 GitHub Packages `read:packages` 认证 |
9999

100100
1. 确认 CLI 运行时(文档站维护另需 Node `^20.19.0 || >=22.12.0`):
101101

@@ -112,7 +112,7 @@ node --version # CLI 需要 Node.js >=18
112112

113113
当前 shell 的 `NODE_AUTH_TOKEN` 需使用具备 `read:packages` 的 GitHub PAT。
114114

115-
3. 安装当前 v1.13.0:
115+
3. 安装当前 v1.14.0:
116116

117117
```bash
118118
npm install @vextjs/devcodex
@@ -129,7 +129,7 @@ npx @vextjs/devcodex status
129129

130130
## 安装
131131

132-
以下是当前已发布 v1.13.0 的完整安装说明。当前版本仅发布到 GitHub Packages,安装需要读取认证。
132+
以下是当前已发布 v1.14.0 的完整安装说明。当前版本仅发布到 GitHub Packages,安装需要读取认证。
133133

134134
### 1. 配置 GitHub Packages
135135

@@ -146,12 +146,12 @@ export NODE_AUTH_TOKEN=YOUR_GITHUB_PAT
146146

147147
这里的环境变量仅用于 GitHub Packages 认证流程,不代表项目里的普通配置默认都应 env 化;未明确要求 env 时,AI 不得主动把明文或硬编码改成 env、`secretRef`、secret manager 或 `config.local.json`。
148148

149-
> v1.13.0 未发布到 npmjs;缺少上述 registry 或读取认证时,安装不会自动回退到其他通道。
149+
> v1.14.0 未发布到 npmjs;缺少上述 registry 或读取认证时,安装不会自动回退到其他通道。
150150
151151
### 2. 安装并初始化
152152

153153
```bash
154-
npm install @vextjs/devcodex@1.13.0
154+
npm install @vextjs/devcodex@1.14.0
155155
npx @vextjs/devcodex init # 默认三宿主部署:Copilot + Claude Code adapter + Codex adapter
156156
npx @vextjs/devcodex init --claude # 仅 Claude Code adapter
157157
npx @vextjs/devcodex init --codex # 仅 Codex adapter
@@ -306,7 +306,7 @@ devcodex migrate-layout rollback --manifest <manifest-path>
306306
307307
## Profile 计划、生成与升级
308308

309-
> 发布状态:以下 `profile plan`、统一分档生成和安全迁移行为属于当前仓库的 **unreleased** 变更;正式包发布前,已安装的 v1.13.0 仍以其内置 CLI 为准。
309+
> 发布状态:以下 `profile plan`、统一分档生成和安全迁移行为已随 **v1.14.0** 发布;安装当前包即可使用。
310310
311311
先预览,再写入:
312312

@@ -541,7 +541,7 @@ DevCodex Hook runtime 不再把所有拦截都等同为“停止”。拦截会
541541

542542
DevCodex 的 `plugin.json` 声明 `tier: "free"`,所有 Skill 均标注 `tier: "free"`。这些 tier 字段是**面向未来的 prompt-level 声明**(供 `token-check` Skill 在 Agent 侧做软门控),**CLI 不做任何授权校验**:
543543

544-
- CLI 本身不做额外 license/tier 授权校验;当前 v1.13.0 通过 GitHub Packages 分发,registry 读取认证仍按平台规则执行
544+
- CLI 本身不做额外 license/tier 授权校验;当前 v1.14.0 通过 GitHub Packages 分发,registry 读取认证仍按平台规则执行
545545
- 未来接入服务端 token 校验时,tier 字段才会生效
546546
- 当前阶段 tier 仅作为规划信息,不影响功能使用
547547

‎RULES.md‎

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

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

‎SECURITY.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@
44

55
| Version | Supported |
66
|---------|:----------:|
7-
| 1.13.x(当前) | ✅ |
7+
| 1.14.x(当前) | ✅ |
88
| 1.12.x | ⚠️ 仅安全补丁 |
99
| 1.11.x | ⚠️ 仅安全补丁 |
1010
| 1.6.x | ⚠️ 仅安全补丁 |

‎changelogs/releases/v1.14.0.md‎

Lines changed: 50 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,50 @@
1+
# v1.14.0 Profile 生成、控制面契约与发布效率治理
2+
3+
> 发布日期:2026-07-14
4+
5+
## 版本信息
6+
7+
| 项目 | 内容 |
8+
|---|---|
9+
| 版本号 | v1.14.0 |
10+
| 发布类型 | MINOR |
11+
| 兼容性 | 向后兼容;CLI 仍支持 Node.js >=18;未改变既有 Profile 默认继承语义,新增降档必须显式授权 |
12+
| 分发 | GitHub Packages 单渠道(restricted;安装需 `read:packages`) |
13+
14+
## Profile 生成与功能清单
15+
16+
- 新增 `ProfileGenerationContractGate`,由 `mcp/profile-contract.js` 统一三档文件集合、语义检查和功能清单 schema,CLI、加载器、状态与 validator 共同消费。
17+
- 新增 `devcodex profile plan` 与真实 `--dry-run` 零写入预览;展示目标根、已检测/请求/推荐/目标档位和逐文件动作。
18+
- 新增 `ProfileTierMigrationSafetyGate`:默认继承已有档位,升级只补缺失文件;隐式降档拒绝,`--allow-downgrade` 保留高档文件,`--force` 先备份。
19+
- 新增 `FeatureInventorySchemaGate` / `FeatureInventorySchemaV1` 十字段规范表及正负验证,阻断空清单、占位行、伪来源、重复真相源和发布状态冲突。
20+
21+
## 控制面、返工预防与验证
22+
23+
- 新增 canonical workflow capability、tenant manifest/selector、Governance Gate、report 与 TestRoute JSON 契约;共享 loader 取代并行 mega-registry。
24+
- 补强 API endpoint matrix、empty-test fail-closed、风险化场景/coverage/E2E 路由、临时项目依赖隔离与 Git 临时 index 验证。
25+
- Skill portfolio 从明确强制读取关系生成 dependency graph,绑定结构化 triggers、冲突复核、active/gray 证据、回滚条件与确定性生成检查。
26+
- `dev-plan-review` 同阶段聚合安全独立 blocker,并以冻结 `BlockerSnapshot`、统一修复和依赖式复验降低遗漏返工;`rework-prevention-engineering` 与 `ChecklistStateMaterializationGate` 继续由 V94 复证。
27+
- 修复 delivery/progress/memory/analyze/docs 模板条件,补齐三轨 CHANGELOG、ContextHandoffCard、CRS/PCV 与条件 TOC;规范 Markdown 增加围栏和结构验证。
28+
29+
## 剩余规范吸纳
30+
31+
- 新增 `ReleaseEfficiencyControlGate`:`CandidateFreezeGate`、关键路径预算、验证证据复用与发布返工事件;`IsolatedConsumerCwdGate` 要求 pack/install smoke 使用显式 consumer manifest、真实 consumer cwd 与 source identity 前后对账,并以 `npm init --prefix` 为负例;无可比较基线时保持 advisory。
32+
- 新增批次范围 diff / 新验证消费者重绑定、契约变体隔离与 mutation、阶段交付语义、场景覆盖矩阵和 durable batch orchestration 门禁。
33+
- 扩展 gray `consumer-validation-engineering`:`DesignFitnessGate` 校验消费者主路径适配,`ValidationFindingRepairLoop` 在修复后使旧证据失效并按影响矩阵复跑。
34+
- 新增 V96 模块化正负探针并扩展 V95;同步 canonical registry、report schema、Owner Skills、README、website、Profile、台账与三宿主部署副本。
35+
36+
## 验证面
37+
38+
- 验证探针扩展到 V1~V96,覆盖 source、Prompt、TestRoute、report、Profile、portfolio、公开文档和 Copilot/Claude Code/Codex 部署副本。
39+
- 发布链验证 full、coverage、production audit、package boundary、pack/install smoke、目标 SHA 远端 CI、annotated tag、GitHub Packages 与 fresh registry consumer。
40+
41+
## 升级
42+
43+
先按 README 配置 GitHub Packages registry 与 `NODE_AUTH_TOKEN`,再安装或升级:
44+
45+
```bash
46+
npm install @vextjs/devcodex@1.14.0
47+
npx @vextjs/devcodex update
48+
```
49+
50+
v1.14.0 仅发布到 GitHub Packages,需要 `read:packages` 认证;本版本不提供 npmjs 匿名安装通道。

0 commit comments

Comments
 (0)