Skip to content

Commit 95e9fa7

Browse files
committed
release: v1.11.18
1 parent 1886752 commit 95e9fa7

52 files changed

Lines changed: 417 additions & 35 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.18](./changelogs/releases/v1.11.18.md) | 2026-06-11 | 🔧 **前端体验质量门禁与跨项目吸纳守门收口**:新增 `FrontendExperienceQualityGate`、UI/UX 体验门禁、8 项 `CrossProjectLearnedGuards`,并同步 dev/fix/audit/test Skill、CP/报告模板、README、website、活动版本 P1 需求页与 V61 探针 | [查看](./changelogs/releases/v1.11.18.md) |
1213
| [v1.11.17](./changelogs/releases/v1.11.17.md) | 2026-06-11 | 🔧 **并发策略、默认 Auto 别名与泄漏稳定性测试路线收口**:新增 `ConcurrencyPolicy` Profile schema、全局默认 `@rocky` Auto 别名、`PE-12` 资源生命周期审查维度与 `LeakRiskStabilityPressureTest` 测试路线,并补齐活动版本 P1 需求页、website sidebar 与治理探针 | [查看](./changelogs/releases/v1.11.17.md) |
1314
| [v1.11.16](./changelogs/releases/v1.11.16.md) | 2026-06-10 | 🔧 **治理 intake 行为闭环、跨项目吸纳守门与发布前收敛**:新增用户建议/纠错的行为级治理 intake replay,修正 source-root 宿主副本治理、Profile/website 新鲜度与 C13 作用域,吸纳跨项目 data 守门并补齐 `TechnicalRouteComparativeGate` | [查看](./changelogs/releases/v1.11.16.md) |
1415
| [v1.11.15](./changelogs/releases/v1.11.15.md) | 2026-06-09 | 🔧 **问答证据门禁、复杂度用户面与产物生命周期收口**:新增 `QuestionEvidenceGate / ComparativeResearchGate`,将 CP1 复杂度主口径升级为 `ImplementationComplexityLevel` 三档,并补齐 `ArtifactDecisionMatrix / ArtifactLifecycleState`、模板漂移探针与 V8 source-root 部署副本检查 | [查看](./changelogs/releases/v1.11.15.md) |

‎README.md‎

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -48,12 +48,13 @@ DevCodex 通过 `.github/`(Copilot)、`CLAUDE.md + .claude/ + .mcp.json`(C
4848
- **Profile 新鲜度审查**: audit 会先执行 `Profile Freshness Check`,反向核对 Profile 是否仍匹配当前包版本、目录资产、脚本、发布状态、宿主能力和任务现实
4949
- **项目工程泄漏审查**: 项目工程 / 代码质量审查执行 `PE-12 资源生命周期与泄漏风险`,必须检查内存泄露、资源泄漏、监听器/定时器/连接/流未释放、缓存无界增长和组件卸载清理缺失
5050
- **泄漏风险稳定性压测**: 写测试用例或回归验证时先执行 `LeakRiskStabilityPressureTest` 条件判定;命中长运行、高并发、缓存/连接/监听器/定时器/流/socket/worker/订阅/组件生命周期或 `PE-12` 风险时,TestRoute 纳入场景/负载/稳定性压测并记录基线、冷却后回落和资源指标前后对比;低风险任务写 `N/A + skipReason`
51+
- **前端体验质量门禁**: 前端页面、组件、控制台、官网、文档站、可视化工具或游戏任务执行 `FrontendExperienceQualityGate` 条件判定,覆盖设计来源、UI 还原度、风格主题、响应式状态、视觉验证、用户流、交互反馈、输入方式/可访问性、错误恢复和动效转场;命中时 TestRoute 纳入 Browser/截图、Playwright/E2E 或人工复核证据
5152
- **复审覆盖增量**: audit / review / ECR 的连续零发现必须附 `ReviewCoverageDelta`(`ReviewedSet` / `UnreviewedRelatedSet` / `NewlyReadThisRound` / `RepeatReadReason` / `NoNewSurfaceReason`),优先阅读此前未审查但相关联的代码、配置、测试、文档、部署副本和消费者链;无新增覆盖且无证据化理由时,不计入有效零发现
5253
- **规范治理 Intake**: 所有模式下每条用户消息在合理性评估后都会额外检查是否命中可泛化改进;命中时主动写入 `data/process-improvements.md`(优化清单,PI),必要时联动 `data/pending-fixes.md`(PF),并显式回执 `PI/PF`
5354
- **Backlog 真相复核与状态回写**: 从 `data/*.md` open/partial 项组织新需求或新批次前,先按 `pure-open / residual-tail / already-fixed / misclassified` 分类;实施后再执行台账状态回写闭环,避免“源码已修但 backlog 仍旧 open”
5455
- **官方文档证据前置**: 新增或升级依赖、框架、SDK、平台 API、外部模块前,CP2 会要求 `OfficialDocsEvidence`,记录官方文档来源、关键用法、限制与兼容性,避免凭经验猜 API
5556
- **通用工程守门**: Node.js 项目默认不低于 `>=18`;需求/问题定义前置平台工程判断,并记录 `ImplementationComplexityLevel`,开发程度分为 `简单够用 / 中等 / 企业级`,用户未要求复杂化或需求不详细时默认 `简单够用`;依赖/兼容任务拆分业务源码平滑性与依赖层落地条件;包/库/adapter/CLI 同查代码层与包工程层;JS/Node 必要注释使用标准 JSDoc;简单 service 不重复 route/model/schema 已承担的校验
56-
- **跨项目经验吸纳守门**: 字段/本地化/状态新增前执行 `ExistingDomainContractAudit`,业务策略常量执行 `ConfigOwnershipMatrix`,接口文档合同执行 `ApiDocVerificationSync`,数据迁移执行 `DataMutationPlan`,值得吸纳建议执行 `AbsorptionDecision`,完整首版执行 `FullV1ScopeGuard`,启动优化执行 `StartupPhaseTrace`
57+
- **跨项目经验吸纳守门**: 字段/本地化/状态新增前执行 `ExistingDomainContractAudit`,业务策略常量执行 `ConfigOwnershipMatrix`,接口文档合同执行 `ApiDocVerificationSync`,数据迁移执行 `DataMutationPlan`,值得吸纳建议执行 `AbsorptionDecision`,完整首版执行 `FullV1ScopeGuard`,启动优化执行 `StartupPhaseTrace`;新增吸纳 `CodeTruthRequirementGate`、`ManualReviewEvidenceRetention`、`DocumentationTranslationParityGuard`、`FormalDocsDevCodexBoundary`、`LLMPromptContractTriage`、`VerificationScopeBudgetGate`、`LiveVerificationExecutionObligation` 与 `AdapterBenchmarkAttribution`
5758
- **验证卫生与包边界**: release / pack / benchmark / codegen 任务中,package boundary check 必须在构建完成后单独串行执行;消费者验证异常先查 package.json、lockfile、node_modules 与 `npm ls <关键依赖>`,收尾前清理无关 dirty 文件和验证残留
5859
- **ProfileImpactCheck**: dev/fix 改动项目技术栈、目录、脚本、测试/发布路线、分发面、配置或长期连接时,会主动判定是否需要更新 Profile;无需更新时也要写明跳过理由
5960
- **敏感信息与硬编码策略**: 默认允许敏感信息、明文连接信息和硬编码出现在用户要求的代码、脚本、配置、文档、测试或报告中;只有用户 / 项目明确禁止时才脱敏、占位或改用 env、`secretRef`、secret manager、`config.local.json`

‎RULES.md‎

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

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

‎changelogs/releases/v1.11.18.md‎

Lines changed: 41 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,41 @@
1+
# v1.11.18 — 前端体验质量门禁与跨项目吸纳守门收口
2+
3+
> 发布日期:2026-06-11
4+
5+
## 变更摘要
6+
7+
- 新增 `FrontendExperienceQualityGate`:前端页面、组件、控制台、官网、文档站、可视化工具或游戏任务,必须按项目现实判定 UI / 交互体验质量门禁。
8+
- UI 视觉组覆盖 `FrontendDesignSourceGate`、`UIFidelityGate`、`StyleThemeConsistencyGate`、`ResponsiveStateCoverageGate` 与 `VisualVerificationGate`。
9+
- UX 交互组覆盖 `InteractionFlowGate`、`InteractionFeedbackGate`、`InputModalityAccessibilityGate`、`ErrorPreventionRecoveryGate` 与 `MotionTransitionUsabilityGate`。
10+
- 新增 `CrossProjectLearnedGuards`,吸纳 `data/` 目录中经复核值得沉淀的八项守门:`CodeTruthRequirementGate`、`ManualReviewEvidenceRetention`、`DocumentationTranslationParityGuard`、`FormalDocsDevCodexBoundary`、`LLMPromptContractTriage`、`VerificationScopeBudgetGate`、`LiveVerificationExecutionObligation`、`AdapterBenchmarkAttribution`。
11+
- 同步 dev/fix/audit/test Skill、CP1/CP2/CP3 模板、开发/修复/审查/场景测试报告模板、README、website guide、活动版本 P1 需求页、Rspress sidebar 与部署副本。
12+
- 新增 `V61` validate 探针和 `test-spec-governance` targeted probe,防止前端体验门禁和跨项目吸纳守门在后续规范源、模板、文档站或部署副本中漂移。
13+
14+
## Fixed
15+
16+
- 修复前端任务只检查功能正确性、未要求 UI 还原度、风格主题、响应式状态和交互体验证据的规范缺口。
17+
- 修复人工复核、视觉检查、手工冒烟或外部页面观察可被一句“人工检查通过”替代的问题。
18+
- 修复“已接入 / 已支持 / 已验证 / 可运行 / 可发布”类声明缺少代码真相源和真实执行证据的风险。
19+
- 修复多语言文档、正式文档、prompt/Hook/MCP 契约、验证范围预算和 adapter/provider benchmark 归因缺少统一触发口径的问题。
20+
- 修复 GitHub Packages 发布链中 `npm publish --dry-run` / `prepublishOnly` 继承 GitHub Packages registry 后导致 `npm audit` 命中非审计端点的问题;`test:audit` 现在显式使用 npm 官方审计 registry。
21+
22+
## Release Gate Evidence
23+
24+
- `OfficialDocsEvidence`: N/A。本轮不新增/升级第三方依赖、框架、SDK 或外部平台 API。
25+
- `ProfileImpactCheck`: updated。active Profile 已同步 v1.11.18 当前发布状态与前端体验/跨项目吸纳守门作为当前开发重点。
26+
- `ConceptSyncMap`: sourceOfTruth 为 `instructions.md`、`instructions/10-dev.instructions.md`、`instructions/11-fix.instructions.md`、`instructions/12-audit.instructions.md`、`skills/test-router/SKILL.md`、`skills/dev-testing/SKILL.md`、`skills/dev-default/SKILL.md`、`skills/dev-plan-review/SKILL.md`、`scripts/lib/validate-governance-tail.js`;currentConsumers 已同步 README、website guide、活动版本 requirements、Rspress sidebar、prompts、report templates、deployment copies 与 targeted tests。
27+
- `ReleaseRecovery`: v1.11.18 是新 patch;若 tag 或 registry 已存在则停止当前版本并改用后续 patch,不覆盖远端同版本。
28+
- `ServiceLifecycleCleanup`: N/A。本轮未启动长运行服务。
29+
30+
## Validation
31+
32+
- `node scripts/validate.js`
33+
- `node scripts/test-spec-governance.js`
34+
- `npm test`
35+
- `npm run test:audit`
36+
- `git diff --check`
37+
- `npm pack --dry-run`
38+
- `npm publish --dry-run`
39+
- pack install smoke
40+
- remote main/tag verification
41+
- GitHub Packages registry verification

‎instructions.md‎

Lines changed: 20 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -272,6 +272,26 @@ dev/fix 修改完成前必须判定是否影响 Profile。命中以下任一触
272272
- 纯计算函数、静态文档、一次性脚本、无状态转换且无长生命周期资源的变更可写 `N/A + skipReason`;不得为了形式满足而引入新压测依赖或扩大低风险测试范围。
273273
- 若泄漏稳定性压测需要 AI 启动服务、压测 target 或监控脚本,必须同时执行 `ServiceLifecycleCleanup`。
274274

275+
### FrontendExperienceQualityGate(前端 UI / 交互体验质量门禁)
276+
277+
- 涉及前端页面、组件、控制台、官网、文档站、可视化工具、游戏或其他用户可见 UI / 交互时,CP1/CP2/TestRoute 必须按项目现实判定是否触发 `FrontendExperienceQualityGate`;该规则是条件门禁,不适用于纯后端、纯 CLI、纯文档或无界面任务,未触发时写 `N/A + skipReason`。
278+
- UI 视觉组:`FrontendDesignSourceGate` 要求确认设计来源(设计稿/截图/Figma/既有页面/设计系统/品牌主题/领域推导);`UIFidelityGate` 要求有参考时尽量还原布局、间距、层级、字体、颜色、状态、图标和关键资产,偏离必须说明;`StyleThemeConsistencyGate` 要求沿用项目既有设计系统、主题 token、颜色语义、组件库和图标体系;`ResponsiveStateCoverageGate` 要求覆盖桌面/移动、关键断点、主题模式、loading/empty/error/disabled/hover/focus 等状态;`VisualVerificationGate` 要求 UI 变更后用 Browser/Playwright/截图或项目等价方式留证,无法运行时记录阻塞与降级证据。
279+
- UX 交互组:`InteractionFlowGate` 要求识别核心用户流、入口/出口、主次行动、导航、返回、取消、撤销和任务完成路径;`InteractionFeedbackGate` 要求关键控件、异步行为和结果状态具备即时、可感知且不过度打扰的反馈;`InputModalityAccessibilityGate` 要求关键交互按场景覆盖键盘、鼠标、触摸、焦点可见、目标尺寸、拖拽/手势替代;`ErrorPreventionRecoveryGate` 要求高成本、破坏性或易误操作路径具备预防、确认、撤销/恢复和可理解错误提示;`MotionTransitionUsabilityGate` 要求动效和转场用于解释状态变化、空间关系和连续性,保持克制、稳定并尊重减弱动态设置。
280+
- 前端体验验证应按风险选择项目既有 lint/typecheck/test、Browser/截图、Playwright/E2E 或人工复核证据;不得为了形式满足而引入新 UI 库、设计系统、视觉 diff 平台或把所有前端任务升级为重可用性研究。
281+
- 若前端体验任务同时涉及组件生命周期、监听器、订阅、worker、定时器、缓存或长运行可视化状态,仍须并行执行 `LeakRiskStabilityPressureTest` 判定。
282+
283+
### CrossProjectLearnedGuards(跨项目已吸纳守门)
284+
285+
- 来自 `data/*.md`、复审、发布验证、同类项目实践或用户纠偏的可泛化规范被吸纳后,必须落入可执行门禁而不是只写成建议;CP1/CP2/TestRoute/审查报告需按项目现实判定触发,未触发时写 `N/A + skipReason`。
286+
- `CodeTruthRequirementGate`:需求、方案或报告描述“已实现 / 已接入 / 未接入 / 已支持”前,必须先核对代码真相源、消费者入口和运行证据,禁止仅凭历史报告、目录名或记忆判断。
287+
- `ManualReviewEvidenceRetention`:人工复核、视觉检查、手工冒烟、外部页面观察或无法自动化的验证必须保留复核人/时间/范围/输入/观察结果/截图或日志位置;不得只写“人工检查通过”。
288+
- `DocumentationTranslationParityGuard`:多语言文档、翻译页、README/website 同步页或中英文双入口变更时,必须核对信息等价、版本号、链接、示例、术语和当前消费者顺序;无法同步时写明历史镜像或降级理由。
289+
- `FormalDocsDevCodexBoundary`:正式用户文档、官网、README、规范页与 DevCodex 运行时报告/台账/临时分析必须区分边界;不得把内部流程噪声、待办台账或一次性报告口吻泄漏到正式文档,也不得把正式需求入口只写在运行时台账。
290+
- `LLMPromptContractTriage`:变更 prompt、Agent 指令、Hook 输出、MCP 工具描述或面向 LLM 的契约时,必须区分人读说明、模型指令、结构化输出字段和宿主能力边界;字段级契约、示例、失败降级和验证探针需同步。
291+
- `VerificationScopeBudgetGate`:验证路线必须与风险和变更面匹配;高风险、控制面、发布、资源生命周期或前端体验不能只跑轻量检查,低风险纯文档/纯计算也不得为形式引入重压测、E2E 或外部依赖。
292+
- `LiveVerificationExecutionObligation`:声明“已验证 / 可运行 / 可点击 / 已发布 / 已安装”前必须真实执行对应命令、页面、接口、pack/install、registry/tag 查询或项目等价验证;无法执行时只能写阻塞/降级证据,不能用预期代替结果。
293+
- `AdapterBenchmarkAttribution`:adapter、provider、connector、SDK 或性能优化 benchmark 必须写清基线、环境、版本、负载、归因边界和不可比较因素;不得把框架、网络、缓存预热、依赖树或测试环境差异误归因给业务代码。
294+
275295
### 台账落点与关闭证据
276296

277297
- `data/*.md` 是运行时逻辑台账路径,实际写入必须按当前 active-root 映射:旧布局写 `<项目根>/.devcodex/data/`,workspace-namespace 单项目写 `<工作区根>/.devcodex/<project>/data/`,全工作区写 `<工作区根>/.devcodex/workspace/data/`。

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

0 commit comments

Comments
 (0)