Skip to content

Commit cab651a

Browse files
committed
feat: add skill gap and scale routing governance
1 parent c082a7a commit cab651a

61 files changed

Lines changed: 678 additions & 85 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-10
4+
> **最后更新**: 2026-07-13
55
66
---
77

88
## 版本概览
99

1010
| 版本 | 日期 | 变更摘要 | 详细 |
1111
|------|------|---------|------|
12+
| [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) |
1213
| [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) |
1314
| [v1.11.32](./changelogs/releases/v1.11.32.md) | 2026-07-09 | 🔧 **专家能力、记忆启动链与发布包依赖闭包**:新增 `expert-output-quality`、17 个专家 Owner Skill、`ExpertOutputQualityGate`、`ExpertOwnerSkillGate`、`MemoryCannotSatisfyBootstrapGate` 与 `PackagedScriptDependencyClosureGate`,补齐 V84/V85/V86 探针,防止专家口径泛化、宿主 Memories 替代文件真相源,以及源码测试通过但 tarball 公开脚本缺运行时依赖 | [查看](./changelogs/releases/v1.11.32.md) |
1415
| [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) |

‎README.md‎

Lines changed: 5 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -49,9 +49,10 @@ DevCodex 通过 `.github/`(Copilot)、`CLAUDE.md + .claude/ + .mcp.json`(C
4949
- **审计与修复授权分离**: `AuditMutationBoundaryGate` 规定 audit 只写报告、audit-state、记忆和运行态台账;任何源码/规范/配置/测试/文档/部署副本修复都需用户显式授权后进入独立 fix/self-fix,audit 不自动改源、`git add` 或继承修复权限
5050
- **分析与用户文档能力**: `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、部署副本和代码消费点
5151
- **专家型产物质量能力**: `expert-output-quality` 负责代码、文档、示例、fixture、quick start、技术方案和报告的专家型输出质量;`ExpertOutputQualityGate` 要求先给生产推荐路径、框架原生能力和项目既有能力,再说明 fixture/mock/demo 边界、反模式和证据矩阵。V84 探针会阻止把测试夹具、硬编码单例或每个 route 重复声明包装成生产推荐实践。
52-
- **专家 Owner Skill 能力**: 17 个专家 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 证据,避免“专家视角”只停留在泛泛口号。
52+
- **专家 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 证据,避免“专家视角”只停留在泛泛口号。
5353
- **复审清单能力**: `review-checklist` 负责正式复审、ECR、发布前复审、多轮收敛和外部 finding 批次的清单创建、范围冻结、逐项证据执行、遗漏逃逸分析、状态新鲜度和收敛关闭;`PostConfirmationReviewScopeGate` 要求 CP 确认后按风险选择轻量或全面复审;`ReviewEscapeRecordGate` 要求发现遗漏时先在清单写入 `whyMissed / prevention / checklistPatch / rerunEvidence`,再补清单和重跑验证
5454
- **实施偏移与文档 IA 守门**: `DevelopmentDriftGate` 在编码前和实施中核对 `allowedFirstBatch / blockedScope / driftTriggers / validationRoute`;`VerificationPlanMaterializationProbe` 要求技术方案物化验证计划、验收标准和退出条件;`ChinesePrimaryExpressionGate`、`SidebarPageRoleMaterializationProbe` 与 `SidebarGroupSemanticModelProbe` 要求用户文档中文主表达、页面角色和 sidebar 分组语义可验证
55+
- **Skill 缺口与生命周期能力**: `skill-gap-analysis` 负责 `ProjectArtifactScaleRoutingGate`,`skill-lifecycle-governance` 负责 portfolio 生命周期;`distributed-systems-architecture`、`performance-engineering`、`privacy-compliance-architecture`、`ai-evaluation-engineering` 为新增专业 Owner,V85/V91 守门。
5556
- **自我进化治理能力**: `evolution-governance` 负责自我进化、自动吸纳、模型辅助规范优化、自动补 Skill / Prompt / Probe 和自动治理候选的控制面,执行 `EvolutionCapabilityControlPlaneGate`,冻结授权、模型配置、租户 / 权限、配额、数据边界、审计、回滚和发布审批;模型输出只能进入候选态,不能直接写 active 规范或发版
5657
- **Profile 新鲜度审查**: audit 会先执行 `Profile Freshness Check`,反向核对 Profile 是否仍匹配当前包版本、目录资产、脚本、发布状态、宿主能力和任务现实
5758
- **Profile 真相对账**: `ProfileTruthReconciliationGate` 由 `load-profile` 统一承接;项目级 analyze 使用 targeted 模式,audit 使用 full/PFresh 模式并反查 repo shape 与 Profile 档位/生命周期文件。`ProfileTruthMatrix` 记录声明、实际来源、漂移分类、结论权威和修订路线;只读工作流只矫正结论,不直接修改 Profile。V88 提供正负向同步探针。
@@ -119,7 +120,7 @@ npx @vextjs/devcodex init --codex # 仅 Codex adapter
119120
├── copilot-instructions.md ← 默认 Copilot always-on 总则(新增)
120121
├── instructions/ ← Instructions 约束(15 个,含全部工作流规则)
121122
├── agents/ ← Copilot 自定义 Agent(v1.9.8 起恢复默认分发)
122-
├── skills/ ← Skill 详细检查标准(68 个,按需读取,含默认分析、用户文档、用户侧文档 review 聚合、专家型产物质量、17 个专家 Owner Skill、复审清单、自我进化治理、README 专项能力、spec-governance、spec-absorption 与 5 个支撑型 Skill)
123+
├── skills/ ← Skill 详细检查标准(74 个,按需读取,含默认分析、用户文档、用户侧文档 review 聚合、专家型产物质量、21 个专家 Owner Skill、复审清单、自我进化治理、README 专项能力、spec-governance、spec-absorption 与 5 个支撑型 Skill)
123124
├── prompts/ ← Prompt 模板(30 个)
124125
├── hooks/ ← 宿主生命周期 Hook 配置与运行时
125126
│ ├── devcodex.lifecycle.json
@@ -323,7 +324,7 @@ devcodex/
323324
├── instructions.md # 单源规范文件;安装时按平台生成 copilot-instructions.md / CLAUDE.md / AGENTS.md
324325
├── agents/ # Agent 源文件;Copilot 端默认分发,Claude Code 端不分发
325326
├── instructions/ # 全局 Instructions(15 个,含工作流规则摘要,自动注入)
326-
├── skills/ # Skill 详细检查标准(68 个,按 01-common §按需读取表 路由读取)
327+
├── skills/ # Skill 详细检查标准(74 个,按 01-common §按需读取表 路由读取)
327328
├── prompts/ # Prompt 模板(30 个)
328329
├── hooks/ # Workspace Hooks 配置与分发到 `.github/hooks/_runtime/` 的运行时及 helper 模块
329330
├── codex/ # Codex adapter 源模板(分发到 `.codex/hooks.json`,不是工作区部署副本 `.codex/`)
@@ -344,7 +345,7 @@ README / 用户使用文档当前补充四类专项 Skill:`user-manual-authori
344345

345346
代码、文档、示例、fixture、quick start、技术方案和报告的专家型输出由 `expert-output-quality` 承接。`ExpertOutputQualityGate` 要求报告或文档不能只解释“fixture 能跑通”,还要给出生产推荐路径、框架原生能力、项目既有 helper、fixture/mock/demo 边界、反模式对照和证据矩阵;V84 负责同步 Skill、Prompt、执行消费者、README/website/Profile/changelog 和部署副本。
346347

347-
产品策略、开发者体验、UX 交互、前端架构、后端领域架构、生产可用性 / SRE、API 契约、外部集成、平台生态、AI Agent 系统、数据架构、安全威胁建模、质量策略、设计系统、无障碍/国际化、增长分析和商业模型由 17 个专家 Owner Skill 承接:`product-strategy`、`developer-experience-architecture`、`ux-interaction-architecture`、`frontend-architecture`、`backend-domain-architecture`、`production-readiness-sre`、`api-contract-architecture`、`external-integration-architecture`、`platform-ecosystem-architecture`、`ai-agent-system-architecture`、`data-architecture`、`security-threat-modeling`、`quality-strategy`、`design-system-architecture`、`accessibility-i18n`、`growth-analytics`、`business-model-review`。`growth-analytics` 与 `business-model-review` 为 P3 条件触发,不污染普通开发主路径;`ExpertOwnerSkillGate` 要求在技术方案、实施计划、TestRoute 和报告中记录 ownerSkill、triggerReason、requiredFields、validationRoute、skipReason 与 V85/targeted probe 证据,避免把专业判断只写成笼统的“从专家角度考虑”。
348+
产品策略、开发者体验、UX 交互、前端架构、后端领域架构、生产可用性 / SRE、API 契约、外部集成、平台生态、AI Agent 系统、数据架构、安全威胁建模、质量策略、设计系统、无障碍/国际化、增长分析和商业模型由 21 个专家 Owner Skill 承接:`product-strategy`、`developer-experience-architecture`、`ux-interaction-architecture`、`frontend-architecture`、`backend-domain-architecture`、`production-readiness-sre`、`api-contract-architecture`、`external-integration-architecture`、`platform-ecosystem-architecture`、`ai-agent-system-architecture`、`data-architecture`、`security-threat-modeling`、`quality-strategy`、`design-system-architecture`、`accessibility-i18n`、`growth-analytics`、`business-model-review`、`distributed-systems-architecture`、`performance-engineering`、`privacy-compliance-architecture`、`ai-evaluation-engineering`。`growth-analytics` 与 `business-model-review` 为 P3 条件触发,不污染普通开发主路径;`ExpertOwnerSkillGate` 要求在技术方案、实施计划、TestRoute 和报告中记录 ownerSkill、triggerReason、requiredFields、validationRoute、skipReason 与 V85/targeted probe 证据,避免把专业判断只写成笼统的“从专家角度考虑”。
348349

349350
正式复审、ECR、发布前复审、多轮收敛和外部 finding 批次由 `review-checklist` 管理清单文件、冻结范围、逐项证据、遗漏逃逸分析、状态新鲜度和关闭结论;CP 确认后由 `PostConfirmationReviewScopeGate` 判定轻量或全面复审。报告中的 `ReviewChecklistCompletenessGate` / `EvidenceExecutionGate` / `ReviewEscapeRecordGate` 必须引用该清单或说明 N/A。复审发现新遗漏时,先写 escape record 的 `escapedItem / whyMissed / prevention / checklistPatch / rerunEvidence`,再补清单、重跑验证并判断是否写 VL/PF/GAP。
350351

‎RULES.md‎

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

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

‎SECURITY.md‎

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

55
| Version | Supported |
66
|---------|:----------:|
7-
| 1.11.x(当前) | ✅ |
7+
| 1.12.x(当前) | ✅ |
8+
| 1.11.x | ⚠️ 仅安全补丁 |
89
| 1.10.x | ⚠️ 仅安全补丁 |
910
| 1.6.x | ⚠️ 仅安全补丁 |
1011
| < 1.6.0 | ❌ |

‎changelogs/releases/v1.12.0.md‎

Lines changed: 51 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,51 @@
1+
# v1.12.0 Skill 缺口、规模路由与专业 Owner 扩展
2+
3+
> 发布日期:2026-07-13
4+
5+
## 版本信息
6+
7+
| 项目 | 内容 |
8+
|---|---|
9+
| 版本号 | v1.12.0 |
10+
| 发布类型 | MINOR |
11+
| 兼容性 | 向后兼容;不新增依赖、运行时服务、API、Schema 或配置迁移 |
12+
| 核心变化 | 6 个新增 Skill、规模路由门禁、Skill 生命周期治理、V85/V91 消费者同步 |
13+
14+
## 新增 Skill
15+
16+
| Skill | 定位 | 核心 Gate / 产物 |
17+
|---|---|---|
18+
| `skill-gap-analysis` | 项目/工作区产物驱动的 Skill 缺口分析 | `ProjectArtifactScaleRoutingGate`、WorkspaceCorpusManifest、ScaleDecisionRecord、BatchEvidenceLedger、ExistingSkillCoverageMatrix |
19+
| `skill-lifecycle-governance` | Skill portfolio 生命周期与触发质量治理 | `SkillPortfolioLifecycleGate`、PortfolioIndex、DependencyGraph、LifecycleChangeSet、TriggerQualityScorecard |
20+
| `distributed-systems-architecture` | 分布式一致性、交付、顺序、幂等、重试、补偿与分区治理 | `DistributedSystemsArchitectureGate`、FailureModeMatrix |
21+
| `performance-engineering` | 性能预算、基准、profiling、归因、容量与回归治理 | `PerformanceEngineeringGate`、PerformanceEvidenceRecord |
22+
| `privacy-compliance-architecture` | 数据分类、目的/同意、最小化、保留、驻留和主体权利治理 | `PrivacyComplianceArchitectureGate`、PrivacyDataLifecycleMatrix |
23+
| `ai-evaluation-engineering` | 模型/Prompt 评测、黄金集、Judge 校准、方差和成本延迟质量治理 | `AiEvaluationEngineeringGate`、EvaluationEvidenceRecord |
24+
25+
## 规模路由规则
26+
27+
项目、目录或工作区分析/审查/扫描在 broad scan 前必须先:
28+
29+
1. 唯一识别项目、source root、active root 和排除边界。
30+
2. 采集 relevant file count、parseable bytes、largest file、directory concentration、derived artifact ratio、consumer fan-out。
31+
3. 选择 `single-pass / batched / sampled+deep-read / blocked`,并记录 ScaleDecisionRecord。
32+
4. 分批任务写 checkpoint;错误 glob、超时、派生产物污染或未解析项目的运行结果标为 invalid,不得用于完成声明。
33+
34+
默认只有同时满足不超过 50 个相关文件、2 MiB 可解析内容、最大文件不超过 256 KiB、消费者扇出不超过 10 且无“大目录”信号时,才允许 single-pass。Profile 可以更保守,不得放宽该边界。
35+
36+
## 消费者与验证
37+
38+
- Skill 总数从 68 更新为 74,专家 Owner 从 17 更新为 21。
39+
- plugin、routing、analyze/audit、spec absorption/governance、evolution、TestRoute、report、Prompt、README、website、Profile 与三宿主部署副本已同步。
40+
- V91 新增规模路由与 6 Skill 完整性探针;V85 扩展 4 个专家 Owner 的路由、字段和消费者探针。
41+
- 验证覆盖 6 个 Skill quick validate、V1~V91、34 个 Profile、完整 npm test、Rspress build/link、语法检查、pack clean 和两套依赖审计。
42+
43+
## 升级说明
44+
45+
升级后建议在目标工作区运行:
46+
47+
```powershell
48+
devcodex update
49+
```
50+
51+
已有工作流和 Skill 路由保持兼容。新增规模路由只在项目/目录分析、审查、扫描和大语料任务触发,不增加普通低风险任务的额外阶段。

0 commit comments

Comments
 (0)