@@ -44,17 +44,17 @@ DevCodex 通过 `.github/`(Copilot)、`CLAUDE.md + .claude/ + .mcp.json`(C
4444- ** 可配置并发策略** : Profile ` config.json ` 可配置 ` extensions.devcodex.concurrency ` ;默认 ` auto ` 表示只读准备和隔离验证可并行、共享状态写入保持单写者,保守项目可设为 ` serial `
4545- ** 支撑型 Skill** : ` execution-contract ` / ` test-router ` / ` release-verification ` / ` host-contract-verification ` / ` source-consumer-sync ` 为控制面、多批次、测试路线、宿主契约验证与真相源-消费者同步提供可审计支撑,不新增工作流分支
4646- ** 发布前审查能力** : ` audit-release ` 负责 release readiness、发布说明质量、兼容/迁移风险、package/plugin 元数据、文档/Profile/website 同步、回滚策略、registry/tag 风险与发布后验收 review;` release-verification ` 仍负责 R0~ R7 执行验证链
47- - ** README 专项能力** : ` readme-authoring ` 负责 README 用户/使用者优先写作,` audit-readme ` 负责 README / 用户使用文档专项 review
47+ - ** README 专项能力** : ` readme-authoring ` 负责 README 用户/使用者优先写作,` audit-readme ` 负责 README / 用户使用文档专项 review; ` UserPerspectiveDocsGate ` 要求文档按使用者第一次成功、常见任务、字段/参数/状态/错误解释、排错恢复和低心智负担组织, ` PublicUserDocsMaintainerBoundaryGate ` 要求公开用户文档不混入维护者 checklist、内部同步清单或台账状态, ` DocsConsumerSweep ` 负责同步 README、website、Profile、示例、模板、导航和代码消费点
4848- ** Profile 新鲜度审查** : audit 会先执行 ` Profile Freshness Check ` ,反向核对 Profile 是否仍匹配当前包版本、目录资产、脚本、发布状态、宿主能力和任务现实
4949- ** 项目工程泄漏审查** : 项目工程 / 代码质量审查执行 ` PE-12 资源生命周期与泄漏风险 ` ,必须检查内存泄露、资源泄漏、监听器/定时器/连接/流未释放、缓存无界增长和组件卸载清理缺失
5050- ** 泄漏风险稳定性压测** : 写测试用例或回归验证时先执行 ` LeakRiskStabilityPressureTest ` 条件判定;命中长运行、高并发、缓存/连接/监听器/定时器/流/socket/worker/订阅/组件生命周期或 ` PE-12 ` 风险时,TestRoute 纳入场景/负载/稳定性压测并记录基线、冷却后回落和资源指标前后对比;低风险任务写 ` N/A + skipReason `
51- - ** 前端体验质量门禁** : 前端页面、组件、控制台、官网、文档站、可视化工具或游戏任务执行 ` FrontendExperienceQualityGate ` 条件判定,覆盖设计来源、UI 还原度、风格主题、响应式状态、视觉验证、用户流、交互反馈、输入方式/可访问性、错误恢复和动效转场;Figma/截图/既有页面还原追加 ` FigmaHighFidelityRestorationGate ` 、` ScopedVisualChangeGate ` 、` InstalledPluginVisualVerificationGate ` 、` ActualPreviewChainAndMockFallbackGate ` 、` UIStateScopeRegressionGate ` 、` FigmaProductionAssetBudgetGate ` 与 ` RuntimeI18nArtifactVerificationGate ` ;命中时 TestRoute 纳入 Browser/截图、Playwright/E2E 或人工复核证据
52- - ** 复审覆盖增量 ** : audit / review / ECR 的连续零发现必须附 ` ReviewCoverageDelta ` (` ReviewedSet ` / ` UnreviewedRelatedSet ` / ` NewlyReadThisRound ` / ` RepeatReadReason ` / ` NoNewSurfaceReason ` ),优先阅读此前未审查但相关联的代码、配置、测试、文档、部署副本和消费者链;无新增覆盖且无证据化理由时 ,不计入有效零发现
51+ - ** 前端体验质量门禁** : 前端页面、组件、控制台、官网、文档站、可视化工具或游戏任务执行 ` FrontendExperienceQualityGate ` 条件判定,覆盖设计来源、UI 还原度、风格主题、响应式状态、视觉验证、用户流、交互反馈、输入方式/可访问性、错误恢复和动效转场;Figma/截图/既有页面还原追加 ` FigmaHighFidelityRestorationGate ` 、` ScopedVisualChangeGate ` 、` InstalledPluginVisualVerificationGate ` 、` ActualPreviewChainAndMockFallbackGate ` 、` FrontendRuntimeNetworkProbeGate ` 、 ` UIStateScopeRegressionGate ` 、` FigmaProductionAssetBudgetGate ` 与 ` RuntimeI18nArtifactVerificationGate ` ;命中时 TestRoute 纳入 Browser/截图、Playwright/E2E、console/network/resource/runtime 或人工复核证据
52+ - ** 复审覆盖增量与维度增量 ** : audit / review / ECR 的连续零发现必须附 ` ReviewCoverageDelta ` (覆盖面增量)与 ` ReviewDimensionDeltaGate ` (维度焦点增量 ),优先阅读此前未审查但相关联的代码、配置、测试、文档、部署副本和消费者链,并避免每轮机械重复同一组维度;无新增覆盖、无新增维度焦点且无证据化理由时 ,不计入有效零发现
5353- ** 规范治理 Intake** : 所有模式下每条用户消息在合理性评估后都会额外检查是否命中可泛化改进;命中时主动写入 ` data/process-improvements.md ` (优化清单,PI),必要时联动 ` data/pending-fixes.md ` (PF),并显式回执 ` PI/PF `
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`、`ExplicitCommitAuthorizationGate`、`CompatibilityAndContractAuthorityGate`、`UIConfirmedSourceConflictTraceGate`、`PublicDocsReleasedVersionGate`、`CollectionRelationIdNamingGate`、`UserFacingVerificationArtifactLanguageGate`、`AdapterBenchmarkAttribution`、`ProductRequirementTraceabilityGate`、`LocalExecutionConfigProbe`、`ManualReviewEvidenceDataRetention`、`AdjacentScopeExpansionGuard`、`PackageNameAuthorityGate`、`PerformanceBenchmarkFirstGate`、`PublicModuleDifferentiationGate`、`V2MCPFirstPlanningGate`、`WorkspaceDataAbsorptionScopeGate`、`FlowchartNodeExplanationGate`、`DocsSiteVisualAcceptanceGate`、`OmissionOnlyReviewGate`、`ReviewFindingIntakeGate`、`MethodLevelLeakPressureProbe` 与 `V2FormalSolutionPackage`
57+ - **跨项目经验吸纳守门**: 字段/本地化/状态新增前执行 `ExistingDomainContractAudit`,业务策略常量执行 `ConfigOwnershipMatrix`,接口文档合同执行 `ApiDocVerificationSync`,数据迁移执行 `DataMutationPlan`,值得吸纳建议执行 `AbsorptionDecision`,完整首版执行 `FullV1ScopeGuard`,启动优化执行 `StartupPhaseTrace`;新增吸纳 `CodeTruthRequirementGate`、`ManualReviewEvidenceRetention`、`DocumentationTranslationParityGuard`、`FormalDocsDevCodexBoundary`、`LLMPromptContractTriage`、`VerificationScopeBudgetGate`、`LiveVerificationExecutionObligation`、`ExplicitCommitAuthorizationGate`、`CompatibilityAndContractAuthorityGate`、`UIConfirmedSourceConflictTraceGate`、`PublicDocsReleasedVersionGate`、`CollectionRelationIdNamingGate`、`UserFacingVerificationArtifactLanguageGate`、`AdapterBenchmarkAttribution`、`ProductRequirementTraceabilityGate`、`LocalExecutionConfigProbe`、`ManualReviewEvidenceDataRetention`、`AdjacentScopeExpansionGuard`、`PackageNameAuthorityGate`、`PerformanceBenchmarkFirstGate`、`PublicModuleDifferentiationGate`、`V2MCPFirstPlanningGate`、`WorkspaceDataAbsorptionScopeGate`、`FlowchartNodeExplanationGate`、`DocsSiteVisualAcceptanceGate`、`OmissionOnlyReviewGate`、`ReviewFindingIntakeGate`、`ReviewDimensionDeltaGate`、`UserPerspectiveDocsGate`、`PublicUserDocsMaintainerBoundaryGate`、`DocsConsumerSweep`、`ArtifactLinkSetDedupeGate`、`FrontendRuntimeNetworkProbeGate`、`ActiveRequirementFinalResponseGate`、`MethodLevelLeakPressureProbe` 与 `V2FormalSolutionPackage`
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 `
@@ -320,7 +320,7 @@ devcodex/
320320
321321发布前审查由 ` audit-release ` 承担:它是 audit 专项维度,审查 release readiness、发布说明质量、兼容/迁移风险、package/plugin 元数据、文档/Profile/website 同步、回滚策略、registry/tag 风险与发布后验收;它不替代 ` release-verification ` ,也不执行真实 ` tag ` / ` push ` / ` publish ` 。
322322
323- README / 用户使用文档当前补充两类专项 Skill:` readme-authoring ` 负责把 README 默认主视角收口为用户 / 使用者优先,` audit-readme ` 负责专项审查用户路径、快速开始、示例真实度、开发信息后置与消费链一致性。
323+ README / 用户使用文档当前补充两类专项 Skill:` readme-authoring ` 负责把 README 默认主视角收口为用户 / 使用者优先,` audit-readme ` 负责专项审查用户路径、快速开始、示例真实度、开发信息后置与消费链一致性。正式用户文档还执行 ` UserPerspectiveDocsGate ` 、 ` PublicUserDocsMaintainerBoundaryGate ` 和 ` DocsConsumerSweep ` :检查文档是否足够详细、首次读者是否看得懂、心智负担是否简单,公开用户路径是否排除了维护者 checklist / 内部同步清单 / 台账状态,以及 README / website / Profile / examples / templates / validate / 代码消费点是否同步。
324324
325325> ; ℹ️ 维护者状态文件(本仓库开发过程中累积的 violations/pending-fixes 记录)按 active-root 保存,例如 workspace-namespace 下的 ` .devcodex/<project>/data/ ` ,** 不分发** 给用户。
326326
0 commit comments