Skip to content

Commit f8ab503

Browse files
committed
feat: 清除全部待办项 — Task/Subagent、权限系统、新MCP服务
- 08-Agent-SDK 新增 3.5 节:Task 工具与子代理编排 - 子代理类型表(Explore/Bash/code-reviewer/Plan等) - 任务依赖 DAG 系统说明 - 上下文注入三种方式(Skills/Memory/工具控制) - 02-基础使用 权限系统更新 - 三种权限模式(plan/acceptEdits/bypassPermissions) - Shift+Tab 循环切换说明 - allowedTools 安全替代方案 - 04-MCP集成 新增三项 MCP 服务 - MCP Apps 交互式界面 - 工具懒加载 ToolSearch(v2.1.45+,上下文减少95%) - 远程 MCP 服务器(HTTP 传输) - README 待办项标记为已完成
1 parent 844a238 commit f8ab503

4 files changed

Lines changed: 118 additions & 4 deletions

File tree

README.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -296,10 +296,10 @@ Week 8 :OpenClaw 多Agent + Docker部署 + 安全
296296
- 回复 Issue #5:连接失败排查步骤(HTTPS 代理配置)
297297
- 回复 Issue #2:SQLite MCP 包名验证与替代方案
298298

299-
**待办(下一轮迭代**
300-
- 补充 Task 工具和子代理(Subagent)系统文档
301-
- 补充权限系统更新说明
302-
- 补充新 MCP 服务集成说明
299+
**已完成(原待办项**
300+
- ✅ 08-Agent-SDK 新增 3.5 节:Task 工具与子代理编排(CLI 内置 Subagent 系统)
301+
- ✅ 02-基础使用 /permissions 节新增权限模式切换、allowedTools 配置说明
302+
- ✅ 04-MCP集成 新增 MCP Apps、工具懒加载(v2.1.45+)、远程 MCP 服务器说明
303303

304304
### v1.0 (2026-02-11) — 初始发布
305305

docs/claude-code/02-基础使用完整指南.md

Lines changed: 30 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -884,6 +884,36 @@ Bash Commands:
884884
⚠ Dangerous commands (require confirmation)
885885
```
886886

887+
**权限模式切换**`Shift + Tab`):
888+
889+
Claude Code 提供三种权限模式,交互模式中按 `Shift + Tab` 循环切换:
890+
891+
| 模式 | 行为 | 适用场景 |
892+
|------|------|----------|
893+
| **plan** | 只分析不修改,纯只读 | 代码审查、安全探索 |
894+
| **acceptEdits** | 自动接受文件编辑(仍确认危险命令) | 信任项目、快速原型 |
895+
| **bypassPermissions** | 跳过所有确认提示 | 仅限隔离容器环境 |
896+
897+
**配置层级**(优先级从高到低):
898+
899+
```
900+
企业设置 > 项目本地(.claude/settings.local.json) > 项目(.claude/settings.json) > 用户(~/.claude/settings.json)
901+
```
902+
903+
**allowedTools(推荐替代方案)**
904+
905+
相比危险的 `--dangerously-skip-permissions` 全局跳过,更安全的做法是在配置中精确指定允许的工具:
906+
907+
```json
908+
{
909+
"permissions": {
910+
"allowedTools": ["Read", "Grep", "Glob", "Edit"]
911+
}
912+
}
913+
```
914+
915+
> ⚠️ **安全提醒**`--dangerously-skip-permissions` 会移除所有确认提示,仅适用于 Docker/VM 等隔离环境中的自动化任务,日常开发请使用 `allowedTools` 精细控制。
916+
887917
---
888918

889919
### 4.7 开发辅助命令

docs/claude-code/04-MCP集成完整指南.md

Lines changed: 37 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -823,6 +823,43 @@ Claude Code:
823823
3. [返回] React 19新特性包括:...
824824
```
825825

826+
> **注意**:Context7 免费额度为每月 1,000 次请求(2026年1月从 6,000 次下调),每小时限 60 次。超出需配置 API Key。
827+
828+
#### MCP Apps(交互式界面)
829+
830+
> **功能**:MCP 服务器可提供交互式用户界面,直接在聊天中渲染图表、表单、仪表盘
831+
832+
这是 2026 年初新增的能力——MCP 服务器不再只是返回文本数据,还可以返回可交互的 UI 组件。这意味着你可以在 Claude Code 的对话中直接操作第三方工具的界面,无需切换到外部应用。
833+
834+
#### MCP 工具懒加载(v2.1.45+)
835+
836+
> **功能**:延迟加载 MCP 工具定义,减少上下文占用高达 95%
837+
838+
当你配置了大量 MCP 服务器时,旧版本会把所有工具描述一次性加载到上下文窗口,浪费大量 token。v2.1.45+ 引入了 **ToolSearch 懒加载机制**——只有在需要时才加载对应工具。
839+
840+
**使用方式**(自动生效,无需配置):
841+
842+
```
843+
你:帮我查一下Slack里的消息
844+
845+
Claude Code:
846+
1. [ToolSearch] 搜索 "slack" → 找到 mcp__slack__read_channel
847+
2. [加载] 按需加载 slack 工具定义
848+
3. [调用] mcp__slack__read_channel(...)
849+
```
850+
851+
#### 远程 MCP 服务器
852+
853+
> **功能**:支持连接远程运行的 MCP 服务器(HTTP 传输),不限于本地进程
854+
855+
配置远程 MCP 服务器:
856+
857+
```bash
858+
claude mcp add --transport http my-remote-server https://your-server.com/mcp
859+
```
860+
861+
适用于团队共享的 MCP 服务(如共享数据库、内部 API 网关等)。
862+
826863
#### Memory(持久化记忆)
827864

828865
> **功能**:跨会话保存信息,记住用户偏好和项目上下文

docs/claude-code/08-Agent-SDK完整指南.md

Lines changed: 47 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -748,6 +748,53 @@ async for message in query(prompt=prompt, options=options):
748748
# 处理消息...
749749
```
750750

751+
### 3.5 Task 工具与子代理编排(CLI 内置)
752+
753+
> **补充说明**:上面 3.4 节讲的是 SDK 中如何编程创建子代理。这里介绍 Claude Code CLI 中**内置的 Task 工具**——你在交互模式下就能直接使用的多 Agent 编排系统。
754+
755+
Claude Code CLI 内置了强大的 **Task 工具**,无需写代码就能让 Claude 自动创建子代理:
756+
757+
**核心参数**
758+
759+
| 参数 | 说明 |
760+
|------|------|
761+
| `subagent_type` | 子代理类型(Explore、Bash、code-reviewer 等) |
762+
| `prompt` | 分配给子代理的任务描述 |
763+
| `isolation` | 设为 `"worktree"` 可在独立工作树中运行 |
764+
| `run_in_background` | 设为 `true` 在后台运行 |
765+
| `resume` | 传入之前的 agent ID 可恢复中断的子代理 |
766+
| `model` | 可指定 sonnet/opus/haiku,不指定则继承父级 |
767+
768+
**常用子代理类型**
769+
770+
| 类型 | 用途 | 可用工具 |
771+
|------|------|----------|
772+
| `Explore` | 快速搜索代码库(Haiku 驱动,速度最快) | Read、Grep、Glob |
773+
| `Bash` | 执行终端命令、git 操作 | Bash |
774+
| `code-reviewer` | 代码审查 | Read、Grep、Glob、Bash |
775+
| `general-purpose` | 通用多步骤任务 | 全部工具 |
776+
| `Plan` | 设计实现方案 | 全部(不含写入) |
777+
778+
**任务依赖(DAG 系统)**
779+
780+
Task 工具支持有向无环图(DAG)依赖关系——任务 C 可以等待任务 A 和任务 B 完成后再执行:
781+
782+
```
783+
任务A: 构建API ──┐
784+
├──→ 任务C: 运行集成测试
785+
任务B: 配置认证 ──┘
786+
```
787+
788+
**子代理上下文注入**
789+
790+
子代理获取上下文的三种方式:
791+
792+
1. **Skills 注入**:在定义中指定 skills 字段,完整技能内容直接注入子代理
793+
2. **Memory 持久化**:子代理可拥有持久记忆目录,跨会话积累知识
794+
3. **工具访问控制**:通过 `allowedTools` / `disallowedTools` 精细控制子代理能力
795+
796+
> 💡 **提示**:子代理不能再创建子代理(只有一层嵌套),最多可同时运行 10 个并行子代理。
797+
751798
---
752799

753800
## 第四部分:实战项目

0 commit comments

Comments
 (0)