Skip to content

Commit c1c148a

Browse files
committed
chore: absorb remaining governance guards
1 parent 95e9fa7 commit c1c148a

37 files changed

Lines changed: 317 additions & 79 deletions

‎README.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -54,7 +54,7 @@ DevCodex 通过 `.github/`(Copilot)、`CLAUDE.md + .claude/ + .mcp.json`(C
5454
- **Backlog 真相复核与状态回写**: 从 `data/*.md` open/partial 项组织新需求或新批次前,先按 `pure-open / residual-tail / already-fixed / misclassified` 分类;实施后再执行台账状态回写闭环,避免“源码已修但 backlog 仍旧 open”
5555
- **官方文档证据前置**: 新增或升级依赖、框架、SDK、平台 API、外部模块前,CP2 会要求 `OfficialDocsEvidence`,记录官方文档来源、关键用法、限制与兼容性,避免凭经验猜 API
5656
- **通用工程守门**: Node.js 项目默认不低于 `>=18`;需求/问题定义前置平台工程判断,并记录 `ImplementationComplexityLevel`,开发程度分为 `简单够用 / 中等 / 企业级`,用户未要求复杂化或需求不详细时默认 `简单够用`;依赖/兼容任务拆分业务源码平滑性与依赖层落地条件;包/库/adapter/CLI 同查代码层与包工程层;JS/Node 必要注释使用标准 JSDoc;简单 service 不重复 route/model/schema 已承担的校验
57-
- **跨项目经验吸纳守门**: 字段/本地化/状态新增前执行 `ExistingDomainContractAudit`,业务策略常量执行 `ConfigOwnershipMatrix`,接口文档合同执行 `ApiDocVerificationSync`,数据迁移执行 `DataMutationPlan`,值得吸纳建议执行 `AbsorptionDecision`,完整首版执行 `FullV1ScopeGuard`,启动优化执行 `StartupPhaseTrace`;新增吸纳 `CodeTruthRequirementGate`、`ManualReviewEvidenceRetention`、`DocumentationTranslationParityGuard`、`FormalDocsDevCodexBoundary`、`LLMPromptContractTriage`、`VerificationScopeBudgetGate`、`LiveVerificationExecutionObligation` 与 `AdapterBenchmarkAttribution`
57+
- **跨项目经验吸纳守门**: 字段/本地化/状态新增前执行 `ExistingDomainContractAudit`,业务策略常量执行 `ConfigOwnershipMatrix`,接口文档合同执行 `ApiDocVerificationSync`,数据迁移执行 `DataMutationPlan`,值得吸纳建议执行 `AbsorptionDecision`,完整首版执行 `FullV1ScopeGuard`,启动优化执行 `StartupPhaseTrace`;新增吸纳 `CodeTruthRequirementGate`、`ManualReviewEvidenceRetention`、`DocumentationTranslationParityGuard`、`FormalDocsDevCodexBoundary`、`LLMPromptContractTriage`、`VerificationScopeBudgetGate`、`LiveVerificationExecutionObligation`、`AdapterBenchmarkAttribution`、`ProductRequirementTraceabilityGate`、`LocalExecutionConfigProbe`、`ManualReviewEvidenceDataRetention`、`AdjacentScopeExpansionGuard`、`PackageNameAuthorityGate`、`PerformanceBenchmarkFirstGate`、`PublicModuleDifferentiationGate` 与 `V2MCPFirstPlanningGate`
5858
- **验证卫生与包边界**: release / pack / benchmark / codegen 任务中,package boundary check 必须在构建完成后单独串行执行;消费者验证异常先查 package.json、lockfile、node_modules 与 `npm ls <关键依赖>`,收尾前清理无关 dirty 文件和验证残留
5959
- **ProfileImpactCheck**: dev/fix 改动项目技术栈、目录、脚本、测试/发布路线、分发面、配置或长期连接时,会主动判定是否需要更新 Profile;无需更新时也要写明跳过理由
6060
- **敏感信息与硬编码策略**: 默认允许敏感信息、明文连接信息和硬编码出现在用户要求的代码、脚本、配置、文档、测试或报告中;只有用户 / 项目明确禁止时才脱敏、占位或改用 env、`secretRef`、secret manager、`config.local.json`

‎RULES.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -39,7 +39,7 @@ DevCodex 同时支持三类宿主加载路径,规则语义保持一致,由 I
3939
| 开发新功能 / 重构 / 优化 / 初始化 / 文档 | dev(8 子类型) | 当前全量开放 |
4040
| Bug 修复 / 报错 / 线上事故 / 安全漏洞 | fix(3 子类型) | 当前全量开放 |
4141
| 多轮分析(≥3轮)/ 技术调研 / 可行性评估 | analyze | 当前全量开放 |
42-
| 深度审查 / 全面体检 / 逐项检查 | audit(6 子类型) | 当前全量开放 |
42+
| 深度审查 / 全面体检 / 逐项检查 | audit(7 目标类型) | 当前全量开放 |
4343
| 规范文件自修复 | self-fix | 当前全量开放 |
4444
| 恢复/继续上次中断任务 | resume | 当前全量开放 |
4545
| 不匹配上述意图 | plan(兜底) | 当前全量开放 |

‎changelogs/unreleased.md‎

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -6,6 +6,12 @@
66
77
---
88

9+
## 2026-06-11
10+
11+
- 吸纳剩余 `data/*.md` 泛化清单,新增 `ProductRequirementTraceabilityGate`、`LocalExecutionConfigProbe`、`ManualReviewEvidenceDataRetention`、`AdjacentScopeExpansionGuard`、`PackageNameAuthorityGate`、`PerformanceBenchmarkFirstGate`、`PublicModuleDifferentiationGate` 与 `V2MCPFirstPlanningGate`,并同步 `instructions`、Skills、CP/报告模板、TestRoute、README、website 与活动版本需求页。
12+
- 修正 DevCodex v2 文档默认路线为 Intent-Gated Hosted Spec MCP / Codex-only MVP,明确 MongoDB、控制台、多租户自定义工作流和本地规则正文缓存不是一期默认范围。
13+
- 补齐 `profile-bootstrap` 按需触发路由,修正 `18-spec-radar` stale anchor 与 audit `6`/`7` 目标类型漂移,并新增 V62 验证探针覆盖上述同步链路。
14+
915
## 记录提示
1016

1117
- 控制面 / 长流程 / 多批次变更写入本文件时,优先标明 `execution-contract`、`test-router`、`release-verification`、`host-contract-verification`、`source-consumer-sync` 等支撑型能力是否同步更新。

‎instructions.md‎

Lines changed: 44 additions & 36 deletions
Original file line numberDiff line numberDiff line change
@@ -291,6 +291,14 @@ dev/fix 修改完成前必须判定是否影响 Profile。命中以下任一触
291291
- `VerificationScopeBudgetGate`:验证路线必须与风险和变更面匹配;高风险、控制面、发布、资源生命周期或前端体验不能只跑轻量检查,低风险纯文档/纯计算也不得为形式引入重压测、E2E 或外部依赖。
292292
- `LiveVerificationExecutionObligation`:声明“已验证 / 可运行 / 可点击 / 已发布 / 已安装”前必须真实执行对应命令、页面、接口、pack/install、registry/tag 查询或项目等价验证;无法执行时只能写阻塞/降级证据,不能用预期代替结果。
293293
- `AdapterBenchmarkAttribution`:adapter、provider、connector、SDK 或性能优化 benchmark 必须写清基线、环境、版本、负载、归因边界和不可比较因素;不得把框架、网络、缓存预热、依赖树或测试环境差异误归因给业务代码。
294+
- `ProductRequirementTraceabilityGate`:从 PRD、Word、原型、截图、会议纪要或用户补充消息整理需求时,必须保留需求来源、条款/页码/截图/消息锚点、结构化提取口径和遗漏/冲突处理;不得把 AI 归纳当成唯一真相源。
295+
- `LocalExecutionConfigProbe`:脚本、本机验证、数据库/SSH/HTTP 连接或跨环境执行需要本地配置时,必须先核对项目指定配置入口、Profile `config.local.json` 模型或既有脚本约定;未指定时按 S02 默认可直写/沿用现状,禁止臆造 env/secret/config.local 层。
296+
- `ManualReviewEvidenceDataRetention`:人工复核涉及数据、页面、外部系统、发布包或真实联调时,除 `ManualReviewEvidenceRetention` 外还必须记录证据保存位置、可复核输入、样本范围、保留/不可保留原因和敏感信息策略;不得只在聊天里口头确认。
297+
- `AdjacentScopeExpansionGuard`:用户指定模块、adapter、provider、文档页或目录时,不得顺手扩展相邻模块;若相邻范围确有共同契约、共享缺陷或验证必需,必须先写明扩展理由、影响面和回退边界。
298+
- `PackageNameAuthorityGate`:涉及 npm/GitHub Packages/插件/发布包名称、scope、bin、exports 或安装说明时,必须以当前 `package.json`、`plugin.json`、registry/包管理器证据和官方命名约束为准;禁止凭历史记忆或目录名推断包名。
299+
- `PerformanceBenchmarkFirstGate`:用户要求“最快、首个、优于、性能提升、压测、benchmark”时,必须先冻结基线、环境、指标、负载和比较对象,再实施优化;缺少基线时不得宣称提升或第一。
300+
- `PublicModuleDifferentiationGate`:面向公开模块、SDK、CLI、插件或文档站能力时,必须区分 public API、内部实现、示例代码、发布包文件和消费者入口;不得把内部 helper 或历史镜像描述成公开承诺。
301+
- `V2MCPFirstPlanningGate`:DevCodex v2 一期规划默认以 Intent-Gated Hosted Spec MCP / Codex-only 验证 MVP 为优先路线;未形成正式 CP1/CP2 方案包前,不得把 MongoDB、控制台、多租户自定义工作流、本地规则正文缓存或安装 `.github` / `CLAUDE.md` / `AGENTS.md` 副本作为一期默认范围。
294302

295303
### 台账落点与关闭证据
296304

@@ -560,58 +568,58 @@ CP1(问题确认)→ CP2(方案确认)→ [impact-review] → 执行 →
560568

561569
| # | 检查 |
562570
|:-:|------|
563-
| FC1 | CP 按序执行(CP1→CP2,不跳跃)|
564-
| FC2 | 记忆文件已写入 |
565-
| FC3 | 报告文件已生成(dev/fix/analyze/audit 必须)|
566-
| FC4 | 输出语言正确 |
567-
| FC5 | 引用规范文件存在 |
568-
| FC6 | 合规块已输出 |
571+
| FC1 | 记忆文件完整(必填字段齐全,📨 四列表格格式)|
572+
| FC2 | 报告文件已写入(chat 豁免)|
573+
| FC3 | CP 按序执行(dev/fix;其他 N/A)|
574+
| FC4 | 文件名/路径合规(`NN--` 双横杠开头;本轮无报告产物时 N/A)|
575+
| FC5 | 产物路径已输出(`ArtifactLinkSet`:Markdown 主链接 + 必要 `绝对路径:` copy fallback)|
576+
| FC6 | 新增 DevCodex 规范资产 `.md` 超 500 行须按 C13 拆分(业务产物不强制)|
569577
| FC7 | 用户决策选项与报告决策点必带推荐 + 理由 |
570578

571579
### SC 实质合规(选取适用项检查)
572580

573581
| # | 关键项 |
574582
|:-:|--------|
575-
| SC1 | Profile 完整加载(README + 01/02/03 + config.json) |
576-
| SC2 | 意图识别理由可追溯 |
577-
| SC3 | 修复三步必做(同类全局/数据联动/零残留) |
578-
| SC4 | 关联文件同步(C11) |
579-
| SC5 | 高风险操作有 CP3 确认 |
580-
| SC6 | SUMMARY 已追加一行索引 |
581-
| SC7 | 任务摘要字段不缺失 |
582-
| SC8 | 报告产物路径符合 `02-output-paths` |
583-
| SC9 | API 变更产出双产物(接口契约 + 验证脚本,见 api-verification) |
584-
| SC10 | dev/fix 子类型 Skill 已按需读取 |
585-
| SC11 | 多任务进度逐项追加(C14) |
586-
| SC12 | 批量操作分批方案已确认(C16) |
587-
| SC13 | 过程改进 PI 已追加(C17) |
588-
| SC14 | 文件 UTF-8 编码安全(C09) |
589-
| SC15 | dev/fix 关键产物已完成 ECR 执行闭环复审 |
583+
| SC1 | 报告验证列完整(合理性 + 可实施性 + 收益 + 验证状态 + 影响范围五项) |
584+
| SC2 | 代码已诊断(无未处理 error;dev/fix) |
585+
| SC3 | 修复已全局扫描(同类全局/数据联动/grep 零残留;fix) |
586+
| SC4 | 关联文件已同步(C11;含 profile 定义的 dev 模式专属同步命令) |
587+
| SC5 | 后续建议与推荐结论已输出(多建议/多路径必有推荐;无则显式"推荐:无后续动作") |
588+
| SC6 | Agent SUMMARY 已更新(写入动作已发生) |
589+
| SC7 | 全局 SUMMARY 关键决策已追加(有关键决策时) |
590+
| SC8 | 上次待跟进已查阅 |
591+
| SC9 | C08 Token 防护状态 |
592+
| SC10 | C07 并发策略合规(只读/隔离验证并发符合 `ConcurrencyPolicy`;写共享状态竞争视为阻断) |
593+
| SC11 | C14 多任务拆分检查(任务 ≥5) |
594+
| SC12 | C14 多任务进度快照验证(任务 ≥2) |
595+
| SC13 | C15 架构质量自检(dev/fix) |
596+
| SC14 | analyze/audit 标注 ✅已验证 的运行时结论均为本轮实际执行(历史数据须降级 ⚠️待验证) |
597+
| SC15 | dev/fix 关键产物已完成 ECR 执行闭环复审(控制面变更追加 SCV 证据) |
590598

591599
### RC 恢复性检查
592600

593601
| # | 检查 |
594602
|:-:|------|
595-
| RC1 | 失败任务已写入待跟进字段;跨会话/多批次/summary/compact/handoff 场景已有 `ContextHandoffCard` |
596-
| RC2 | 中断点状态 🔄 已持久化 |
597-
| RC3 | 回滚路径有据可查(commit/备份/migrations down) |
598-
| RC4 | 下次会话可直接 resume |
603+
| RC1 | 记忆文件足以让下一个 Agent 恢复上下文;跨会话/多批次/summary/compact/handoff 场景已有 `ContextHandoffCard` |
604+
| RC2 | 已产出文件自洽完整 |
605+
| RC3 | 🔄 标记任务已提供足够恢复线索 |
606+
| RC4 | 关联任务的 `.memory/sessions.md` 已创建 |
599607

600608
### T 任务完成验证(dev/fix 必跑)
601609

602610
| # | 检查 |
603611
|:-:|------|
604-
| T1 | 代码改动通过 lint |
605-
| T2 | 类型检查通过(如适用) |
606-
| T3 | 单元/集成测试通过 |
607-
| T4 | 关联文档已同步 |
608-
| T5 | 关联配置已更新 |
609-
| T6 | CHANGELOG / unreleased 已按发布状态追加(如属外部可见变更) |
610-
| T7 | 工作流验证已完成(dev/fix 含 ECR;audit/analyze 含 PCV 与推荐结论) |
611-
| T8 | 报告 V1~V6 验证通过;若触发上下文交接,daily tasks 或报告已写 `ContextHandoffCard` |
612-
| T9 | 记忆 + SUMMARY 写入完成 |
613-
614-
> 完整逐项定义见当前平台部署目录中的 `instructions/17-compliance.instructions.md`;本表为就地索引。
612+
| T1 | 需求覆盖 |
613+
| T2 | 报告存在(chat 豁免) |
614+
| T3 | 记忆完整 |
615+
| T4 | CP 完整(dev/fix;其他 N/A) |
616+
| T5 | 合规通过 |
617+
| T6 | 约束遵守(C01~C22) |
618+
| T7 | 工作流验证(dev/fix 含适用门禁、三步扫描与 ECR;audit/analyze 含 PCV 与推荐结论) |
619+
| T8 | SUMMARY 已更新;若触发上下文交接,daily tasks 或报告已写 `ContextHandoffCard` |
620+
| T9 | 产物路径已输出 |
621+
622+
> 完整逐项定义见当前平台部署目录中的 `instructions/17-compliance.instructions.md`;本表为就地索引(编号与语义与该文件一一对应)。
615623
616624
---
617625

‎instructions/01-common.instructions.md‎

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -185,7 +185,7 @@ version: 1.11.18
185185
| dev.optimization | `dev-optimization` · `cp-gate` · `dev-plan-review` |
186186
| dev.scenario-test | `dev-scenario-test` · `cp-gate` |
187187
| dev.docs | `dev-docs` · `cp-gate` |
188-
| dev.plan-review | (Instruction 已完整,无需额外 Skill)|
188+
| dev.plan-review | `audit-common`(豁免 `dev-plan-review`,防递归)|
189189
| fix.default | `fix-default` · `cp-gate` |
190190
| fix.security | `fix-security` · `cp-gate` |
191191
| fix.incident | (Instruction 已完整,无需额外 Skill)|
@@ -210,6 +210,7 @@ version: 1.11.18
210210
- `release-verification`:用户明确要求 release / tag / publish 或版本发布验证时触发
211211
- `host-contract-verification`:宿主事件契约、visible reply、sticky project、workspace guard、bootstrap 证据任务触发
212212
- `source-consumer-sync`:规范源、README/website/Profile/validate/部署副本联动时触发
213+
- `profile-bootstrap`:Profile 缺失、用户要求补建 Profile、需要从 prod 降级恢复到 dev 模式,或需要生成 `.devcodex/profile/` 初稿时触发;优先建议/执行 `devcodex profile init`,不得用 AI 推测内容替代文件真相源
213214
- `api-verification`:PR-5① 标记触发
214215
- `impact-review`:PR-5② 标记触发
215216
- `document-sync`:dev/fix 执行完成后触发

‎instructions/01a-profile-loading.instructions.md‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -28,6 +28,7 @@ version: 1.11.18
2828
- 连接配置来源遵循 S02:默认可直写或沿用项目既有模式;只有用户或项目明确指定 `config.local.json` 时,脚本、测试、数据库 / SSH / MongoDB / 数据操作才从当前 Profile 路径模型下的 `config.local.json` 读取,缺失文件或字段时提醒补齐
2929
- `config.local.json` 可保存 host、port、database、schema、username、内部 URL、连接别名、password、token、apiKey、privateKey、clientSecret、signingKey、connectionPassword、connectionString 等本地字段;`*Env` / `secretRef` 只有在用户指定、项目既有配置或用户指定的发布流程明确要求时才使用
3030
- `README.md`、`01-项目信息.md`、`02-架构约束.md`、`03-代码风格.md` 采用 `project file first + workspace fallback`
31+
- Profile 缺失时仍按 `prod` 保守降级;若用户要求补建 Profile、恢复 dev 模式、初始化 `.devcodex/profile/` 或修复 Profile 缺失,应读取 `profile-bootstrap` 并优先建议/执行 `devcodex profile init`,不得用 AI 推测内容静默替代 Profile 文件真相源。
3132

3233
### 运行态目录写入
3334

0 commit comments

Comments
 (0)