logo
0
0
WeChat Login

docs: 10 轮迭代经验决算 LESSONS.md + 改造 README#5

Merged
created 2 weeks ago
main
docs/lessons-summary
Edit
OverviewCommits
1
Files changed
2
Attachments

背景

10 轮迭代后的收官。CHECKPOINT.md 是过程日志,越写越长(200+ 行),信噪比下降。需要一份与它互补的结论性文档:任何人 10 分钟读完就能带走经验。

新增 LESSONS.md(95 行)

四个板块:

  1. 核心原则 × 4(按重要性排序):真实编译 / 可自举 / 契约优先 / 抽象化
  2. 10 条反模式 vs 正模式对照表,每条附「在哪防御」链接
  3. 工程资产清单(13 项),可直接拷贝到新项目
  4. 迁移到新项目的最小步骤(6 步)+ 已知边界

抽象度自查(符合自定义原则)

  • 无日期、无具体测试数字、无业务编号、无项目专属类名
  • 符合「拷到新项目直接能用」的目标

重写 README.md

从 1 行扩到 66 行,按读者角色导航。

关系梳理

  • README.md(入口,1 分钟)
  • LESSONS.md(结论,10 分钟)— 新
  • CHECKPOINT.md(轨迹,30 分钟)
  • .codebuddy/README.md(规则索引)

验证

  • lint 0 错误
  • LESSONS 95 行(目标 ≤ 150)
  • 0 处项目专属残留
is using the squash method to merge into8a4320eb
added 3 commits
docs: 10 轮迭代经验决算 LESSONS.md + 改造 README (#5)
docs(skills): Agent Harness v2 规格 + skills 依赖图 + 契约校验
feat(ci): 迁移演练的两处脚本修补——白名单 + 迁移警告
docs(meta): CHECKPOINT §四 轮次 14-e 追加——方向 F1 四 PR 经验回写档案
docs(share): workshop-share.md 新增 M9·CI 平台坑点实证清单(第 9 种治理模式)

Successfully merged and closed

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