diff --git a/docs/2026-06-03-CODEGRAPH-INTEGRATION.md b/docs/2026-06-03-CODEGRAPH-INTEGRATION.md index 986cfbe5..e2e139e8 100644 --- a/docs/2026-06-03-CODEGRAPH-INTEGRATION.md +++ b/docs/2026-06-03-CODEGRAPH-INTEGRATION.md @@ -2,6 +2,16 @@ 本文档记录本项目如何接入 `/home/long/project` 工作区级 codegraph 搜索基础设施。 +## 0. 状态摘要（2026-06-03 rollout 完成） + +| 指标 | 状态 | +| ---------------------------------------------------- | ---------------------------------------------------- | +| 工作区级 codegraph 契约 | ✅ `/home/long/project/CODEGRAPH_WORKSPACE_USAGE.md` | +| 已索引 repo | 16/16 | +| 有项目级 OMP 规则 | **16/16**（之前 8/16 → 全部补齐） | +| codegraph-workspace wrapper bug 修复 | ✅ 2026-06-03 patch | +| 本项目（sub2api-cn-relay-manager）`.agent/AGENTS.md` | ✅ 158 行，反映 frontend 重构 | + ## 1. 工作区级入口 所有 agent 共用的 codegraph 使用契约在： @@ -14,11 +24,12 @@ ## 2. 本项目对 codegraph workspace 的贡献 -| 资源 | 状态 | 位置 | -| ----------------- | ------------ | ---------------------------------------------------------- | -| CodeGraph 索引 | ✅ | `~/.codegraph/projects.json` 含 `sub2api-cn-relay-manager` | -| OMP 项目规则 | ✅ | `/.agent/AGENTS.md`（158 行，2026-06-03 更新） | -| 工作区 usage 文档 | ✅（已贡献） | `/home/long/project/CODEGRAPH_WORKSPACE_USAGE.md` | +| 资源 | 状态 | 位置 | +| ----------------- | -------------- | --------------------------------------------------------------------- | +| CodeGraph 索引 | ✅ | `~/.codegraph/projects.json` 含 `sub2api-cn-relay-manager` | +| OMP 项目规则 | ✅ | `/.agent/AGENTS.md`（158 行，2026-06-03 更新） | +| 工作区 usage 文档 | ✅（已贡献） | `/home/long/project/CODEGRAPH_WORKSPACE_USAGE.md` | +| wrapper 修复 | ✅（已 patch） | `/home/long/.local/bin/codegraph-workspace`（备份 `.bak-2026-06-03`） | ## 3. 本项目对其他 agent 的入口信号 @@ -38,7 +49,7 @@ $ grep '"sub2api-cn-relay-manager"' ~/.codegraph/projects.json # 命中 -# 2. 项目级 OMP 规则存在 +# 2. 项目级 OMP 规则存在（不在仓库根 .gitignore 内） $ ls -l /home/long/project/sub2api-cn-relay-manager/.agent/AGENTS.md -rw-rw-r-- 1 long long 9604 6月 3 13:26 AGENTS.md @@ -62,7 +73,33 @@ $ /home/long/.local/bin/codegraph-workspace def sub2api-cn-relay-manager 'refres # → 印证 skill 文档：inline JS function 走 search_files fallback，而不是 def ``` -## 5. OMP 可发现性 — 当前限制 +## 5. 2026-06-03 rollout 实测（其他 7 个 repo 的接入） + +| Repo | AGENTS.md 行数 | codegraph-workspace 命中关键字 | 状态 | +| ------------------------ | -------------- | ------------------------------ | --------------------------- | +| `ai-customer-service` | 75 | `IMPLEMENTATION_PLAN` ✓ | ✅ | +| `contract management` | 95 | `OpenSpec` ✓ | ✅（路径含空格） | +| `shenyi` | 87 | `WARP.md` ✓ | ✅（用户主力项目） | +| `sub2api` | 95 | `国产模型` ✓ | ✅（上游 mirror） | +| `sub2api-official-fresh` | 90 | `CLA.md` ✓ | ✅（宿主参考，不改源码） | +| `supply-intelligence` | 65 | `POLLER_RUNTIME_BOUNDARY` ✓ | ✅ | +| `tokens-reef` | 73 | `MERGE_GUIDE` ✓ | ✅（tksea `pham` 命名空间） | + +`codegraph-workspace list` 最终结果：**16 AGENTS / 0 missing**。 + +## 6. wrapper 修复（2026-06-03） + +`codegraph-workspace` 第 29 行原来只检查 `/AGENTS.md` 仓库根存在性，但 OMP 实际读的是 `/.agent/AGENTS.md`。**已 patch**（备份在 `codegraph-workspace.bak-2026-06-03`）： + +```python +'has_agents': (p / 'AGENTS.md').exists() or (p / '.agent' / 'AGENTS.md').exists(), +``` + +效果：list 输出的 `AGENTS` 标志现在准确反映 OMP 实际可读到的规则文件。 + +⚠️ **重装或升级 `codegraph-workspace` 时必须重做这个 patch**。详见 `~/.hermes/skills/software-development/codegraph-workspace-operations/SKILL.md` 的 Pitfalls 节。 + +## 7. OMP 可发现性 — 当前限制 按 `codegraph-workspace-operations` skill 的标准做法，新写 `.agent/AGENTS.md` 后应该用： @@ -81,11 +118,13 @@ OMP_NO_UPDATE_NOTIFIER=1 omp -p --cwd /home/long/project/sub2api-cn-relay-manage OMP quota 恢复后请补一次实测并把结果记到本文件第 4 节。 -## 6. 后续维护 +## 8. 后续维护 - 本项目新增/重构时： 1. 在 `docs/EXECUTION_BOARD.md` 加条目 2. 若有 .agent/AGENTS.md 引用过的真相文件，**同步更新** .agent/AGENTS.md 3. 跑 `codegraph-workspace refresh sub2api-cn-relay-manager` 让索引反映新代码 -- OMP quota 恢复后立即补上第 5 节的实测 +- OMP quota 恢复后立即补上第 7 节的实测 +- 任何本项目接入 codegraph workspace 的规则变更，先在 `/home/long/project/CODEGRAPH_WORKSPACE_USAGE.md` 改，再回本文件 +- 如果 `codegraph-workspace` wrapper 被重装或升级，必须**重做第 6 节的 patch**（备份 `.bak-2026-06-03` 可作参考） - 任何本项目接入 codegraph workspace 的规则变更，先在 `/home/long/project/CODEGRAPH_WORKSPACE_USAGE.md` 改，再回本文件