feat(session-mechanism): 图模式补全自动化测试并接入技能入口

- graph/test_graphctl.py：新增 49 个用例，覆盖建图 / 校验硬错与警告 / 就绪集 /
  状态流转 / 非法操作 / 边界 / 写入范围隔离；实跑 Ran 49 tests OK（27.5s）
- graph/graphctl.py：修测试暴露的问题（+50/-10）
- graph/README.md：补「怎么跑测试」一节（+27 行）
- SKILL.md：目录树与入口指针登记 graph/（新增 4 行文档，机制行为零改动）
- 隔离性核对：collabd.py / goalctl.py / 两个看板 / 全部钩子 diff 为空；
  state.py 闸门读数绿、常驻心跳 7 秒、看板 20100 在听

session-mechanism/graph/README.md

@@ -81,7 +81,32 @@
 
 **两套可以同时存在**：图模式不读也不改现有那三份文件，现有机制也永远不会看到 `graph/` 目录。
 
-## 五、还没做的（下一步）
+## 五、怎么跑测试
+
+    python graph/test_graphctl.py -v
+
+全绿应看到 `Ran 49 tests ... OK`，用时 20 秒上下（每条用例起一次子进程）。
+
+测试只往临时目录写：`<GRAPH_TEST_TMP>/graph-test-<pid>/<用例名>`，默认 `GRAPH_TEST_TMP` = `AIProject/ai1net-dsh-server/tmp`，由每条用例的 `tearDown` ＋ 进程退出的 `atexit` 兜底删除。想换落点就设环境变量 `GRAPH_TEST_TMP`。
+
+清残留在本机是常态：跑完后 `tmp/` 下偶尔还能看到 `graph-test-<pid>/`（进程内已确认删空，是本机沙箱在进程退出后把删除路径又放回来了，与测试代码无关）。一条命令清掉：
+
+    rm -rf "E:/ProgramData/AIProject/ai1net-dsh-server/tmp"/graph-test-*
+
+八个用例类各管一摊：
+
+1、`T1_Init` —— 建图：`--kpi` 按条数生成节点（全角分号也认）、`--nodes-json` 带依赖与域、重复 id 报错、自动编号避让、`max_parallel`。
+2、`T2_CheckErrors` —— 硬错三条：环（含自环）、依赖指向不存在的节点、状态非法。
+3、`T3_CheckWarnings` —— 警告三类：无域、无判据、域重叠（`docs/` 与 `docs/ui/` 双向都算）。
+4、`T4_Ready` —— 就绪集：依赖未满足、域与在跑冲突、超 `max_parallel`（running 占名额）、两个域重叠的节点不进同一批。
+5、`T5_Flow` —— 流转：`pending→running→done`、`events.jsonl` 只追加、`blocked` 累加 `attempts`、回报后回带 `next_ready`。
+6、`T6_Illegal` —— 非法操作：`running`／`done` 再 `start` 拒绝，`blocked` 可重开；`--state` 只认 `done` / `blocked`；不存在的节点／图报错。
+7、`T7_Edge` —— 边界：单节点图、空节点图、gid 含中文（显式与自动生成各一条）、`list` 统计与空工作区。
+8、`T8_Isolation` —— 独立性：工作区里预埋的 `goal.json` / `tasks.json` / `collabd-state.json` 跑完字节不变，且不新建这类文件，写入范围只有 `<ws>/.workbuddy/graph/`。
+
+测试对 `graphctl.py` 的唯一要求是「能当命令行跑」，不 import 它的内部函数 —— 所以改内部实现不会连带改测试。
+
+## 六、还没做的（下一步）
 
 - 自动派活：读 `ready` 后自动建排期（要复用现有排期硬规则：cwds 正斜杠、workspace_scope、next_run_at 毫秒、scheduled_at ISO）。
 - 判定节点完成：现在靠回报 `--state done`，还没有「看证据够不够」的自动判定。