@@ -45,7 +45,7 @@ S02 的核心秘密禁止项不可豁免;“私有仓库”“本地使用”
4545
4646---
4747
48- ## 强制约束(C01~ C19 )
48+ ## 强制约束(C01~ C21 )
4949
5050| # | 约束 | 规则 |
5151| :-:| ------| ------|
@@ -68,6 +68,8 @@ S02 的核心秘密禁止项不可豁免;“私有仓库”“本地使用”
6868| C17 | 过程改进记录 | 用户建议的策略经确认更优,或揭示规范未定义/不完整且可泛化时,必须走 Improvement Intake:将策略写入 ` data/process-improvements.md ` (优化清单,PI);若同时暴露规范缺口,再联动 ` data/pending-fixes.md ` (PF)。不得询问是否记录;所有模式命中后都必须显式回执已记录的 ` PI-xxx / PF-xxx ` |
6969| C18 | 全模式入口检查不可跳过 | 同 S07 |
7070| C19 | 确认后前置复审 | 每次用户明确确认后、进入下一阶段前,必须先对当前已确认产物做 1 轮轻量前置复审,并显式输出结果;控制面 / 多文件联动 / 真相源同步 / 模板-示例-校验链场景必须追加交叉验证;若发现阻断性问题,先修正并告知用户,再重新确认;无阻断问题方可推进 |
71+ | C20 | 官方文档证据前置 | 新增/升级第三方依赖、框架、SDK、平台 API 或外部模块前,必须先读取官方使用文档/官方参考资料并形成 ` OfficialDocsEvidence ` ;缺失证据时不得进入编码 |
72+ | C21 | Profile 联动判定 | dev/fix 修改项目技术栈、目录边界、脚本、测试/发布路线、分发面、配置项、长期连接或本地 overlay schema 时,必须执行 ` ProfileImpactCheck ` :更新 Profile 或写明跳过理由 |
7173
7274---
7375
@@ -209,6 +211,29 @@ S02 的核心秘密禁止项不可豁免;“私有仓库”“本地使用”
209211- 非 ` pure-open ` 项不得原样沿用旧 open 统计;必须先回写台账、修正本轮范围和 CP1/CP2/CP3 口径,再继续推进。
210212- 用户面至少要显式说明:候选编号、复核分类、是否缩减本轮范围。
211213
214+ ### OfficialDocsEvidence(官方文档证据)
215+
216+ - 新增/升级第三方依赖、引入框架、SDK、平台 API、外部模块或需要依据外部平台能力设计方案时,CP2 前必须读取官方使用文档或官方参考资料。
217+ - CP2 / 技术方案必须记录 ` OfficialDocsEvidence ` :官方文档来源、版本或发布日期、关键用法、限制条件、兼容性 / 弃用 / Breaking Change 判断,以及本方案采用的具体 API / 配置依据。
218+ - 若官方文档不可用,按顺序降级到官方源码 / 官方仓库说明、项目内已确认文档、社区资料;降级原因和风险必须写入方案与报告。
219+ - 本地纯实现问题、仓库内现有能力可闭环验证且不新增/升级外部依赖的任务,可标 ` OfficialDocsEvidence: N/A ` ,但必须写明 N/A 理由。
220+ - ` dev-plan-review ` 的 PR-2 必须检查该证据;触发场景缺失 ` OfficialDocsEvidence ` 时视为阻断,回 CP2 修订。
221+
222+ ### ProfileImpactCheck(Profile 联动判定)
223+
224+ dev/fix 修改完成前必须判定是否影响 Profile。命中以下任一触发项时,必须更新对应 Profile 文件,或在 CP2 / CP3 / ECR / 报告中写明跳过理由:
225+
226+ | 触发项 | Profile 同步目标 |
227+ | --------| ------------------|
228+ | 技术栈、框架、SDK、依赖管理器变化 | ` 01-项目信息.md ` 技术栈 / 依赖说明 |
229+ | 目录结构、模块边界、分发面、宿主能力变化 | ` 02-架构约束.md ` 目录与边界 |
230+ | 代码风格、脚本、测试、构建、发布命令变化 | ` 03-代码风格.md ` 或 ` 01-项目信息.md ` 验证路线 |
231+ | 共享配置、环境变量、本地长期连接、` config.local.json ` schema 或 ` extensions.<namespace> ` 变化 | Profile README / ` 01-项目信息.md ` / ` config.local.json ` 说明 |
232+ | 当前阶段、活跃版本、任务现实、发布状态变化 | ` 01-项目信息.md ` 当前开发重点 |
233+
234+ - ` document-sync ` 必须把 ` ProfileImpactCheck ` 作为 dev/fix 后置检查项,不得只依赖 audit 的 Profile Freshness 事后发现。
235+ - 若判断无需更新 Profile,必须留下 ` skipReason ` ,例如“仅修正文案 typo,不影响技术栈/目录/配置/验证路线”。
236+
212237### 台账落点与关闭证据
213238
214239- ` data/*.md ` 是运行时逻辑台账路径,实际写入必须按当前 active-root 映射:旧布局写 ` <项目根>/.devcodex/data/ ` ,workspace-namespace 单项目写 ` <工作区根>/.devcodex/<project>/data/ ` ,全工作区写 ` <工作区根>/.devcodex/workspace/data/ ` 。
@@ -265,7 +290,7 @@ CP1(需求确认)→ CP2(方案确认)→ [plan-review] → CP3(实施
265290```
266291
267292- ** CP1** :输出完整需求理解(目标/边界/风险)→ 等待用户确认
268- - ** CP2** :输出技术方案(架构/文件清单/依赖)→ 等待用户确认
293+ - ** CP2** :输出技术方案(架构/文件清单/依赖);新增/升级依赖、框架、SDK 或平台 API 时必须附 ` OfficialDocsEvidence ` ,涉及项目事实变化时必须附 ` ProfileImpactCheck ` → 等待用户确认
269294- ** plan-review** :评估计划可行性(CP2 后、CP3 前)
270295- ** CP3** :条件触发。default/refactor/database/optimization/scenario-test 必须执行;docs/init/plan-review 按子类型规则豁免,并记录 ` CP3: N/A(<子类型> 子类型豁免) ` 。
271296- 若执行过程中新增范围触发 CP3 条件(例如最初判断 <5 文件但实际扩展到 ≥5 文件,或新增高风险操作/控制面联动),必须暂停执行,回补或重开 CP3 后再继续。
@@ -325,7 +350,7 @@ CP1(问题确认)→ CP2(方案确认)→ [impact-review] → 执行 →
325350```
326351
327352- ** CP1** :输出问题分析(根因 + 影响范围)→ 等待确认
328- - ** CP2** :输出修复方案 → 等待确认
353+ - ** CP2** :输出修复方案;若修复涉及依赖/框架/SDK/平台 API 变更必须附 ` OfficialDocsEvidence ` ,涉及项目事实变化时必须附 ` ProfileImpactCheck ` → 等待确认
329354- ** CP3** :≥5 文件变更 或 含高风险操作时必须
330355- 若执行过程中新增范围触发 CP3 条件(例如实际修改文件数扩展到 ≥5,或修复途中引入高风险/控制面联动),必须暂停执行,先补做 CP3,再继续修复。
331356- ** ECR** :执行完成并完成修复三步扫描后、宣告完成前必须执行 ECR 执行闭环复审,覆盖 CP1/CP2/CP3、报告、daily tasks、SUMMARY、diff/commit、测试/扫描证据与 dirty 边界。
0 commit comments