@fanchao8609/agent_brain_sync 1.7.2 → 1.7.3

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fanchao8609/agent_brain_sync",
-  "version": "1.7.2",
+  "version": "1.7.3",
   "description": "agent-brain-sync: 跨会话 AI 编码记忆 — hook 纯触发 + CLI/MCP 读写 .brain markdown 图谱, 防并发写保护。",
   "type": "module",
   "license": "MIT",

package/skill/SKILL.md

@@ -158,6 +158,12 @@ monorepo 若多个子包各自独立交付，可各建一份 `.brain/`。`abs st
    - 还没做完 → `abs todo note <id> --note "接到哪/改到哪个文件"` 补断点（别空手续接）。
    滞留没清完就不算接上了状态——这是「任务做完没进 Done」的根治动作。
 3. **读命中页**：按关键词在 index 定位 → 读对应 concepts/entities 全文。
+   > ⚠️ **绝不通读 `.brain/`**。它是一个不断长大的知识图谱，当前仓库 29 页就约 11 万 token
+   > （单页最大 16KB）—— 全读会把窗口直接塞满。正确姿势：
+   > - 要状态 → `abs load`｜要主题 → `abs query <词>`（只回命中几页）
+   > - 要某页 → 只读那一页；页太长则只取相关小节
+   > - 需要汇总多页/多命令时，用 context-mode 的 `ctx_execute` 类工具在沙箱里处理后
+   >   **只打印结论**，别把原始文件内容拉进上下文。
 4. **续 todo**：默认续 todo 分支 → 把顶部未完成项当当前任务开做。
 5. **登记新任务**：有明确新任务而 todo 没有 → `abs todo add <id> --note 做什么` 登记
    再动工。不登记，会话一切断就丢。