Extensions: skills, plugins, MCP, sub-agents; configurable keys

- Skills (SKILL.md discovery, skill tool, /skills /skill)
- plugin.json exec tools with permission prompts, timeouts and workspace trust (/plugins)
- MCP stdio client: JSON-RPC initialize/tools/list/tools/call, mcp__server__tool, /mcp and sidebar status
- task tool with general/explore/plan and .agent/agents/*.md roles, parallel read-only runs, cancel propagation, /agents
- Keymap with Ctrl+X leader, keybinds.json overrides and /keys panel
- Collapsed thinking, throttled streaming Markdown, leaner tool output, parallel read-only tools
- Spawn: close-on-exec pipes and a process-wide fork lock
- Tests for keymap, skills, plugins, MCP, sub-agents, shell compaction; docs/plugins.md

README.md

@@ -246,6 +246,11 @@ cst-agent --headless --prompt 'List files'
 | `web_fetch` | 网络 | 抓取 URL，HTML 转纯文本 |
 | `todo_write` | 元 | 维护任务清单（TUI 右侧面板，Ctrl+T 开关） |
 | `ask_user` | 询问 | 向用户提问（可给选项）；headless 下返回错误让模型自行决定 |
+| `skill` | 元 | 加载一个 skill 的说明（`SKILL.md`）或其中的文件；有 skill 时才出现 |
+| `task` | 子 agent | 把独立任务交给子 agent（`general` / `explore` / `plan` / 自定义角色），只返回最终报告 |
+
+插件工具和 MCP 工具（`mcp__<server>__<tool>`）在运行时注册，和内置工具走同一套审批与 `/tools` 开关。
+同一步里的多个只读调用（读文件、搜索、只读子 agent）会并行执行（最多 4 个）。
 
 `--tools minimal` 只保留 `read_file` / `run_shell` / `write_file` / `apply_patch`（论文实验口径）。
 TUI 中 `/tools off NAME`、`/tools on NAME` 可临时开关单个工具。
@@ -281,8 +286,29 @@ TUI 中 `/tools off NAME`、`/tools on NAME` 可临时开关单个工具。
 - **AGENTS.md**：工作区根目录的 `AGENTS.md` 会注入 system prompt；`/init` 让 agent 自己生成一份。
 - **自动压缩**：上一轮 prompt 用到模型上下文 80% 时，下一轮开始前自动总结历史（`CST_AUTO_COMPACT=0` 关闭）。
 
+### 扩展：Skills、插件、MCP、子 agent
+
+`--tools minimal` 下这些都不加载（论文口径保持不变）。配置写法与示例见 [docs/plugins.md](docs/plugins.md)。
+
+- **Skills**：`<dir>/SKILL.md`（frontmatter `name` + `description`），放在工作区 `.agent/skills/`、`.claude/skills/`
+  或配置目录 `skills/`。system prompt 只放名字和一句描述，模型需要时调用 `skill(name)` 读全文；
+  `/skills` 浏览，`/skill NAME 任务` 直接带着某个 skill 开始一轮。
+- **插件**：`plugins/<name>/plugin.json` 声明外部命令工具（参数以 JSON 写到 stdin，stdout 即结果，`perm` 决定审批，
+  默认 60 s 超时），也可以附带 skills 目录和 MCP 服务器。
+- **MCP**：`mcp.json`（`{"mcpServers": {...}}`，与 Claude/Cursor 格式相同）里的 stdio 服务器在后台启动，
+  工具注册为 `mcp__<server>__<tool>`，默认按网络工具审批（`autoApprove` 可放行）。`/mcp` 看状态，侧栏显示连接数。
+- **工作区信任**：工作区里的 `.agent/plugins/` 和 `.agent/mcp.json` 会执行命令，默认不加载；
+  `/plugins trust` 后才生效（记在 `settings.json`）。配置目录（`~/.config/cst-agent/`）下的始终加载。
+- **子 agent**：`task(description, prompt, agent?)` 新开一个独立上下文跑完一轮，把最终报告交回主 agent。
+  内置 `general`（除 task 外全部工具）、`explore`（只读，可并行）、`plan`（只读，输出计划）；
+  `.agent/agents/*.md` 或配置目录 `agents/*.md` 可自定义角色（frontmatter `name / description / model / tools /
+  max_steps / readonly`，正文是角色说明）。子 agent 不能再开子 agent；Esc 会一并取消；它的审批弹窗标 `[角色名]`；
+  文件改动并入当前轮，`/undo` 一起撤销。转录在 `.agent/sessions/<会话>/sub-N.jsonl`，`/agents` 查看。
+
 ### TUI 快捷键
 
+默认 leader 是 **Ctrl+X**：先按 Ctrl+X，再按后面的字母。`/keys`（或 F1、Ctrl+X h）列出当前全部绑定。
+
 | 按键 | 说明 |
 |---|---|
 | Enter | 发送；busy 时入队 |
@@ -293,12 +319,37 @@ TUI 中 `/tools off NAME`、`/tools on NAME` 可临时开关单个工具。
 | Tab | 补全 `/命令` 和 `@文件`；没有可补全时切换 Build / Plan（Plan 只开放只读工具） |
 | Shift+Tab | 循环切换审批模式 ask → auto → yolo |
 | Ctrl+P | 命令面板（输入过滤，↑↓ / 鼠标选择） |
-| Ctrl+O / Ctrl+T | 展开最近 tool 输出 / 开关任务面板 |
-| PgUp / PgDn / 鼠标滚轮 | 滚动对话 |
+| Ctrl+O / Ctrl+R | 展开/折叠最近的 tool 输出 / 最近的 Thought |
+| Ctrl+T / Ctrl+L | 开关任务面板 / 重绘 |
+| PgUp / PgDn、Alt+↑ / Alt+↓、Ctrl+Home / Ctrl+End | 半页滚动、单行滚动、跳到开头 / 最新 |
+| Ctrl+X n / l | 新会话 / 会话列表 |
+| Ctrl+X m / p / e | 模型 / provider / 推理强度 |
+| Ctrl+X u / r / c | 撤销上一轮改动 / 重问 / 压缩上下文 |
+| Ctrl+X y / x | 复制上一条回复 / 导出记录 |
+| Ctrl+X t / d / s | 全部 Thought 默认展开或折叠 / 全部 tool 输出 / 侧栏 |
+| Ctrl+X a / k / g | 子 agent 面板 / skills / 插件 |
+| Ctrl+X h、F1 / Ctrl+X q | 快捷键列表 / 退出 |
 | 鼠标点击 | 展开/折叠 tool 卡片和 Thought、在输入框里定位光标、点模式行切换 Build/Plan、在选择框里选中（`/mouse` 关闭后可用终端原生选择复制） |
 | Esc | 取消当前 turn（不会退出） |
 | Ctrl+C 两次 / 空输入 Ctrl+D | 退出 |
 
+Thought（推理过程）默认折叠成一行“Thought · 3.2s”，生成中显示实时计时；`/thinking on` 改为默认展开。
+
+**自定义按键**：`~/.config/cst-agent/keybinds.json`，键是动作名（`/keys` 里能看到），值是一个或多个按键，
+`"none"` 解除绑定：
+
+```json
+{
+  "leader": "ctrl+x",
+  "new_session": ["<leader> n", "f2"],
+  "toggle_thought": "ctrl+g",
+  "todo": "none"
+}
+```
+
+按键写法：`ctrl+x`、`alt+b`、`shift+tab`、`f1`…`f12`、`pgup`、`home`、`<leader> n`。
+写错的条目会被跳过并在 `/keys` 里提示，其余照常生效。
+
 ### 斜杠命令
 
 输入 `/` 弹出补全；唯一前缀即可（如 `/st` → `/status`）。标 * 的命令在模型运行中也能用。
@@ -320,7 +371,11 @@ TUI 中 `/tools off NAME`、`/tools on NAME` 可临时开关单个工具。
 | `/compact` | 手动压缩上下文 |
 | `/export [file]` *、`/copy` * | 导出 Markdown 记录；复制上一条回复（OSC 52，需终端支持） |
 | `/init` | 让 agent 写 `AGENTS.md` |
-| `/details` *、`/quit` * | 展开全部 tool 输出；退出 |
+| `/details` *、`/thinking [on\|off]`、`/keys` * | 展开全部 tool 输出；Thought 默认展开/折叠；快捷键列表 |
+| `/skills [reload\|list]`、`/skill <name> [任务]` | 浏览 skills；带着某个 skill 开始一轮 |
+| `/plugins [trust\|untrust\|reload]`、`/mcp [reload]` | 插件与工作区信任；MCP 服务器状态 |
+| `/agents` | 子 agent 角色与本会话的子 agent 记录（可查看转录） |
+| `/quit` * | 退出 |
 
 ### 协议