> 状态(2026-04-18 新建):**文档提案,无代码动作** ## Why `mjava-ai` 仓库已稳定承载三个生产客户(mcli / shunfeng / guangming),基座 `mjava` 的核心能力(`UtilHttp` / `UtilToken` / `McR` / JPA+QueryDSL / 全局异常 / TraceId)已经形成事实规范但没有被文档化。新成员或新客户接入时,缺少一份"权威基线"文档可以指向。 同时,`openspec/specs/` 目录此前为空,OpenSpec 工作流缺少稳态规范锚点。现需要沉淀一份指针式的 baseline spec,把开发规范主权交给文档中心 `/Users/malk/Desktop/Tech/claude/后端/mjava-baseline.md`,仓库内只保留"差异 + 代码锚点"。 ## What Changes **本提案不改任何 Java 源码、不改 pom、不 push git**,仅沉淀规范与索引: - 新建 `openspec/specs/project-baseline.md` —— 一页纸稳态 spec,指向文档中心的权威规范,并列出仓库内关键代码锚点 - 新建仓库根 `CLAUDE.md` —— 给未来在该仓库工作的 AI / 新成员一个 40 行以内的入口,链到 openspec 工作流与文档中心 - 通过 `/Users/malk/Desktop/Tech/claude/后端/mjava-baseline.md` 权威化 11 项规范(HTTP / Token / 配置 / 响应异常 / 持久化 / 日志链路 / 子项目接入 / 构建 / YAGNI 清单 等) ## Capabilities ### New Capabilities - `project-baseline`: 项目基线规范锚点(仓库内 specs/ 层),定义"什么是 mjava-ai 的标准开发方式" ### Modified Capabilities ## Impact - **代码影响**:零 - **pom 影响**:零 - **配置影响**:零 - **对生产**:零(mcli/shunfeng/guangming 运行不受任何影响) - **对新客户接入**:有正向指引——按 `mjava-baseline.md` 第 9 章复制 `mjava-mcli` 模板即可 - **对 OpenSpec 工作流**:`openspec/specs/` 不再为空,后续新 change 可以 reference baseline ## Non-Goals 显式声明**本次不做**: - ❌ 删除或改造 `mjava-shunfeng` / `mjava-guangming` 子模块(保障生产可用) - ❌ 修改根 pom 的 `` 聚合 - ❌ 升级 `mjava.version` - ❌ 引入 Redis / Docker / 消息队列 / K8s(见 `mjava-baseline.md` 第 11 章) - ❌ 为新客户搭空脚手架(等实际需求来临再走 `/opsx:propose`) - ❌ git commit / push / 设置 remote