@baimingtao/lbs-agent 1.0.0

package/extensions/skills/builtin/autonomous-ai-agents/claude-code/SKILL.md

@@ -0,0 +1,669 @@
+---
+name: claude-code
+description: "将编码任务委派给 Claude Code CLI (功能、PR)。"
+version: 2.2.0
+author: Hermes Agent + Teknium
+license: MIT
+platforms: [linux, macos, windows]
+metadata:
+  hermes:
+    tags: [Coding-Agent, Claude, Anthropic, Code-Review, Refactoring, PTY, Automation]
+    related_skills: [codex, hermes-agent, opencode]
+---
+
+# Claude Code — Hermes 编排指南
+
+通过 Hermes 终端将编码任务委派给 [Claude Code](https://code.claude.com/docs/en/cli-reference)（Anthropic 的自主编码 agent CLI）。Claude Code v2.x 能够自主读取文件、编写代码、运行 shell 命令、生成 subagents 以及管理 git 工作流。
+
+## 前置条件
+
+- **安装:** `npm install -g @anthropic-ai/claude-code`
+- **Auth:** 运行一次 `claude` 以登录（Pro/Max 用户使用浏览器 OAuth，或设置 `ANTHROPIC_API_KEY`）
+- **Console auth:** `claude auth login --console` 用于 API key 计费
+- **SSO auth:** `claude auth login --sso` 用于企业版
+- **检查状态:** `claude auth status` (JSON) 或 `claude auth status --text` (人类可读)
+- **健康检查:** `claude doctor` — 检查自动更新程序和安装健康状况
+- **版本检查:** `claude --version` (要求 v2.x+)
+- **更新:** `claude update` 或 `claude upgrade`
+
+## 两种编排模式
+
+Hermes 以两种根本不同的方式与 Claude Code 交互。请根据任务进行选择。
+
+### 模式 1：Print 模式 (`-p`) — 非交互式（大多数任务的首选）
+
+Print 模式运行一次性任务，返回结果并退出。无需 PTY。没有交互式提示。这是最简洁的集成路径。
+
+```
+terminal(command="claude -p 'Add error handling to all API calls in src/' --allowedTools 'Read,Edit' --max-turns 10", workdir="/path/to/project", timeout=120)
+```
+
+**何时使用 print 模式：**
+- 一次性编码任务（修复 bug、添加功能、重构）
+- CI/CD 自动化和脚本编写
+- 使用 `--json-schema` 进行结构化数据提取
+- 管道输入处理（`cat file | claude -p "analyze this"`）
+- 任何不需要多轮对话的任务
+
+**Print 模式会跳过所有交互式对话框** — 没有工作区信任提示，没有权限确认。这使其成为自动化的理想选择。
+
+### 模式 2：通过 tmux 进行交互式 PTY — 多轮会话
+
+交互式模式为您提供了一个完整的对话式 REPL，您可以在其中发送后续提示、使用 slash commands 并实时查看 Claude 的工作。**需要 tmux 编排。**
+
+```
+# Start a tmux session
+terminal(command="tmux new-session -d -s claude-work -x 140 -y 40")
+
+# Launch Claude Code inside it
+terminal(command="tmux send-keys -t claude-work 'cd /path/to/project && claude' Enter")
+
+# Wait for startup, then send your task
+# (after ~3-5 seconds for the welcome screen)
+terminal(command="sleep 5 && tmux send-keys -t claude-work 'Refactor the auth module to use JWT tokens' Enter")
+
+# Monitor progress by capturing the pane
+terminal(command="sleep 15 && tmux capture-pane -t claude-work -p -S -50")
+
+# Send follow-up tasks
+terminal(command="tmux send-keys -t claude-work 'Now add unit tests for the new JWT code' Enter")
+
+# Exit when done
+terminal(command="tmux send-keys -t claude-work '/exit' Enter")
+```
+
+**何时使用交互式模式：**
+- 多轮迭代工作（重构 → 审查 → 修复 → 测试循环）
+- 需要人工介入决策的任务
+- 探索性编码会话
+- 当您需要使用 Claude 的 slash commands（`/compact`, `/review`, `/model`）时
+
+## PTY 对话框处理（对交互式模式至关重要）
+
+Claude Code 在首次启动时会显示最多两个确认对话框。您必须通过 tmux send-keys 处理这些对话框：
+
+### 对话框 1：工作区信任（首次访问目录时）
+```
+❯ 1. Yes, I trust this folder    ← DEFAULT (just press Enter)
+  2. No, exit
+```
+**处理：** `tmux send-keys -t <session> Enter` — 默认选择是正确的。
+
+### 对话框 2：跳过权限警告（仅在使用 --dangerously-skip-permissions 时）
+```
+❯ 1. No, exit                    ← DEFAULT (WRONG choice!)
+  2. Yes, I accept
+```
+**处理：** 必须先按向下键（DOWN），然后按回车（Enter）：
+```
+tmux send-keys -t <session> Down && sleep 0.3 && tmux send-keys -t <session> Enter
+```
+
+### 稳健的对话框处理模式
+```
+# Launch with permissions bypass
+terminal(command="tmux send-keys -t claude-work 'claude --dangerously-skip-permissions \"your task\"' Enter")
+
+# Handle trust dialog (Enter for default "Yes")
+terminal(command="sleep 4 && tmux send-keys -t claude-work Enter")
+
+# Handle permissions dialog (Down then Enter for "Yes, I accept")
+terminal(command="sleep 3 && tmux send-keys -t claude-work Down && sleep 0.3 && tmux send-keys -t claude-work Enter")
+
+# Now wait for Claude to work
+terminal(command="sleep 15 && tmux capture-pane -t claude-work -p -S -60")
+```
+
+**注意：** 首次接受某个目录的信任后，信任对话框就不会再出现。只有权限对话框会在您每次使用 `--dangerously-skip-permissions` 时重复出现。
+
+## CLI 子命令
+
+| 子命令 | 用途 |
+|------------|---------|
+| `claude` | 启动交互式 REPL |
+| `claude "query"` | 以初始 prompt 启动 REPL |
+| `claude -p "query"` | Print 模式（非交互式，完成后退出） |
+| `cat file \ | claude -p "query"` | 将内容作为 stdin 上下文管道输入 |
+| `claude -c` | 在当前目录继续最近的对话 |
+| `claude -r "id"` | 通过 ID 或名称恢复特定会话 |
+| `claude auth login` | 登录（添加 `--console` 用于 API 计费，`--sso` 用于企业版） |
+| `claude auth status` | 检查登录状态（返回 JSON；`--text` 用于人类可读格式） |
+| `claude mcp add <name> -- <cmd>` | 添加 MCP server |
+| `claude mcp list` | 列出已配置的 MCP server |
+| `claude mcp remove <name>` | 移除 MCP server |
+| `claude agents` | 列出已配置的 agents |
+| `claude doctor` | 对安装和自动更新程序进行健康检查 |
+| `claude update` / `claude upgrade` | 将 Claude Code 更新到最新版本 |
+| `claude remote-control` | 启动服务器以从 claude.ai 或移动应用控制 Claude |
+| `claude install [target]` | 安装原生构建版本（稳定版、最新版或特定版本） |
+| `claude setup-token` | 设置长期 auth token（需要订阅） |
+| `claude plugin` / `claude plugins` | 管理 Claude Code 插件 |
+| `claude auto-mode` | 检查 auto mode 分类器配置 |
+
+## Print 模式深入解析
+
+### 结构化 JSON 输出
+```
+terminal(command="claude -p 'Analyze auth.py for security issues' --output-format json --max-turns 5", workdir="/project", timeout=120)
+```
+
+返回一个 JSON 对象，包含：
+```json
+{
+  "type": "result",
+  "subtype": "success",
+  "result": "The analysis text...",
+  "session_id": "75e2167f-...",
+  "num_turns": 3,
+  "total_cost_usd": 0.0787,
+  "duration_ms": 10276,
+  "stop_reason": "end_turn",
+  "terminal_reason": "completed",
+  "usage": { "input_tokens": 5, "output_tokens": 603, ... },
+  "modelUsage": { "claude-sonnet-4-6": { "costUSD": 0.078, "contextWindow": 200000 } }
+}
+```
+
+**关键字段：** 用于恢复的 `session_id`，用于 agentic 循环计数的 `num_turns`，用于支出跟踪的 `total_cost_usd`，用于检测成功/错误的 `subtype`（`success`, `error_max_turns`, `error_budget`）。
+
+### 流式 JSON 输出
+要实现实时的 token 流式传输，请使用 `stream-json` 和 `--verbose`：
+```
+terminal(command="claude -p 'Write a summary' --output-format stream-json --verbose --include-partial-messages", timeout=60)
+```
+
+返回换行符分隔的 JSON 事件。使用 jq 过滤以获取实时文本：
+```
+claude -p "Explain X" --output-format stream-json --verbose --include-partial-messages | \
+  jq -rj 'select(.type == "stream_event" and .event.delta.type? == "text_delta") | .event.delta.text'
+```
+
+流事件包含带有 `attempt`、`max_retries` 和 `error` 字段（例如 `rate_limit`、`billing_error`）的 `system/api_retry`。
+
+### 双向流式传输
+要实现实时的输入和输出流式传输：
+```
+claude -p "task" --input-format stream-json --output-format stream-json --replay-user-messages
+```
+`--replay-user-messages` 将用户消息重新发送到 stdout 以作确认。
+
+### 管道输入
+```
+# Pipe a file for analysis
+terminal(command="cat src/auth.py | claude -p 'Review this code for bugs' --max-turns 1", timeout=60)
+
+# Pipe multiple files
+terminal(command="cat src/*.py | claude -p 'Find all TODO comments' --max-turns 1", timeout=60)
+
+# Pipe command output
+terminal(command="git diff HEAD~3 | claude -p 'Summarize these changes' --max-turns 1", timeout=60)
+```
+
+### 用于结构化提取的 JSON Schema
+```
+terminal(command="claude -p 'List all functions in src/' --output-format json --json-schema '{\"type\":\"object\",\"properties\":{\"functions\":{\"type\":\"array\",\"items\":{\"type\":\"string\"}}},\"required\":[\"functions\"]}' --max-turns 5", workdir="/project", timeout=90)
+```
+
+从 JSON 结果中解析 `structured_output`。Claude 会在返回前根据 schema 验证输出。
+
+### 会话延续
+```
+# Start a task
+terminal(command="claude -p 'Start refactoring the database layer' --output-format json --max-turns 10 > /tmp/session.json", workdir="/project", timeout=180)
+
+# Resume with session ID
+terminal(command="claude -p 'Continue and add connection pooling' --resume $(cat /tmp/session.json | python3 -c 'import json,sys; print(json.load(sys.stdin)[\"session_id\"])') --max-turns 5", workdir="/project", timeout=120)
+
+# Or resume the most recent session in the same directory
+terminal(command="claude -p 'What did you do last time?' --continue --max-turns 1", workdir="/project", timeout=30)
+
+# Fork a session (new ID, keeps history)
+terminal(command="claude -p 'Try a different approach' --resume <id> --fork-session --max-turns 10", workdir="/project", timeout=120)
+```
+
+### 用于 CI/脚本编写的 Bare 模式
+```
+terminal(command="claude --bare -p 'Run all tests and report failures' --allowedTools 'Read,Bash' --max-turns 10", workdir="/project", timeout=180)
+```
+
+`--bare` 跳过 hooks、plugins、MCP 发现和 CLAUDE.md 加载。启动最快。需要 `ANTHROPIC_API_KEY`（跳过 OAuth）。
+
+要在 bare 模式下有选择地加载上下文：
+| 要加载的内容 | 参数 |
+|---------|------|
+| 系统提示词附加内容 | `--append-system-prompt "text"` 或 `--append-system-prompt-file path` |
+| 设置 | `--settings <file-or-json>` |
+| MCP server | `--mcp-config <file-or-json>` |
+| 自定义 agents | `--agents '<json>'` |
+
+### 过载的备用模型
+```
+terminal(command="claude -p 'task' --fallback-model haiku --max-turns 5", timeout=90)
+```
+当默认模型过载时自动回退到指定模型（仅限 print 模式）。
+
+## 完整的 CLI 参数参考
+
+### 会话与环境
+| 参数 | 效果 |
+|------|--------|
+| `-p, --print` | 非交互式一次性模式（完成后退出） |
+| `-c, --continue` | 在当前目录恢复最近的对话 |
+| `-r, --resume <id>` | 通过 ID 或名称恢复特定会话（若无 ID 则打开交互式选择器） |
+| `--fork-session` | 恢复时创建新的会话 ID，而不是重用原始 ID |
+| `--session-id <uuid>` | 为对话使用特定的 UUID |
+| `--no-session-persistence` | 不将 session 保存到磁盘（仅限 print 模式） |
+| `--add-dir <paths...>` | 授予 Claude 访问额外工作目录的权限 |
+| `-w, --worktree [name]` | 在隔离的 git worktree `.claude/worktrees/<name>` 中运行 |
+| `--tmux` | 为 worktree 创建 tmux 会话（需要 `--worktree`） |
+| `--ide` | 启动时自动连接到有效的 IDE |
+| `--chrome` / `--no-chrome` | 启用/禁用用于 Web 测试的 Chrome 浏览器集成 |
+| `--from-pr [number]` | 恢复链接到特定 GitHub PR 的会话 |
+| `--file <specs...>` | 启动时下载的文件资源（格式：`file_id:relative_path`） |
+
+### 模型与性能
+| 参数 | 效果 |
+|------|--------|
+| `--model <alias>` | 模型选择：`sonnet`、`opus`、`haiku`，或如 `claude-sonnet-4-6` 的完整名称 |
+| `--effort <level>` | 推理深度：`low`, `medium`, `high`, `max`, `auto` | 两者均适用 |
+| `--max-turns <n>` | 限制 agentic 循环（仅限 print 模式；防止失控） |
+| `--max-budget-usd <n>` | 设定以美元为单位的 API 支出上限（仅限 print 模式） |
+| `--fallback-model <model>` | 默认模型过载时自动回退（仅限 print 模式） |
+| `--betas <betas...>` | API 请求中包含的 Beta headers（仅限 API key 用户） |
+
+### 权限与安全
+| 参数 | 效果 |
+|------|--------|
+| `--dangerously-skip-permissions` | 自动批准所有工具使用（文件写入、bash、网络等） |
+| `--allow-dangerously-skip-permissions` | 将跳过权限启用为一个*选项*，但默认不开启 |
+| `--permission-mode <mode>` | `default`, `acceptEdits`, `plan`, `auto`, `dontAsk`, `bypassPermissions` |
+| `--allowedTools <tools...>` | 白名单指定的工具（以逗号或空格分隔） |
+| `--disallowedTools <tools...>` | 黑名单指定的工具 |
+| `--tools <tools...>` | 覆盖内置工具集（`""` = 无，`"default"` = 所有，或工具名称） |
+
+### 输出与输入格式
+| 参数 | 效果 |
+|------|--------|
+| `--output-format <fmt>` | `text` (默认), `json` (单一结果对象), `stream-json` (换行符分隔) |
+| `--input-format <fmt>` | `text` (默认) 或 `stream-json` (实时流式输入) |
+| `--json-schema <schema>` | 强制输出匹配特定 schema 的结构化 JSON |
+| `--verbose` | 显示完整的逐轮输出 |
+| `--include-partial-messages` | 包含到达的部分消息块（stream-json + print） |
+| `--replay-user-messages` | 将用户消息重新发送到 stdout（stream-json 双向） |
+
+### 系统提示词与上下文
+| 参数 | 效果 |
+|------|--------|
+| `--append-system-prompt <text>` | **添加**到默认系统提示词（保留内置能力） |
+| `--append-system-prompt-file <path>` | 将文件内容**添加**到默认系统提示词 |
+| `--system-prompt <text>` | **替换**整个系统提示词（通常建议改用 --append） |
+| `--system-prompt-file <path>` | 用文件内容**替换**系统提示词 |
+| `--bare` | 跳过 hooks、plugins、MCP 发现、CLAUDE.md 和 OAuth（启动最快） |
+| `--agents '<json>'` | 以 JSON 形式动态定义自定义 subagents |
+| `--mcp-config <path>` | 从 JSON 文件加载 MCP server（可重复使用） |
+| `--strict-mcp-config` | 仅使用来自 `--mcp-config` 的 MCP server，忽略所有其他 MCP 配置 |
+| `--settings <file-or-json>` | 从 JSON 文件或内联 JSON 加载额外设置 |
+| `--setting-sources <sources>` | 以逗号分隔的加载源：`user`, `project`, `local` |
+| `--plugin-dir <paths...>` | 仅为此会话从目录加载插件 |
+| `--disable-slash-commands` | 禁用所有 skills/slash commands |
+
+### 调试
+| 参数 | 效果 |
+|------|--------|
+| `-d, --debug [filter]` | 启用 debug 日志，带有可选的类别过滤器（如 `"api,hooks"`, `"!1p,!file"`） |
+| `--debug-file <path>` | 将 debug 日志写入文件（隐式启用 debug 模式） |
+
+### Agent 团队
+| 参数 | 效果 |
+|------|--------|
+| `--teammate-mode <mode>` | Agent 团队的显示方式：`auto`、`in-process` 或 `tmux` |
+| `--brief` | 启用 `SendUserMessage` 工具以进行 agent 与用户的通信 |
+
+### 用于 --allowedTools / --disallowedTools 的工具名称语法
+```
+Read                    # All file reading
+Edit                    # File editing (existing files)
+Write                   # File creation (new files)
+Bash                    # All shell commands
+Bash(git *)             # Only git commands
+Bash(git commit *)      # Only git commit commands
+Bash(npm run lint:*)    # Pattern matching with wildcards
+WebSearch               # Web search capability
+WebFetch                # Web page fetching
+mcp__<server>__<tool>   # Specific MCP tool
+```
+
+## 设置 & 配置
+
+### 设置层级（优先级由高到低）
+1. **CLI 参数** — 覆盖一切
+2. **本地项目:** `.claude/settings.local.json` (个人，被 gitignore 忽略)
+3. **项目:** `.claude/settings.json` (共享，受 git 跟踪)
+4. **用户:** `~/.claude/settings.json` (全局)
+
+### 设置中的权限
+```json
+{
+  "permissions": {
+    "allow": ["Bash(npm run lint:*)", "WebSearch", "Read"],
+    "ask": ["Write(*.ts)", "Bash(git push*)"],
+    "deny": ["Read(.env)", "Bash(rm -rf *)"]
+  }
+}
+```
+
+### 记忆文件 (CLAUDE.md) 层级
+1. **全局:** `~/.claude/CLAUDE.md` — 适用于所有项目
+2. **项目:** `./CLAUDE.md` — 项目特定上下文（受 git 跟踪）
+3. **本地:** `.claude/CLAUDE.local.md` — 个人项目覆盖（被 gitignore 忽略）
+
+在交互模式下使用 `#` 前缀可快速添加到记忆：`# Always use 2-space indentation`。
+
+## 交互式会话：Slash Commands
+
+### 会话与上下文
+| 命令 | 用途 |
+|---------|---------|
+| `/help` | 显示所有命令（包括自定义和 MCP 命令） |
+| `/compact [focus]` | 压缩上下文以节省 token；CLAUDE.md 会在压缩后保留。例如：`/compact focus on auth logic` |
+| `/clear` | 清除对话历史，重新开始 |
+| `/context` | 将上下文使用情况可视化为彩色网格，并提供优化建议 |
+| `/cost` | 查看 token 使用情况，包含各模型和缓存命中的明细 |
+| `/resume` | 切换到或恢复不同的会话 |
+| `/rewind` | 恢复到对话或代码中的先前检查点 |
+| `/btw <question>` | 提出附带问题而不增加上下文成本 |
+| `/status` | 显示版本、连接状态和会话信息 |
+| `/todos` | 列出对话中跟踪的行动项 |
+| `/exit` 或 `Ctrl+D` | 结束会话 |
+
+### 开发 & 审查
+| 命令 | 用途 |
+|---------|---------|
+| `/review` | 请求对当前更改进行代码审查 |
+| `/security-review` | 对当前更改执行安全分析 |
+| `/plan [description]` | 进入计划模式并自动开始任务规划 |
+| `/loop [interval]` | 在会话中安排周期性任务 |
+| `/batch` | 为大型并行更改自动创建 worktrees（5-30 个 worktrees） |
+
+### 配置 & 工具
+| 命令 | 用途 |
+|---------|---------|
+| `/model [model]` | 在会话中途切换模型（使用方向键调整工作量） |
+| `/effort [level]` | 设置推理工作量：`low`, `medium`, `high`, `max`, 或 `auto` |
+| `/init` | 为项目记忆创建 CLAUDE.md 文件 |
+| `/memory` | 打开 CLAUDE.md 进行编辑 |
+| `/config` | 打开交互式设置配置 |
+| `/permissions` | 查看/更新工具权限 |
+| `/agents` | 管理专门的 subagents |
+| `/mcp` | 管理 MCP server 的交互式 UI |
+| `/add-dir` | 添加额外的工作目录（适用于 monorepos） |
+| `/usage` | 显示计划限制和速率限制状态 |
+| `/voice` | 启用按住说话的语音模式（支持 20 种语言；按住空格键录音，松开发送） |
+| `/release-notes` | 版本发布说明的交互式选择器 |
+
+### 自定义 Slash Commands
+创建 `.claude/commands/<name>.md`（项目共享）或 `~/.claude/commands/<name>.md`（个人）：
+
+```markdown
+# .claude/commands/deploy.md
+Run the deploy pipeline:
+1. Run all tests
+2. Build the Docker image
+3. Push to registry
+4. Update the $ARGUMENTS environment (default: staging)
+```
+
+用法：`/deploy production` — `$ARGUMENTS` 会替换为用户的输入。
+
+### Skills（自然语言调用）
+与手动调用的 slash commands 不同，`.claude/skills/` 中的 skills 是 markdown 指南，当任务匹配时，Claude 会通过自然语言自动调用它们：
+
+```markdown
+# .claude/skills/database-migration.md
+When asked to create or modify database migrations:
+1. Use Alembic for migration generation
+2. Always create a rollback function
+3. Test migrations against a local database copy
+```
+
+## 交互式会话：键盘快捷键
+
+### 通用控制
+| 键 | 动作 |
+|-----|--------|
+| `Ctrl+C` | 取消当前输入或生成 |
+| `Ctrl+D` | 退出会话 |
+| `Ctrl+R` | 反向搜索命令历史 |
+| `Ctrl+B` | 将正在运行的任务放到后台 |
+| `Ctrl+V` | 将图片粘贴到对话中 |
+| `Ctrl+O` | 记录模式 — 查看 Claude 的思考过程 |
+| `Ctrl+G` 或 `Ctrl+X Ctrl+E` | 在外部编辑器中打开 prompt |
+| `Esc Esc` | 回退对话或代码状态 / 总结 |
+
+### 模式切换
+| 键 | 动作 |
+|-----|--------|
+| `Shift+Tab` | 循环切换权限模式（Normal → Auto-Accept → Plan） |
+| `Alt+P` | 切换模型 |
+| `Alt+T` | 切换思考模式 |
+| `Alt+O` | 切换 Fast Mode |
+
+### 多行输入
+| 键 | 动作 |
+|-----|--------|
+| `\` + `Enter` | 快速换行 |
+| `Shift+Enter` | 换行（替代方式） |
+| `Ctrl+J` | 换行（替代方式） |
+
+### 输入前缀
+| 前缀 | 动作 |
+|--------|--------|
+| `!` | 绕过 AI 直接执行 bash（例如 `!npm test`）。单独使用 `!` 可切换 shell 模式。 |
+| `@` | 引用文件/目录并自动补全（例如 `@./src/api/`） |
+| `#` | 快速添加到 CLAUDE.md 记忆（例如 `# Use 2-space indentation`） |
+| `/` | Slash commands |
+
+### 专家提示："ultrathink"
+在您的 prompt 中使用关键字 "ultrathink" 以在特定回合获得最大推理工作量。无论当前的 `/effort` 设置如何，这都会触发最深度的思考模式。
+
+## PR 审查模式
+
+### 快速审查（Print 模式）
+```
+terminal(command="cd /path/to/repo && git diff main...feature-branch | claude -p 'Review this diff for bugs, security issues, and style problems. Be thorough.' --max-turns 1", timeout=60)
+```
+
+### 深度审查（交互式 + Worktree）
+```
+terminal(command="tmux new-session -d -s review -x 140 -y 40")
+terminal(command="tmux send-keys -t review 'cd /path/to/repo && claude -w pr-review' Enter")
+terminal(command="sleep 5 && tmux send-keys -t review Enter")  # Trust dialog
+terminal(command="sleep 2 && tmux send-keys -t review 'Review all changes vs main. Check for bugs, security issues, race conditions, and missing tests.' Enter")
+terminal(command="sleep 30 && tmux capture-pane -t review -p -S -60")
+```
+
+### 通过编号进行 PR 审查
+```
+terminal(command="claude -p 'Review this PR thoroughly' --from-pr 42 --max-turns 10", workdir="/path/to/repo", timeout=120)
+```
+
+### 使用 tmux 的 Claude Worktree
+```
+terminal(command="claude -w feature-x --tmux", workdir="/path/to/repo")
+```
+在 `.claude/worktrees/feature-x` 创建一个隔离的 git worktree，并为其创建一个 tmux 会话。在可用时使用 iTerm2 的原生窗格；添加 `--tmux=classic` 以使用传统的 tmux。
+
+## 并行 Claude 实例
+
+同时运行多个独立的 Claude 任务：
+
+```
+# Task 1: Fix backend
+terminal(command="tmux new-session -d -s task1 -x 140 -y 40 && tmux send-keys -t task1 'cd ~/project && claude -p \"Fix the auth bug in src/auth.py\" --allowedTools \"Read,Edit\" --max-turns 10' Enter")
+
+# Task 2: Write tests
+terminal(command="tmux new-session -d -s task2 -x 140 -y 40 && tmux send-keys -t task2 'cd ~/project && claude -p \"Write integration tests for the API endpoints\" --allowedTools \"Read,Write,Bash\" --max-turns 15' Enter")
+
+# Task 3: Update docs
+terminal(command="tmux new-session -d -s task3 -x 140 -y 40 && tmux send-keys -t task3 'cd ~/project && claude -p \"Update README.md with the new API endpoints\" --allowedTools \"Read,Edit\" --max-turns 5' Enter")
+
+# Monitor all
+terminal(command="sleep 30 && for s in task1 task2 task3; do echo '=== '$s' ==='; tmux capture-pane -t $s -p -S -5 2>/dev/null; done")
+```
+
+## CLAUDE.md — 项目上下文文件
+
+Claude Code 会从项目根目录自动加载 `CLAUDE.md`。使用它来持久化项目上下文：
+
+```markdown
+# Project: My API
+
+## Architecture
+- FastAPI backend with SQLAlchemy ORM
+- PostgreSQL database, Redis cache
+- pytest for testing with 90% coverage target
+
+## Key Commands
+- `make test` — run full test suite
+- `make lint` — ruff + mypy
+- `make dev` — start dev server on :8000
+
+## Code Standards
+- Type hints on all public functions
+- Docstrings in Google style
+- 2-space indentation for YAML, 4-space for Python
+- No wildcard imports
+```
+
+**务必具体。** 不要写“写出好代码”，而应使用“JS 使用 2 空格缩进”或“测试文件以 `.test.ts` 后缀命名”。具体的指令能节省纠正周期。
+
+### 规则目录（模块化 CLAUDE.md）
+对于包含许多规则的项目，请使用规则目录，而不是一个庞大的 CLAUDE.md：
+- **项目规则:** `.claude/rules/*.md` — 团队共享，受 git 跟踪
+- **用户规则:** `~/.claude/rules/*.md` — 个人，全局
+
+规则目录中的每个 `.md` 文件都会作为额外上下文被加载。这比把所有内容塞进一个 CLAUDE.md 要清晰得多。
+
+### 自动记忆
+Claude 会自动将学习到的项目上下文存储在 `~/.claude/projects/<project>/memory/` 中。
+- **限制：** 每个项目 25KB 或 200 行
+- 这独立于 CLAUDE.md — 这是 Claude 自己在跨会话中积累的关于该项目的笔记
+
+## 自定义 Subagents
+
+在 `.claude/agents/`（项目）、`~/.claude/agents/`（个人）中定义专门的 agents，或通过 `--agents` CLI 参数（会话）定义：
+
+### Agent 位置优先级
+1. `.claude/agents/` — 项目级别，团队共享
+2. `--agents` CLI 参数 — 特定于会话，动态
+3. `~/.claude/agents/` — 用户级别，个人
+
+### 创建 Agent
+```markdown
+# .claude/agents/security-reviewer.md
+---
+name: security-reviewer
+description: Security-focused code review
+model: opus
+tools: [Read, Bash]
+---
+You are a senior security engineer. Review code for:
+- Injection vulnerabilities (SQL, XSS, command injection)
+- Authentication/authorization flaws
+- Secrets in code
+- Unsafe deserialization
+```
+
+调用方式：`@security-reviewer review the auth module`
+
+### 通过 CLI 动态创建 Agents
+```
+terminal(command="claude --agents '{\"reviewer\": {\"description\": \"Reviews code\", \"prompt\": \"You are a code reviewer focused on performance\"}}' -p 'Use @reviewer to check auth.py'", timeout=120)
+```
+
+Claude 可以编排多个 agents：“使用 @db-expert 优化查询，然后使用 @security 审计这些更改。”
+
+## Hooks — 事件自动化
+
+在 `.claude/settings.json`（项目）或 `~/.claude/settings.json`（全局）中配置：
+
+```json
+{
+  "hooks": {
+    "PostToolUse": [{
+      "matcher": "Write(*.py)",
+      "hooks": [{"type": "command", "command": "ruff check --fix $CLAUDE_FILE_PATHS"}]
+    }],
+    "PreToolUse": [{
+      "matcher": "Bash",
+      "hooks": [{"type": "command", "command": "if echo \"$CLAUDE_TOOL_INPUT\" | grep -q 'rm -rf'; then echo 'Blocked!' && exit 2; fi"}]
+    }],
+    "Stop": [{
+      "hooks": [{"type": "command", "command": "echo 'Claude finished a response' >> /tmp/claude-activity.log"}]
+    }]
+  }
+}
+```
+
+### 全部 8 种 Hook 类型
+| Hook | 触发时机 | 常见用途 |
+|------|--------------|------------|
+| `UserPromptSubmit` | 在 Claude 处理用户 prompt 之前 | 输入验证、日志记录 |
+| `PreToolUse` | 在工具执行之前 | 安全门，拦截危险命令（exit 2 = 拦截） |
+| `PostToolUse` | 在工具完成之后 | 自动格式化代码，运行 linters |
+| `Notification` | 在权限请求或等待输入时 | 桌面通知、警报 |
+| `Stop` | 当 Claude 完成回复时 | 完成日志记录、状态更新 |
+| `SubagentStop` | 当 subagent 完成时 | Agent 编排 |
+| `PreCompact` | 在上下文记忆被清除之前 | 备份会话记录 |
+| `SessionStart` | 会话开始时 | 加载开发上下文（例如 `git status`） |
+
+### Hook 环境变量
+| 变量 | 内容 |
+|----------|---------|
+| `CLAUDE_PROJECT_DIR` | 当前项目路径 |
+| `CLAUDE_FILE_PATHS` | 正在被修改的文件 |
+| `CLAUDE_TOOL_INPUT` | 作为 JSON 的工具参数 |
+
+### 安全 Hook 示例
+```json
+{
+  "PreToolUse": [{
+    "matcher": "Bash",
+    "hooks": [{"type": "command", "command": "if echo \"$CLAUDE_TOOL_INPUT\" | grep -qE 'rm -rf|git push.*--force|:(){ :|:& };:'; then echo 'Dangerous command blocked!' && exit 2; fi"}]
+  }]
+}
+```
+
+## MCP 集成
+
+为数据库、API 和服务添加外部工具服务器：
+
+```
+# GitHub integration
+terminal(command="claude mcp add -s user github -- npx @modelcontextprotocol/server-github", timeout=30)
+
+# PostgreSQL queries
+terminal(command="claude mcp add -s local postgres -- npx @anthropic-ai/server-postgres --connection-string postgresql://localhost/mydb", timeout=30)
+
+# Puppeteer for web testing
+terminal(command="claude mcp add puppeteer -- npx @anthropic-ai/server-puppeteer", timeout=30)
+```
+
+### MCP 作用域
+| 参数 | 作用域 | 存储位置 |
+|------|-------|---------|
+| `-s user` | 全局（所有项目） | `~/.claude.json` |
+| `-s local` | 当前项目（个人） | `.claude/settings.local.json` (被 gitignore 忽略) |
+| `-s project` | 当前项目（团队共享） | `.claude/settings.json` (受 git 跟踪) |
+
+### Print/CI 模式下的 MCP
+```
+terminal(command="claude --bare -p 'Query database' --mcp-config mcp-servers.json --strict-mcp-config", timeout=60)
+```
+`--strict-mcp-config` 会忽略所有未来自 `--mcp-config` 的 MCP server。
+
+在聊天中引用 MCP 资源：`@github:issue://123`
+
+### MCP 限制与调优
+- **工具描述：** 每个 server 的工具描述和服务器说明总上限为 2KB
+- **结果大小：** 默认设有限制；使用 `maxResultSizeChars