@@ -218,6 +218,8 @@ S02 的核心秘密禁止项不可豁免;“私有仓库”“本地使用”
218218- 若官方文档不可用,按顺序降级到官方源码 / 官方仓库说明、项目内已确认文档、社区资料;降级原因和风险必须写入方案与报告。
219219- 本地纯实现问题、仓库内现有能力可闭环验证且不新增/升级外部依赖的任务,可标 ` OfficialDocsEvidence: N/A ` ,但必须写明 N/A 理由。
220220- ` dev-plan-review ` 的 PR-2 必须检查该证据;触发场景缺失 ` OfficialDocsEvidence ` 时视为阻断,回 CP2 修订。
221+ - 依赖升级、框架升级、SDK 替换或平台 API 兼容性分析必须拆分 ` 业务源码平滑性 ` 与 ` 依赖层落地条件 ` ;用户关心“只升级依赖即可”时,追加 ` 纯依赖层零附加动作 ` 结论,不得把工程前提误报成业务源码阻断。
222+ - 根因位于内部共享库、中间件、SDK 或 adapter 抽象层时,CP2 前必须评估“修共享库 + 消费项目升级”是否优于单项目临时补丁。
221223
222224### ProfileImpactCheck(Profile 联动判定)
223225
@@ -300,6 +302,18 @@ CP1(需求确认)→ CP2(方案确认)→ [plan-review] → CP3(实施
300302
301303** 高风险操作** :DDL 变更 / ` .env ` /` package.json ` /CI 配置变更 / 文件删除 / 直接影响生产环境
302304
305+ ### 代码实现复杂度与通用工程守门
306+
307+ - CP2 技术方案必须给出最小实现与注释策略;实施默认采用满足验收项的最小实现,优先局部补丁和既有本地模式。
308+ - 禁止为“企业级”“可扩展”预设新增无真实消费者的 service / factory / adapter / manager、策略注册表、通用配置或预留扩展点。
309+ - 必要注释必须覆盖非显然业务规则、状态转换、不变量、兼容约束、安全边界、外部契约映射和反直觉权衡;JavaScript / Node.js 中命中必要注释的导出函数、核心业务函数、类、复杂对象契约、参数/返回/异常说明必须使用标准 JSDoc。
310+ - Node.js 项目的 ` engines.node ` 、CI matrix、Profile 与 README 运行时说明默认不得低于 ` >=18 ` ;支持更低版本时必须在 CP2 写明业务理由、风险和独立验证证据。
311+ - 包 / 库 / adapter / CLI 方案除代码实现层外,还必须检查 public API、public types、internal 工具、shared tests、benchmark、docs、scripts、dist/coverage 边界、package metadata 与未发布变更日志。
312+ - TypeScript 重构或迁移按公开契约与消费面逐步完善类型,不机械复制旧版本缺陷;跨模块业务契约、公开类型与配置类型优先集中到 types 契约层。
313+ - 三方 provider、connector、SDK 接入类 CP2 必须先区分业务功能接口与底层 provider adapter;面向前端或业务调用方时优先冻结业务功能契约,provider/model/operation 作为内部实现或配置维度。随后冻结字段级合同:provider metadata、内部 payload、上游 request 映射、标准化 result、错误 detail;首个 provider 只能验证统一 operation contract,不能反向定义公共命名和层次。
314+ - 简单业务 service 默认只做业务编排、外部能力调用和必要上游错误映射;不得重复 route validate、model/schema、数据导入或框架已承担的校验、归一化、配置兜底和二次治理。
315+ - README / 使用文档涉及性能表、语法/能力矩阵或模式优先级时,先给用户选择结论,再解释字段;同时写清支持形式、不支持形式和优先级示例。
316+
303317### CP 响应处理
304318
305319| 用户响应 | 处理 |
@@ -367,6 +381,13 @@ CP1(问题确认)→ CP2(方案确认)→ [impact-review] → 执行 →
3673812 . ** 数据联动扫描** — 上下游数据流是否受影响
3683823 . ** 零残留复核** — 确认无残留引用
369383
384+ ### 修复执行补充守门
385+
386+ - 依赖升级、兼容修复或批量适配类问题先记录问题清单与归因,再统一确认修复范围;用户明确授权即时修复或 auto 执行时可边发现边处理,但仍要回写问题清单和证据。
387+ - 根因位于内部共享库、中间件、SDK 或 adapter 抽象层时,优先评估“修共享库 + 消费项目升级”;若只做单项目补丁,修复方案必须说明共享库不改的理由。
388+ - JavaScript / Node.js 修复中命中必要注释的导出函数、核心业务函数、类、复杂对象契约、参数/返回/异常说明必须使用标准 JSDoc。
389+ - 简单业务 service 修复不得重复 route validate、model/schema、数据导入或框架已承担的校验、归一化和配置兜底。
390+
370391---
371392
372393## 分析工作流(analyze)
@@ -566,7 +587,7 @@ CP1(问题确认)→ CP2(方案确认)→ [impact-review] → 执行 →
566587
567588## 全自动模式豁免
568589
569- 当用户选择全自动执行时 :CP1/CP2/CP3 确认自动通过;S01/S02 核心秘密禁止项/S03~ S07/C01/C10/C18 不可豁免。S02 受控私有例外只能按上文模型执行,不属于绕过安全底线。
590+ 当用户选择 ` @devcodex-auto ` 或明确自然语言 auto 授权(如“进入 auto 模式执行”)时 :CP1/CP2/CP3 确认自动通过;模糊提及、询问 auto 规则或普通“继续”不等价于 auto 授权 ;S01/S02 核心秘密禁止项/S03~ S07/C01/C10/C18 不可豁免。S02 受控私有例外只能按上文模型执行,不属于绕过安全底线。
570591
571592---
572593
0 commit comments