docs(weekly): record 2026-05-28~06-03 cross-project learnings + 4 skills
7-day window 220 commits across 3 active repos (sub2api-cn-relay-manager 115, user-system 72, llm-intelligence 33). 4 cross-project patterns extracted into hermes-global skills: 1. numbered-task-board — M-/H-/B- + T-Data- prefix systems 2. six-stage-pipeline-verify — schema→lib→importer→fixture→real-dry→real-upsert 3. docs-only-commit — code/docs commits never mixed 4. test-coverage-iteration-workflow — per-module 30-100 test funcs Each skill cites the source commits / files for verifiability. This sub2api-cn-relay-manager view focuses on what the project contributed. Docs-only commit (skill #3 in action). No code changes.
This commit is contained in:
56
docs/2026-06-03-WEEKLY-CROSS-PROJECT-LEARNINGS.md
Normal file
56
docs/2026-06-03-WEEKLY-CROSS-PROJECT-LEARNINGS.md
Normal file
@@ -0,0 +1,56 @@
|
||||
# 2026-06-03 跨项目周度经验 (sub2api-cn-relay-manager 视角)
|
||||
|
||||
> 完整总结在 `~/.hermes/docs/2026-06-03-WEEKLY-CROSS-PROJECT-LEARNINGS.md`(hermes 全局层)。本文件只记录本项目相关的子集 + 引用。
|
||||
|
||||
## 本项目 7 天主线
|
||||
|
||||
7 天内 115 commits,主要工作:
|
||||
|
||||
1. **Frontend 设计系统重构** — portal.css/portal.js + 8 个页面迁移 + dedup + Provider 字段 UX
|
||||
2. **M-/H-/B- 编号任务驱动** — M-01..M-04, H-01..H-05, B-01..B-04 共 12 个 task
|
||||
3. **测试覆盖 M-01..M-04** — panic 替换 / errs 包 / 边界测试 / 版本端点
|
||||
4. **Prometheus + Grafana 监控栈** — 完整 metrics/log/alert 集成
|
||||
5. **CRM 部署到 remote43** — 35447be9
|
||||
6. **工具接入** — codegraph-workspace + understand-anything 在 16 repo 接入(4 个 docs commits: d493e974, c079b8ab, 77f40c2b, d6a0261a)
|
||||
|
||||
## 沉淀到 hermes 全局层的 4 个 skill
|
||||
|
||||
本项目贡献了以下跨项目可复用模式:
|
||||
|
||||
1. **numbered-task-board** (`~/.hermes/skills/software-development/numbered-task-board/SKILL.md`)
|
||||
- 直接源自本项目 M-/H-/B- 编号系统
|
||||
- llm-intelligence 的 T-Data- 体系也用同样模式
|
||||
|
||||
2. **six-stage-pipeline-verify** (`~/.hermes/skills/software-development/six-stage-pipeline-verify/SKILL.md`)
|
||||
- 本项目 6 维度 PRODUCTION-VALIDATION-REPORT 是 half
|
||||
- llm-intelligence 的 6-stage verify script 是另一半
|
||||
|
||||
3. **docs-only-commit** (`~/.hermes/skills/software-development/docs-only-commit/SKILL.md`)
|
||||
- 本项目 36 个 docs commits 全部 docs-only
|
||||
- 0 个 commit 混 code+docs
|
||||
|
||||
4. **test-coverage-iteration-workflow** (`~/.hermes/skills/software-development/test-coverage-iteration-workflow/SKILL.md`)
|
||||
- 直接源自 user-system 40 个 test commits
|
||||
- 本项目 test(quality) 8 commits 印证
|
||||
|
||||
## 本项目独有的项目级 skill(不提升为通用)
|
||||
|
||||
- `.agent/skills/remote-truth-closure` — 本项目 long-running 任务的"本地 → 提交 → 推送 → 远端部署 → 真验 → 状态板"强约束
|
||||
- `.agent/skills/routing-data-plane-e2e` — 路由 + data plane 闭环验收
|
||||
- `.agent/skills/false-negative-status-triage` — 状态语义修正(`provider_status` vs 真实 `access_status`)
|
||||
|
||||
这 3 个是 sub2api-cn-relay-manager 特定(依赖 routing / provider 概念),其他项目不直接复用。
|
||||
|
||||
## 完整 220-commit 跨项目分析
|
||||
|
||||
详见 hermes 全局 doc:
|
||||
|
||||
- `~/.hermes/docs/2026-06-03-WEEKLY-CROSS-PROJECT-LEARNINGS.md` — 完整分析 + 沉淀元数据
|
||||
- `~/.hermes/docs/2026-06-03-UNDERSTAND-ANYTHING-ENRICH-BATCH.md` — 16/16 repo LLM enrich 报告
|
||||
- `~/.hermes/docs/2026-06-03-UNDERSTAND-ANYTHING-BATCH.md` — 16/16 repo 离线 graph 报告
|
||||
|
||||
## 后续可改进
|
||||
|
||||
- 本项目的 docs/ 已有 28+ doc 文件,**docs-only commit** 已是稳定模式,但偶尔会跟 code commit 混(sibling 工作可见)
|
||||
- M-/H-/B- 编号系统运行良好,T- 类(feature track)尚未在本项目启用
|
||||
- 6-stage pipeline verify 在本项目未启用(无数据 ingestion 流程),但 6 维度 PRODUCTION-VALIDATION-REPORT 已落地
|
||||
Reference in New Issue
Block a user