docs(rules): 阶段 1 · PR 2/3 — backend 规则拆层为核心+参考实现#18
PR #17 落地了 R0 元原则,但 backend-development.md(1629 行)仍是Java/Spring/MyBatis 特化,让脚手架对 Go/Node/Python 后端项目毫无用处。违反定位 A(通用 AI Agent 协作框架)。
backend-development.md
不是删 Java 内容(那 1600 行资产太珍贵),而是分层:
rules/backend-core.md
rules/.archived/backend-java-spring.md
@Transactional
@transaction.atomic
@RestControllerAdvice
ExceptionFilter
exception_handler
附录:新增技术栈 5 步落地步骤。
Java: 8 处 Go: 8 处 Node: 7 处 Python: 7 处 Kotlin: 2 处
Java/Spring 在 backend-core 中的提及仅限于跨栈对比("Java 用 @Transactional、Node 用 TypeORM、Python 用 @transaction.atomic"这种形态),不作为硬要求。
backend-java-spring.md 头部加了定位说明:
backend-java-spring.md
- 本文件是 backend-core.md 的 Java + Spring Boot 参考实现 - 其他栈项目以 backend-core.md 为主 - 声明派生自 meta-principles 的 5 条元原则
1600 行原内容一行不删,完整保留团队积累的 Java 实战经验。
.codebuddy/README.md
project-architecture.md
code-review/backend-checklist.md
requirement-workflow/SKILL.md
README.md
LESSONS.md
8 files changed, 418 insertions(+), 20 deletions(-) 新增: rules/backend-core.md (440 行) 归档: rules/backend-development.md → rules/.archived/backend-java-spring.md
read_lints
PR 3/3:frontend 同模式处理 + meta-principles 引用在各规则里补齐(给剩余 7 份规则加 派生自原则 X 的标注行)+ 最终抽象度扫描。
派生自原则 X
本 PR 后,backend-core.md 可以直接迁移到任何后端技术栈的项目使用;Java 项目可继续用 .archived/backend-java-spring.md 的完整参考实现;新增 Go/Node/Python 栈时按附录 5 步走。
backend-core.md
.archived/backend-java-spring.md
为什么做这个
PR #17 落地了 R0 元原则,但
backend-development.md(1629 行)仍是Java/Spring/MyBatis 特化,让脚手架对 Go/Node/Python 后端项目毫无用处。违反定位 A(通用 AI Agent 协作框架)。解法:核心 + 参考实现
不是删 Java 内容(那 1600 行资产太珍贵),而是分层:
rules/backend-core.md(新增,440 行)rules/.archived/backend-java-spring.md(原文归档)backend-core.md 的 11 章节
@Transactional/ Node TypeORM / Python@transaction.atomic)+ 状态机显式@RestControllerAdvice/ Express middleware / NestExceptionFilter/ FastAPIexception_handler)附录:新增技术栈 5 步落地步骤。
跨栈示例均衡
Java/Spring 在 backend-core 中的提及仅限于跨栈对比("Java 用 @Transactional、Node 用 TypeORM、Python 用 @transaction.atomic"这种形态),不作为硬要求。
归档处理
backend-java-spring.md头部加了定位说明:1600 行原内容一行不删,完整保留团队积累的 Java 实战经验。
跨文件引用更新(连锁反应)
.codebuddy/README.md规则索引project-architecture.mdcode-review/backend-checklist.mdrequirement-workflow/SKILL.mdREADME.md目录结构 + 快速上手步骤LESSONS.md资产清单、已知限制改动统计
自举验证
read_lints0 错误下一步(阶段 1 收官)
PR 3/3:frontend 同模式处理 + meta-principles 引用在各规则里补齐(给剩余 7 份规则加
派生自原则 X的标注行)+ 最终抽象度扫描。通用性声明
本 PR 后,
backend-core.md可以直接迁移到任何后端技术栈的项目使用;Java 项目可继续用.archived/backend-java-spring.md的完整参考实现;新增 Go/Node/Python 栈时按附录 5 步走。