Skip to content

Commit 1eae34e

Browse files
committed
feat(review): align C19 with R0-R4 grades and ReviewGradeCard
Map post-confirmation and ECR strength to light/standard/full/release (R1-R4), require ReviewGradeCard, and add ControlPlaneAdviceInventoryGate so control-plane advice inventories source-root before recommending designs. Sync report prompts, gate-registry evidence, V78 needles, README/website anchors, and close residual F-01/F-02 consumer gaps.
1 parent b3af597 commit 1eae34e

23 files changed

Lines changed: 112 additions & 42 deletions

File tree

‎README.md‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -69,7 +69,7 @@ DevCodex 通过 npm 全局安装把 Copilot、Claude Code、Codex、Gemini CLI
6969
- **强主张证据新鲜度能力**: `evidence-freshness` gateGroup 与 `scripts/lib/evidence-freshness-receipt.js` 负责报告、分析、审查、复审清单和用户可见完成检查中的强主张证据复用;`ArtifactAnchorV1`、`ArtifactAnchorProjectionV1` 与 `FinalValidationSummaryV1` 可作为证据依赖,SUMMARY、历史报告和外部审查原文只能作 navigation hint。
7070
- **操作、代码事实与唯一推荐**: 面向用户或维护者的操作说明使用 `OperationExplanationContractV1`;重要方案/报告使用 `CodeTruthEvidenceMatrixGate` 和 `SolutionFitAgainstRepoGate` 绑定 repo path、symbol、currentBehavior、negativeProbe、gap、reusePoint、consumer、rollback 与 statusQuoCost;收敛后由 `UniqueRecommendationBeforeConfirmGate` / `NoPreferenceMenuAfterConvergenceGate` 保证只有一个推荐方案或明确组合。
7171
- **专家 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 证据,避免“专家视角”只停留在泛泛口号。
72-
- **复审清单能力**: `review-checklist` 负责正式复审、ECR、发布前复审、多轮收敛和外部 finding 批次的清单创建、范围冻结、逐项证据执行、遗漏逃逸分析、状态新鲜度和收敛关闭;`PostConfirmationReviewScopeGate` 要求 CP 确认后按风险选择轻量或全面复审;`ReviewEscapeRecordGate` 要求发现遗漏时先在清单写入 `whyMissed / prevention / checklistPatch / rerunEvidence`,再补清单和重跑验证;`ChecklistStateMaterializationGate` 在 clean/closed 前核对 header、items、round、ledger、progress、closure 六区块一致快照
72+
- **复审清单能力**: `review-checklist` 负责正式复审、ECR、发布前复审、多轮收敛和外部 finding 批次的清单创建、范围冻结、逐项证据执行、遗漏逃逸分析、状态新鲜度和收敛关闭;`PostConfirmationReviewScopeGate` 要求 CP 确认后输出 **ReviewGradeCard**,按 C19↔R 映射选择强度(**轻量=R1** 须 skipReason、**标准=R2** 默认、**全面=R3** 冻结清单、**发布安全=R4**);ECR 默认 R2,禁止「永远轻量」;`ReviewEscapeRecordGate` 要求发现遗漏时先在清单写入 `whyMissed / prevention / checklistPatch / rerunEvidence`,再补清单和重跑验证;`ChecklistStateMaterializationGate` 在 clean/closed 前核对 header、items、round、ledger、progress、closure 六区块一致快照
7373
- **范围、契约与阶段语义守门**: `DevelopmentDriftGate`、`CurrentBatchScopeDiffProbe` 与 `NewValidationConsumerRebindProbe` 约束当前批次及新增 CI/validator/deploy 消费者;`ContractVariantIsolationMutationGate` 以 sibling-field injection 和 completion-evidence deletion 防止合同假绿;`PhaseDeliverySemanticGate` 区分 planning coverage 与 source delivery;文档 IA 仍由 `ChinesePrimaryExpressionGate`、页面角色与 sidebar 语义探针约束。上述剩余吸纳控制由 V96 正负探针守门
7474
- **基座准入与复杂度预算**: 新增或晋级规范、Skill、Prompt、流程、验证器或部署消费者先走 `BaseImpactAssessmentV1`、`ComplexityDeltaBudgetV1` 与 `UnaffectedIntentRegression`;必须证明真实消费者、defaultPathDelta、fallback/rollback、`replacementOrRetirementCredit` 和退役/删除条件,避免后续能力继续侵入稳定基座或让普通任务默认变重。V96 覆盖 base-neutral / base-compatible / base-changing 负样本。
7575
- **Skill 缺口与生命周期能力**: `skill-gap-analysis` 负责 `ProjectArtifactScaleRoutingGate`,`skill-lifecycle-governance` 负责 portfolio 生命周期;`distributed-systems-architecture`、`performance-engineering`、`privacy-compliance-architecture`、`ai-evaluation-engineering` 为新增专业 Owner,V85/V91 守门。
@@ -566,7 +566,7 @@ README / 用户使用文档当前补充四类专项 Skill:`user-manual-authori
566566

567567
产品策略、开发者体验、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 证据,避免把专业判断只写成笼统的“从专家角度考虑”。
568568

569-
正式复审、ECR、发布前复审、多轮收敛和外部 finding 批次由 `review-checklist` 管理清单文件、冻结范围、逐项证据、遗漏逃逸分析、状态新鲜度和关闭结论;CP 确认后由 `PostConfirmationReviewScopeGate` 判定轻量或全面复审。报告中的 `ReviewChecklistCompletenessGate` / `EvidenceExecutionGate` / `ReviewEscapeRecordGate` 必须引用该清单或说明 N/A。复审发现新遗漏时,先写 escape record 的 `escapedItem / whyMissed / prevention / checklistPatch / rerunEvidence`,再补清单、重跑验证并判断是否写 VL/PF/GAP。
569+
正式复审、ECR、发布前复审、多轮收敛和外部 finding 批次由 `review-checklist` 管理清单文件、冻结范围、逐项证据、遗漏逃逸分析、状态新鲜度和关闭结论;CP 确认后由 `PostConfirmationReviewScopeGate` 输出 ReviewGradeCard,并按 **轻量=R1 / 标准=R2 / 全面=R3 / 发布安全=R4** 定级(默认 R2;高风险升 R3+清单)。报告中的 `ReviewChecklistCompletenessGate` / `EvidenceExecutionGate` / `ReviewEscapeRecordGate` 必须引用该清单或说明 N/A。复审发现新遗漏时,先写 escape record 的 `escapedItem / whyMissed / prevention / checklistPatch / rerunEvidence`,再补清单、重跑验证并判断是否写 VL/PF/GAP。控制面/分级类**设计建议**须先做 source-root ExistingCapabilityInventory(`ControlPlaneAdviceInventoryGate`),不得仅凭对话理想矩阵定论。
570570

571571
自我进化、自动吸纳、模型辅助规范优化、自动补 Skill / Prompt / Probe 和自动治理候选由 `evolution-governance` 管理控制面;任何模型生成的规则或发版建议必须先作为候选记录 `EvolutionRun`,再由人工确认、`LayeredAbsorptionGate`、验证探针、部署副本同步和 release-verification 决定是否进入 active 规范。
572572

‎changelogs/unreleased.md‎

Lines changed: 10 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -109,6 +109,16 @@ WorkspaceDataAbsorptionScopeGate · DocsSiteVisualAcceptanceGate · OmissionOnly
109109
- 支持 `existing-control-restored / new-control-provisional / no-new-control / emergency-active`,高风险或 repeat escape 强制 full;当前事件重跑不得晋级 prevention,控制必须具备 prospective evidence 与 rollback/sunset。
110110
- fix/security/execution/review/TestRoute/report/Prompt/registry 消费者与 V94、独立正负向验证节点已同步;未新增重复 Prevention Skill。
111111

112+
### 复审等级 C19↔R 现状对齐(2026-07-26)
113+
114+
- 对齐 C19 人读档与 `selectReviewClass`(R0~R4):**轻量=R1 / 标准=R2 / 全面=R3 / 发布安全=R4**;确认后与 ECR 须输出 **ReviewGradeCard**。
115+
- 消除 `10-dev` / `11-fix`「确认后前置轻量复审」「ECR 永远 1 轮轻量」漂移;ECR 默认 R2,高风险升 R3+清单。
116+
- 同步 `cp-gate`、`review-checklist`、`instructions.md`、`01-common`、host-projections、`dev-default`、V78 needles。
117+
- 关联:VL-085 · VL-086 · PF-181 · PI-176 · 需求 `20260726-复审等级现状对齐`;lifecycle 接线 R 档仍为后续批次。
118+
- Batch B:`ControlPlaneAdviceInventoryGate` 写入 `analyze-default` / `expert-output-quality` / `13-analyze` 索引(建议路径须 source-root inventory)。
119+
- Batch C:README / website guide 锚点同步;部署用 `global-adapters apply` 刷新 user-global Skill。
120+
- 残留 F-01/F-02:`gate-registry` post-confirmation `requiredEvidence` 含 ReviewGradeCard/c19Label/reviewClass;`report` / `fix-default` / report-dev|fix|optimization|scenario-test prompts 写入 ReviewGradeCard 字段。
121+
112122
### 复审证据与状态单一投影(2026-07-19)
113123

114124
- 新增 `ReviewExecutionPlanV1`、`ReviewEvidenceReceiptV1`、`ReviewStateSnapshotV1`、`EvidenceSaturationResultV1` 与 `StageTimingV1` 确定性运行时。

‎host-projections/AGENTS.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -33,7 +33,7 @@
3333
- C16:规模判断与批量分批:分析、审查、扫描或批量操作前必须先识别唯一项目/root,并执行 `ProjectArtifactScaleRoutingGate` 的 bounded inventory,按文件数、可解析字节、最大文件、目录集中度、派生产物比例和消费者扩散面决定 `single-pass / batched / sampled+deep-read / blocked`;≥10 文件 mutation 或非 small corpus 必须分批并写 checkpoint,禁止先无界扫描超时后再补分批
3434
- C17:过程改进记录:每条非空用户消息先登记中性治理候选,完成合理性评估和上下文归因后再按语义形成 `GovernanceIntakeDecision`;关键词不得作为权威触发/分类依据。用户建议的策略经确认更优,或揭示规范未定义/不完整且可泛化时,必须走 Improvement Intake:将策略写入 `data/process-improvements.md`(优化清单,PI);若同时暴露规范缺口,再联动 `data/pending-fixes.md`(PF)。复合意图逐项 all-of 验证;不得询问是否记录;所有模式命中后都必须显式回执已记录的 `PI-xxx / PF-xxx`
3535
- C18:全模式入口检查不可跳过:同 S07
36-
- C19:确认后前置复审:每次用户明确确认后、进入下一阶段前,必须执行 `PostConfirmationReviewScopeGate`:低风险单文件或纯文案可做轻量复审;高风险、多模块、公共 API/配置、安全能力、package/adapter、文档消费者、控制面或多真相源同步任务必须升级为冻结清单驱动的全面复审;命中控制面 / 多文件联动 / 真相源同步 / 模板-示例-校验链场景必须追加交叉验证,并显式输出结果;若发现阻断性问题,先修正并告知用户,再重新确认;无阻断问题方可推进
36+
- C19:确认后前置复审:每次用户明确确认后、进入下一阶段前,必须执行 `PostConfirmationReviewScopeGate` 并输出 ReviewGradeCard;映射轻量=R1(须 skipReason)、标准=R2(默认)、全面=R3(高风险+冻结清单)、发布安全=R4;命中控制面 / 多文件联动 / 真相源同步 / 模板-示例-校验链须追加交叉验证;阻断项先修正并重确认;ECR 默认 R2 禁止永远轻量
3737
- C20:官方文档证据前置:新增/升级第三方依赖、框架、SDK、平台 API 或外部模块前,必须先读取官方使用文档/官方参考资料并形成 `OfficialDocsEvidence`;缺失证据时不得进入编码
3838
- C21:Profile 联动判定:dev/fix 修改项目技术栈、目录边界、脚本、测试/发布路线、分发面、配置项、长期连接或本地 overlay schema 时,必须执行 `ProfileImpactCheck`:更新 Profile 或写明跳过理由
3939
- C22:AI 自启动服务清理(ServiceLifecycleCleanup):AI 为验证启动 dev server、文档站、本地 API/mock、数据库代理、SSH 隧道、Playwright/Cypress server、压测 target 等长运行进程时,必须记录启动命令、cwd、PID/job、端口/URL;验证完成、失败或中断收尾前主动停止仅由 AI 启动的服务并核验端口释放;不得杀用户既有进程;用户明确要求保留时记录保留原因、PID/端口和关闭方式

‎host-projections/copilot-instructions.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -33,7 +33,7 @@
3333
- C16:规模判断与批量分批:分析、审查、扫描或批量操作前必须先识别唯一项目/root,并执行 `ProjectArtifactScaleRoutingGate` 的 bounded inventory,按文件数、可解析字节、最大文件、目录集中度、派生产物比例和消费者扩散面决定 `single-pass / batched / sampled+deep-read / blocked`;≥10 文件 mutation 或非 small corpus 必须分批并写 checkpoint,禁止先无界扫描超时后再补分批
3434
- C17:过程改进记录:每条非空用户消息先登记中性治理候选,完成合理性评估和上下文归因后再按语义形成 `GovernanceIntakeDecision`;关键词不得作为权威触发/分类依据。用户建议的策略经确认更优,或揭示规范未定义/不完整且可泛化时,必须走 Improvement Intake:将策略写入 `data/process-improvements.md`(优化清单,PI);若同时暴露规范缺口,再联动 `data/pending-fixes.md`(PF)。复合意图逐项 all-of 验证;不得询问是否记录;所有模式命中后都必须显式回执已记录的 `PI-xxx / PF-xxx`
3535
- C18:全模式入口检查不可跳过:同 S07
36-
- C19:确认后前置复审:每次用户明确确认后、进入下一阶段前,必须执行 `PostConfirmationReviewScopeGate`:低风险单文件或纯文案可做轻量复审;高风险、多模块、公共 API/配置、安全能力、package/adapter、文档消费者、控制面或多真相源同步任务必须升级为冻结清单驱动的全面复审;命中控制面 / 多文件联动 / 真相源同步 / 模板-示例-校验链场景必须追加交叉验证,并显式输出结果;若发现阻断性问题,先修正并告知用户,再重新确认;无阻断问题方可推进
36+
- C19:确认后前置复审:每次用户明确确认后、进入下一阶段前,必须执行 `PostConfirmationReviewScopeGate` 并输出 ReviewGradeCard;映射轻量=R1(须 skipReason)、标准=R2(默认)、全面=R3(高风险+冻结清单)、发布安全=R4;命中控制面 / 多文件联动 / 真相源同步 / 模板-示例-校验链须追加交叉验证;阻断项先修正并重确认;ECR 默认 R2 禁止永远轻量
3737
- C20:官方文档证据前置:新增/升级第三方依赖、框架、SDK、平台 API 或外部模块前,必须先读取官方使用文档/官方参考资料并形成 `OfficialDocsEvidence`;缺失证据时不得进入编码
3838
- C21:Profile 联动判定:dev/fix 修改项目技术栈、目录边界、脚本、测试/发布路线、分发面、配置项、长期连接或本地 overlay schema 时,必须执行 `ProfileImpactCheck`:更新 Profile 或写明跳过理由
3939
- C22:AI 自启动服务清理(ServiceLifecycleCleanup):AI 为验证启动 dev server、文档站、本地 API/mock、数据库代理、SSH 隧道、Playwright/Cypress server、压测 target 等长运行进程时,必须记录启动命令、cwd、PID/job、端口/URL;验证完成、失败或中断收尾前主动停止仅由 AI 启动的服务并核验端口释放;不得杀用户既有进程;用户明确要求保留时记录保留原因、PID/端口和关闭方式

0 commit comments

Comments
 (0)