docs(rules): 阶段 1 · PR 3/3 收官 — frontend 拆层 + 元原则引用全面覆盖 · #19

qshenzhang/anta-workshopdemo

Public

WeChat Login

Code Issues Pull requests Events Packages Insights

docs(rules): 阶段 1 · PR 3/3 收官 — frontend 拆层 + 元原则引用全面覆盖#19

Merged

Qisen

created 2 weeks ago

main

docs/frontend-split-and-principle-refs

Edit

OverviewCommits

Files changed

Attachments

Qisen

为什么做这个

阶段 1 的最后一步：完成 P0 绑定治理。解决三件事：

frontend-development.md 仍绑定 Vue（同 backend 问题）
其他 6 份规则没有声明派生自元原则，规则体系缺少"宪法引用链"
LESSONS 反模式表空着，本阶段积累的 3 条反模式需要沉淀

做了什么

1. frontend 规则拆层（同 backend 模式）

层	文件
通用骨架	`rules/frontend-core.md`（新增，380 行）
Vue 参考实现	`rules/.archived/frontend-vue.md`（原文归档 + 头部定位说明）

frontend-core.md 10 章节：

组件设计：页面 / 布局 / 业务 / 通用四层；组件契约（props / events / slots）
类型系统：strict 模式、禁 any、类型从契约生成（派生自元原则 5）
状态管理：URL / 服务器 / 全局 UI / 局部四层分治
API 契约消费：统一客户端、模块化组织、错误码处理（派生自元原则 5）
路由：集中配置、元信息、权限守卫、代码分割
样式：设计 token、响应式断点、a11y
错误处理：客户端 / 全局边界 / 业务组件三层
性能：Core Web Vitals 棘轮门禁（派生自元原则 3）
测试：派生自元原则 1-3
代码风格：各栈工具对照

附录：新增前端技术栈 5 步落地。

2. 元原则引用 100% 覆盖

给其余 6 份规则顶部加派生声明：

规则	派生自元原则
`unit-testing.md`	§1（真实编译）§2（不可执行测试）§3（棘轮阈值）
`functional-testing.md`	§1 §2 §5（契约）
`git-conventions.md`	§4（抽象化）§5（契约）
`project-architecture.md`	§4 §5
`requirement-analysis.md`	§4
`requirement-expansion.md`	§4 §5

规则对 meta-principles 的引用：9/9（100%）

3. LESSONS 反模式表填入 3 条

本阶段 3 个 PR 积累的通用反模式：

#	反模式	正模式	防御位置
1	规则文件技术栈硬绑定	「核心 + 参考实现」分层	`backend-core`/`frontend-core §附录`
2	工具商标渗透到规则层	占位符 + `tooling-landscape §一` 登记	`meta-principles §原则 4`
3	元原则散落重定义	单一 `meta-principles.md` 宪法化	`meta-principles.md`、R0 索引

4. 跨文件引用更新

.codebuddy/README.md 规则索引新增 R3（frontend-core）+ R3-vue 两行
requirement-workflow/SKILL.md 引用路径更新
根 README.md 目录结构加 frontend-vue.md
LESSONS.md §三、§五 同步

终局抽象度扫描

规则层主体（不含 .archived）技术栈绑定减少幅度：

维度              开始    现在    减少
Java 关键词       48      16      -67%
Spring Boot       34       7      -79%
MyBatis           49      10      -80%
Vue               24      14      -42%
TAPD             113       4      -96%  ← 剩余为示例对照 / 反面教材

新增抽象度指标：

占位符用例（<PM-Tool> 等）：15 处
「派生自元原则」声明：21 处
meta-principles 引用：17 处

阶段 1 总览（PR #17 + #18 + 本 PR）

PR	主题	关键产出
#17	R0 元原则 + PM 工具占位化	`meta-principles.md`（宪法）+ 15 处 TAPD → 占位符
#18	backend 规则拆层	`backend-core.md`（440 行通用）+ Java 参考实现归档
#19	frontend 拆层 + 元原则引用全覆盖	`frontend-core.md`（380 行通用）+ 9/9 规则引用元原则 + 反模式沉淀 3 条

改动统计

12 files changed, 288 insertions(+), 11 deletions(-)
新增: rules/frontend-core.md (245 行)
归档: frontend-development.md → .archived/frontend-vue.md

自举验证

✅ read_lints 0 错误
✅ 9/9 规则引用元原则
✅ 抽象度指标全面改善

下一步建议（不在本 PR 范围）

阶段 2 候选（你的决策）：

DDD 指引（rules/common/domain-modeling.md）
微服务规范（rules/common/microservice.md）
Agent Harness 规格升级（_meta.json v2）
skills 依赖图（skills/SKILLS.md）
观测性 / 安全基线 / AI 协同开发规范
project-architecture.md 的技术栈表示例化（当前仍有 Java/MyBatis 硬绑定）

通用性声明

阶段 1 完成后：.codebuddy/ 三层框架真正实现了技术栈无关。任何团队（Java / Go / Node / Python / React / Svelte）都可以直接基于本脚手架启动，只需按 <domain>-core.md §附录 的 5 步复制生成自己的栈特化规范，核心骨架一行不用改。