@@ -50,7 +50,8 @@ DevCodex 通过 `.github/`(Copilot)、`CLAUDE.md + .claude/ + .mcp.json`(C
5050- ** 官方文档证据前置** : 新增或升级依赖、框架、SDK、平台 API、外部模块前,CP2 会要求 ` OfficialDocsEvidence ` ,记录官方文档来源、关键用法、限制与兼容性,避免凭经验猜 API
5151- ** 通用工程守门** : Node.js 项目默认不低于 ` >=18 ` ;依赖/兼容任务拆分业务源码平滑性与依赖层落地条件;包/库/adapter/CLI 同查代码层与包工程层;JS/Node 必要注释使用标准 JSDoc;简单 service 不重复 route/model/schema 已承担的校验
5252- ** ProfileImpactCheck** : dev/fix 改动项目技术栈、目录、脚本、测试/发布路线、分发面、配置或长期连接时,会主动判定是否需要更新 Profile;无需更新时也要写明跳过理由
53- - ** Profile 本地私有配置** : ` config.local.json ` 是脚本、测试、数据库 / SSH / MongoDB / 数据操作的连接配置唯一入口,支持长期连接、env 引用、已授权本地明文秘密和 ` extensions.<namespace> ` ;文件应加入 ` .gitignore ` ,且不能覆盖 ` mode ` / ` agent `
53+ - ** 敏感信息与硬编码策略** : 默认允许敏感信息、明文连接信息和硬编码出现在用户要求的代码、脚本、配置、文档、测试或报告中;只有用户 / 项目明确禁止时才脱敏、占位或改用 env、` secretRef ` 、secret manager、` config.local.json `
54+ - ** AI 自启动服务清理** : AI 为验证启动 dev server、文档站、本地 API/mock、数据库代理、SSH 隧道、Playwright/Cypress server 或压测 target 后,验证完成、失败或最终回复前会主动关闭仅由 AI 本轮启动的服务并核验端口释放;用户要求保留时会记录 PID/端口和关闭方式
5455- ** 变更日志分层** : 未发布实现变更写 ` changelogs/unreleased.md ` ,已发布详情统一归档到 ` changelogs/releases/vX.Y.Z.md ` ,目录说明见 ` changelogs/README.md `
5556- ** 执行闭环复审** : dev/fix 完成前执行 ECR 执行闭环复审,交叉验证 CP 产物、报告、daily memory、SUMMARY、diff/commit、测试/探针与 dirty 边界
5657- ** 推荐结论** : analyze/audit/report 多建议或多路径场景必须给出推荐结论与推荐理由;无后续动作时明确写“推荐:无后续动作”
@@ -72,7 +73,7 @@ echo "//npm.pkg.github.com/:_authToken=\${NODE_AUTH_TOKEN}" >> .npmrc
7273export NODE_AUTH_TOKEN=YOUR_GITHUB_PAT
7374```
7475
75- 这里的环境变量仅用于 GitHub Packages 认证密钥 ,不代表项目里的普通配置默认都应 env 化;非敏感、本地、测试或一次性脚本配置优先保持最简单、可直接读懂的写法 。
76+ 这里的环境变量仅用于 GitHub Packages 认证流程 ,不代表项目里的普通配置默认都应 env 化;未明确要求 env 时,AI 不得主动把明文或硬编码改成 env、 ` secretRef ` 、secret manager 或 ` config.local.json ` 。
7677
7778> 当前安装包通过 ** GitHub Packages** 分发;在执行 ` npm install @vextjs/devcodex ` 之前,必须先完成上述 registry 与 ` NODE_AUTH_TOKEN ` 认证配置。
7879
@@ -180,6 +181,7 @@ AGENTS.md ← 与 instructions.md / copilot-instructions.md / CL
180181- ** 台账状态回写闭环** :当实施或复审改变了 VL / PF / PI / ISSUE / GAP 的真实状态时,会在完成前回写状态、验证证据、验证时间与关闭/部分完成说明,并再核对 open 计数、进度、报告和 SUMMARY 是否一致。
181182- ** 官方资料优先** :涉及平台能力、框架 API、版本兼容性或工具语义判断时,优先读取官方文档,再降级到其他资料;新增/升级依赖、框架、SDK、平台 API 或外部模块时必须形成 ` OfficialDocsEvidence ` 。
182183- ** ProfileImpactCheck** :项目事实变化后,DevCodex 会检查是否需要同步 Profile 的技术栈、目录边界、脚本/测试/发布路线、配置说明或当前阶段;若不更新,需要在报告中写明 ` skipReason ` 。
184+ - ** ServiceLifecycleCleanup** :若验证需要 AI 自己启动本地服务,会记录启动命令、cwd、PID/job、端口/URL,并在验证完成、失败或最终回复前关闭仅由 AI 本轮启动的服务;不会为了释放端口杀掉用户已有进程。
183185- ** 提交标题收短** :用户要求提交时,DevCodex 会优先生成一句简洁的 commit subject,而不是把整段会话摘要塞进标题。
184186
185187
@@ -208,7 +210,7 @@ AGENTS.md ← 与 instructions.md / copilot-instructions.md / CL
208210- 单项目任务:写入 ` <workspace>/.devcodex/<project>/... `
209211- 全工作区任务:写入 ` <workspace>/.devcodex/workspace/... `
210212- ` config.json ` :` workspace/profile ` 作为 base,` <project>/profile ` 作为 overlay
211- - ` config.local.json ` :与 ` config.json ` 采用相同的 ` workspace/profile + <project>/profile ` overlay 模型,但仅用于本地私有配置、长期连接 、env 引用、已授权本地明文秘密和 ` extensions.<namespace> ` ;不覆盖 ` mode ` / ` agent ` ;脚本、测试、数据库 / SSH / MongoDB / 数据操作连接信息必须从这里取得,缺失时提醒用户补齐,不得自行发明 ` .env ` 文件、环境变量名或并行配置格式
213+ - ` config.local.json ` :与 ` config.json ` 采用相同的 ` workspace/profile + <project>/profile ` overlay 模型,可作为用户 / 项目指定的本地 overlay,承载长期连接、本地明文连接信息 、env / secretRef 引用和 ` extensions.<namespace> ` ;不覆盖 ` mode ` / ` agent ` ;脚本、测试、数据库 / SSH / MongoDB / 数据操作连接信息默认可直写或沿用项目既有模式,只有用户或项目明确指定时才从这里取得
212214- Profile 文档:项目命名空间文件优先,缺失回退到 ` workspace/profile `
213215- CLI / Hook 运行态目录:统一写 active-root;单项目为 ` <workspace>/.devcodex/<project>/.memory|.audit-state ` ,全工作区为 ` <workspace>/.devcodex/workspace/.memory|.audit-state `
214216- 多项目 workspace 根缺少 workspace profile 时,Hook 提示真实路径 ` .devcodex/workspace/profile/ ` ;同一宿主会话已识别唯一项目后,后续“继续/确认”会在短 TTL 内沿用该项目和项目 ` mode ` ,新会话、TTL 过期或显式 workspace 请求会重新判断。
0 commit comments