logo
0
0
WeChat Login

docs(rules): 阶段 1 · PR 1/3 — R0 元原则 + PM 工具彻底占位化#17

Merged
created 2 weeks ago
main
docs/meta-principles-and-pm-tool-abstraction
Edit
OverviewCommits
1
Files changed
7
Attachments

为什么做这个

资深架构审视发现 P0 问题:脚手架承诺「通用 AI Agent 协作框架」,实际深度绑定 Java/Spring/TAPD

本 PR 是阶段 1 三连 PR 的第一步,解决两件事:

  1. 5 条元原则散落在 testing-standards 各处,没有一份"宪法"文件。新规则没有派生依据。
  2. TAPD 渗透到 6 个非 tapd 文件,PM 工具替换代价高。

做了什么

1. 新增 rules/meta-principles.md(R0,alwaysApply: true)

把 5 条元原则独立成"框架宪法",技术栈无关

原则浓缩
1. 真实编译优先交付前跑真实编译,工具链不匹配用容器锁版本;多语言命令示例(Java / Node / Python / Go)
2. 不可执行的测试 = 负价值跑不起来就删除,禁用 @Disabled / skip 占位
3. 棘轮质量阈值阈值=当前真实水平的保底,形成只能上调的棘轮
4. 抽象化优先规则层禁止项目专属日期/类名/错误码/工具商标;含自验证命令
5. 契约优先于约定跨层交互必须由机器可读契约保证(OpenAPI/proto/SDL/Avro/JSON Schema)

每条原则都有:硬约束 / 反模式信号 / 适用范围。元原则与反模式互为镜像(附录对照表)。

2. testing-standards.md 去重

避免元原则被重复定义导致漂移:

  • §1.3 棘轮策略 → 改为派生自 R0 原则 3,保留测试视角的数字示例
  • §2.2 不可执行的测试 → 改为派生自 R0 原则 2,保留测试层落地要点
  • §五 交付前编译验证 → 改为派生自 R0 原则 1,保留多层验证表格

3. PM 工具占位化(R0 原则 4 落地)

文件修改处替换
rules/git-conventions.md4TAPD → <PM-Tool>,分支号/Refs/Tag/工作流
rules/project-architecture.md2TAPD/企微 → <PM-Tool>/<Chat-Tool>
rules/requirement-expansion.md5TAPD → <PM-Tool>,Javis → 需求对接人
.codebuddy/README.md4TAPD → <PM-Tool>tapd skill 标注为「参考实现,可整体替换」

4. 规则索引表新增 R0 行

.codebuddy/README.md 的规则索引把 R0 放在第一行(和其他规则并列展示),强调:

  • R3/R4 标注为「Vue 参考实现」/「Java 参考实现」
  • R5 标注"派生自 R0 原则 1~3"

5. LESSONS.md §一 指向 meta-principles 作为权威定义

LESSONS 保留浓缩摘要,避免维护两份同样内容。

抽象化自检

规则层 (rules/ + governance/主体) 未占位化的 TAPD:0 处
(唯一保留:git-conventions.md §2.6 里 Refs 示例对照
 TAPD#1234567 / JIRA-1234 / LIN-456 —— 这是作为占位符示例展示
 不同 PM 工具的具体形态,属于教学用途)

改动统计

7 files changed, 289 insertions(+), 90 deletions(-)
新增: rules/meta-principles.md (228 行)

自举验证

  • read_lints 0 错误
  • ✅ 抽象化扫描通过(见上)
  • ✅ 元原则 §原则 4 的自验证命令在本 PR 的 rules/ 上执行通过

下一步(阶段 1 后续)

  • PR 2/3backend-development.md 拆层 —— 抽出 backend-core.md(分层/API/异常/幂等/事务,技术栈无关),原文归档到 .archived/backend-java-spring.md 作为 Java 参考实现
  • PR 3/3frontend-development.md 同模式拆层 + governance/skills 描述适配 + 元原则引用补齐

通用性声明

  • meta-principles.md 无任何技术栈绑定、无任何项目绑定
  • 本 PR 所有占位符 <PM-Tool> <Chat-Tool> <CI-Platform> 均已在 governance/tooling-landscape.md §一 登记
  • 迁移新团队时,只需替换 .project.json 中的实际工具凭证,规则层一行不用改
is using the squash method to merge intoeafb8453
docs(rules): R0 元原则 + PM 工具彻底占位化 (#17)

Successfully merged and closed

Reviewer
None yet
Assignee
None yet
Label
None yet
Participant