From 86412192fdbb58ce92b8ebc89e38928fb9be14e7 Mon Sep 17 00:00:00 2001 From: Hermes Agent Date: Wed, 3 Jun 2026 15:56:03 +0800 Subject: [PATCH] docs(weekly): record 2026-05-28~06-03 cross-project learnings + 4 skills MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 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. --- ...26-06-03-WEEKLY-CROSS-PROJECT-LEARNINGS.md | 56 +++++++++++++++++++ 1 file changed, 56 insertions(+) create mode 100644 docs/2026-06-03-WEEKLY-CROSS-PROJECT-LEARNINGS.md diff --git a/docs/2026-06-03-WEEKLY-CROSS-PROJECT-LEARNINGS.md b/docs/2026-06-03-WEEKLY-CROSS-PROJECT-LEARNINGS.md new file mode 100644 index 00000000..20e82351 --- /dev/null +++ b/docs/2026-06-03-WEEKLY-CROSS-PROJECT-LEARNINGS.md @@ -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 已落地