logo
0
0
WeChat Login

chore: 重置为脚手架——清空项目专属数据,保留 .codebuddy 三层框架#16

Merged
created 2 weeks ago
main
chore/reset-to-scaffold
Edit
OverviewCommits
1
Files changed
182
Attachments

目的

把仓库重置为开箱即用的空脚手架——任何新团队 clone 下来就是一份干净的框架模板,可以立刻用来开始新项目。

保留内容(脚手架骨架)

.
├── .codebuddy/                # 框架本体,完整保留
│   ├── rules/                 # 9 份规则
│   ├── skills/                # 9 个 skills(含脚本)
│   ├── governance/            # 6 份治理文档
│   └── rules/.archived/       # 归档目录(索引已清空为脚手架模板)
├── .env.example              # 改为技术栈中立模板
├── .gitignore                # 通用模板
├── LESSONS.md                # 核心原则 + 资产清单 + 迁移步骤(§二 反模式表已清空)
└── README.md                 # 改写为脚手架入口

删除内容(项目专属数据)

类别文件
业务代码backend/frontend/docker/scripts/docs/
根部署配置.cnb.ymldocker-compose.ymldocker-compose.test.yml
项目凭证.project.json.wecom-notify.json
轨迹文档CHECKPOINT.md(268 行项目演进轨迹)
FB 归档10 条历史 FB(FB-01~FB-10)
项目专属归档.codebuddy/rules/.archived/backend-development-python.md
Agent 运行态.codebuddy/daemon/.codebuddy/poll_state.json
重复目录顶层 skills/

清空为脚手架模板

文件清空内容保留内容
rules/.archived/feedback/README.md§四 索引表 10 条历史 FB状态机 / 模板 / 转化率算法 / 关联图等规格
rules/.archived/README.md退役规范表归档规范说明
LESSONS.md§二 15 条反模式对照表§一 核心原则 / §三 资产清单 / §四 迁移步骤 / §六 治理层索引
README.md电商 mini 业务四模块介绍脚手架入口 + 三层架构 + 首个需求指引
.env.exampleJava 特化变量技术栈中立的通用变量模板

抽象化自检

检查项结果
项目专属业务标识(USR-001 / PRD-001 / ORD-001 / PAY-001 / anta-workshopdemo / mini-commerce0 处
项目专属日期(2026-MM-DD0 处
项目专属类名(OrderService 作为示例除外)未见残留
lint0 错误
仓库跟踪文件数240+ → 57
代码行数+164 / -15195

新团队如何使用本脚手架

README.md 的"快速上手 4 步":

  1. Clone 本仓库作为新项目起点
  2. 拷贝 .env.example.env 填写实际值
  3. 按新项目技术栈调整 rules/project-architecture.md
  4. scaffold skill 生成第一个模块

后续触发 requirement-workflow,所有规则、治理框架立即生效。

为何这样做

前面 15 个 PR 的所有实践、踩坑、修复都已经提炼为规则和模板沉淀在 .codebuddy/ 三层结构中。具体的业务代码和历史数据对新团队没有价值——它们只是实践过程的副产物。

脚手架的价值在于「框架 + 方法论」而非「曾经写过什么业务」。重置后的仓库就是这套方法论的纯粹形态。

与历史数据的关系

所有被删除的内容在 Git 历史中完整保留(PR #1~#15 可追溯)。若新项目需要参考某个具体实现,可 git log 查找对应 commit。历史不是消失,只是从工作副本中清理掉,避免干扰新用户。

is using the merge method to merge intofbad178c
docs(governance): quality-dashboard 初始化阈值 + 新增 §七 可执行测量命令
added 2 commits
docs(checkpoint): 建立 CHECKPOINT.md 轨迹档案 + 2026-05 基线快照
docs(governance): quality-dashboard §7.2 明确 #14/#16 的 scope 排除 CHECKPOINT
feat(ci): 接入 CNB 流水线 + 7 个 POSIX shell 自举检查脚本
added 2 commits
feat(ci): abstraction_check.py 自动分类 + #16 从观测升级为阻塞
docs(checkpoint): 闭环 T-04 + 轮次 8 档案 + #16 阻塞升级文档同步
added 3 commits
合并来自 feature/abstraction-auto-classifier 的合并请求 #33
feat(ci): 迁移演练的两处脚本修补——白名单 + 迁移警告
docs(migration): T-03 闭环——首次冷启动迁移演练 + LESSONS §四 重写
added 5 commits
docs(meta): T-08 闭环——交叉引用同步 + 轮次 12 档案
docs(share): 对外分享材料——15 PR 治理经验提炼为可迁移模式
docs(rules): LESSONS §四 修订——覆盖首次演练错误描述 + A/B 分层 + 反模式 A7
docs(sample): 轮次 14-c——目标项目 anta-newproject-demo 推到 CNB + 首次远端 CI 全绿
docs(rules): git-conventions §四 新增 PR 描述规范 + LESSONS §二 B11 反模式
docs(rules): Q2-001 业务演练回写——scaffold §7~§9 + LESSONS B12 + testing-standards §1.3.1
docs(rules): 方向 F1 四 PR 经验回写——LESSONS B13/B14 + §1.3 口径区分 + CNB 坑点清单
docs(rules): Q3 周期启动——diag: commit type 正式化 + 信号欺骗家族分类
docs(share): workshop-share.md 新增 M9·CI 平台坑点实证清单(第 9 种治理模式)
docs(share): M9 新增"首次消费端实证"子节——ROI 完整闭环

Successfully merged and closed

branch can be safely deleted
Reviewer
None yet
Assignee
None yet
Label
None yet
Participant