docs(skills): 按需插件 skill 对齐仓内规范 + 文件操作强制走 files 插件

## 1. 文件操作必须走 files 插件（用户明确要求）

旧 skill 写着「如果你已经有 run_shell / bash 之类的能力，优先用那个 —— 它更直接」，
与「文件操作必须走 files_*」相悖。改为：

- 所有已知内容的读写一律 files_read/files_write/files_edit/files_edit_line；
- 不用 cat/echo/sed/tee/重定向代替（shell 拼长文本会被引号转义吃掉，
  且重定向会截断原文件，而本插件是原子写 + 写前留档）；
- 唯一例外：文件是命令的副产物（go build -o、git clone、日志重定向）。

cmd-tools skill 同步补一条：文件读写不要用 shell 代替。

## 2. 三个新 skill 对齐 ai_image 等既有规范

- 结构统一为：什么时候用 / 先拉起插件（plugin_start 代码块）/ 工具表 /
  用完可释放（plugin_stop）/ 注意 / 「plugin_stop vs plugin_disable」对照表；
- 修正上一版的错误：把 `plugin_enable` 写成拉起方式 —— 那是**持久**解禁，
  会改开机行为；按需拉起应使用 `plugin_start name=<插件>`。
- files skill 保持 auto_start=false（与「大部分插件不需要自启」一致），
  但把「怎么拉起」写清楚。

## 3. cmd_run 描述补充能力边界

「经完整 bash 执行，支持管道、分号、&&、命令替换、heredoc、重定向；
不支持交互（vim/ssh/top 用 terminal_create）」。

验证：四工程 hmapdev 构建通过；本机重装后 skills_registered=1；
问 agent 写文件时它先 plugin_start 再 files_write/files_read，未用 shell 代替。

example/cmd/skill/cmd-tools/SKILL.md

@@ -1,23 +1,54 @@
 ---
 name: cmd-tools
-description: 在沙箱工作目录里执行 shell 命令（cmd_run）。按需加载：先 plugin_enable 再调用，用完可 plugin_stop 释放上下文。
+description: 一次性 shell 命令执行（cmd_run），支持管道/heredoc/重定向。按需工具：先 plugin_start cmd，用完可 plugin_stop。
 ---
 
 # 命令执行
 
-## 本插件是按需加载（auto_start: false）
+## 什么时候用
 
-它只在你真的要跑命令时才需要。要先用 `plugin_enable("cmd")` 拉起，
-否则 `cmd_run` 不在工具清单里（不是坏了，是还没装上）。
+需要跑一条**不需要交互**的 shell 命令时：查系统信息、跑脚本、批量处理文件、
+`git`/`go`/`python` 之类的一次性调用。
 
-## 工具
+需要**持续输入**的程序（vim、top、ssh 会话）不要用本插件，用 agentcli 的
+`terminal_create` / `terminal_write` / `terminal_read`。
+
+## 先拉起插件
+
+```
+plugin_start  name=cmd
+```
 
 | 工具 | 用途 |
 |---|---|
-| `cmd_run` | 执行 shell 命令，返回 stdout/stderr/exit_code |
+| `cmd_run` | 执行一条命令，返回 stdout/stderr/exit_code |
+
+参数：`command`（必填）、`timeout`（如 30s/5m，默认 30s）、`workdir`。
+
+## 用完可释放
+
+```
+plugin_stop  name=cmd
+```
 
 ## 注意
 
-- 超时可用参数 `timeout`（如 "30s" / "5m"）指定，超过后命令被终止。
-- 长驻进程请用 `agentcli` 的 `terminal_*`（PTY 会话），不要用 cmd_run 挂着。
-- 危险命令（rm -rf、写系统目录）先向用户确认。
+- 经完整 bash 执行：管道、`;`、`&&`、`$()`、heredoc、重定向都可用。
+- 长驻进程别用 cmd_run 挂着等它退出，那会撞 timeout；用终端工具。
+- **文件读写不要用 shell 代替**（`cat`/`echo`/`sed`/`tee`/重定向）：文件里有已知内容要写、
+  或要读文件内容时，走 files 插件的 `files_read`/`files_write`/`files_edit`。
+  只有当文件是命令的副产物（`go build -o`、`git clone`、日志重定向）才由命令自己产生。
+- 危险命令（`rm -rf`、写系统目录）先向用户确认。
+
+## ★ 用 plugin_stop / plugin_start，不要用 plugin_disable / plugin_enable
+
+| 工具 | 作用 | 跨重启 |
+|---|---|---|
+| `plugin_stop` | **运行态**关闭，现在停掉 | **不影响**，重启照常加载 |
+| `plugin_start` | **运行态**拉起，现在开回来 | 不影响 |
+| `plugin_disable` | **持久**禁用 | **会记下来**，开机也不自启 |
+| `plugin_enable` | 解除持久禁用 | 会记下来 |
+
+**释放上下文用 `plugin_stop`。** 用 `plugin_disable` 会顺手把"开机自启"
+永久关掉。本插件声明 `auto_start: false`，本来就不自启；但 `plugin_disable`
+仍会写进持久禁用清单，让 `plugin_start` 拒绝拉起。