name: help description: 交互式工作空间发现 - 了解可用的工具、工作流、代理和钩子 triggers: [“help”, “what can you do”, “show capabilities”, “how do I”] allowed-tools: [AskUserQuestion, Bash, Read, Glob, Grep] priority: high

/help - 工作空间发现

引导用户了解此工作空间设置的功能。

用法

/help                    # 交互式引导发现
/help workflows          # 工作流编排技能
/help agents             # 专业代理目录
/help tools              # CLI工具 (tldr, prove, recall)
/help hooks              # 活动钩子及其功能
/help advanced           # MCP、前件、自定义
/help <name>             # 深入特定技能/代理

基于参数的行为

无参数：交互式发现

使用 AskUserQuestion 引导用户：

question: "您想做什么？"
header: "目标"
options:
  - label: "探索/理解代码库"
    description: "查找模式、架构、约定"
  - label: "修复错误"
    description: "调查、诊断、实施修复"
  - label: "构建功能"
    description: "规划、实施、测试新功能"
  - label: "数学证明"
    description: "使用 Lean 4 进行形式化验证"

基于响应，显示相关工具：

目标	显示
探索代码库	scout 代理、tldr CLI、/explore 工作流
修复错误	/fix 工作流、sleuth 代理、debug-agent
构建功能	/build 工作流、architect 代理、kraken 代理
数学证明	/prove 技能、lean4 技能、Godel-Prover
研究文档	oracle 代理、nia-docs、perplexity
配置工作空间	钩子、规则、设置、前件

/help workflows

显示工作流元技能：

## 工作流技能

为复杂任务编排多代理流水线。

| 工作流 | 目的 | 使用的代理 |
|----------|---------|-------------|
| /fix | 错误调查 → 诊断 → 实施 | sleuth → kraken → arbiter |
| /build | 功能规划 → 实施 → 测试 | architect → kraken → arbiter |
| /debug | 问题深入调查 | debug-agent, sleuth |
| /tdd | 测试驱动开发周期 | arbiter → kraken → arbiter |
| /refactor | 代码转换与安全 | phoenix → kraken → judge |
| /review | 代码审查和反馈 | critic, judge |
| /security | 漏洞分析 | aegis |
| /explore | 代码库发现 | scout |
| /test | 测试执行和验证 | arbiter, atlas |
| /release | 版本更新、变更日志 | herald |
| /migrate | 框架/基础设施变更 | pioneer, phoenix |

**用法**：只需描述您的目标。Claude 会路由到正确的工作流。

/help agents

显示代理目录：

## 专业代理

通过 Task 工具与 subagent_type 生成。

### 探索与研究
| 代理 | 目的 | 模型 |
|-------|---------|-------|
| scout | 代码库探索、模式查找 | sonnet |
| oracle | 外部研究（网络、文档、API） | sonnet |
| pathfinder | 外部仓库分析 | sonnet |

### 规划与架构
| 代理 | 目的 | 模型 |
|-------|---------|-------|
| architect | 功能规划、设计文档 | sonnet |
| plan-agent | 创建实施计划 | sonnet |
| phoenix | 重构和迁移规划 | sonnet |

### 实施
| 代理 | 目的 | 模型 |
|-------|---------|-------|
| kraken | TDD 实施、重构 | sonnet |
| spark | 快速修复、轻量级变更 | haiku |

### 审查与验证
| 代理 | 目的 | 模型 |
|-------|---------|-------|
| arbiter | 测试执行、验证 | sonnet |
| critic | 代码审查 | sonnet |
| judge | 重构审查 | sonnet |

### 调查
| 代理 | 目的 | 模型 |
|-------|---------|-------|
| sleuth | 错误调查、根本原因 | sonnet |
| debug-agent | 问题调查与日志 | sonnet |
| profiler | 性能、竞态条件 | sonnet |

### 文档与交接
| 代理 | 目的 | 模型 |
|-------|---------|-------|
| scribe | 文档、会话摘要 | sonnet |
| chronicler | 会话分析、学习提取 | sonnet |

/help tools

显示 CLI 工具和功能：

## 内置工具

### TLDR 代码分析
令牌高效的代码探索（相比读取原始文件节省 95%）。

```bash
tldr tree src/              # 文件树
tldr structure src/ --lang python  # 代码结构（代码图）
tldr search "pattern" src/  # 搜索文件
tldr cfg file.py func       # 控制流图
tldr dfg file.py func       # 数据流图
tldr impact func src/       # 反向调用图（谁调用此？）
tldr dead src/              # 查找死代码
tldr arch src/              # 检测架构层

/prove - 形式化验证

无需学习 Lean 语法的机器验证证明。

/prove every group homomorphism preserves identity
/prove continuous functions on compact sets are uniformly continuous

要求：本地运行 LM Studio 的 Godel-Prover 模型。

记忆系统

跨会话存储和回忆学习。

# 回忆过去的学习
(cd opc && uv run python scripts/core/recall_learnings.py --query "hook patterns")

# 存储新学习（通过 /remember 技能）
/remember "Hook X works by..."

事前风险分析

在发生前识别失败模式。

/premortem [plan-file]     # 分析实施计划的风险


### /help hooks

显示活动钩子：

```markdown
## 活动钩子

钩子在关键生命周期点扩展 Claude 的行为。

### 会话生命周期
| 钩子 | 事件 | 目的 |
|------|-------|---------|
| session-register | SessionStart | 在协调数据库中注册会话 |
| session-start-recall | SessionStart | 自动注入相关学习 |
| session-end-cleanup | SessionEnd | 清理临时文件 |
| session-outcome | SessionEnd | 提示会话结果 |

### 用户提示处理
| 钩子 | 事件 | 目的 |
|------|-------|---------|
| skill-activation-prompt | UserPromptSubmit | 建议相关技能 |
| premortem-suggest | UserPromptSubmit | 建议实施前的风险分析 |

### 工具拦截
| 钩子 | 事件 | 目的 |
|------|-------|---------|
| tldr-read-enforcer | PreToolUse:Read | 建议大文件使用 tldr |
| smart-search-router | PreToolUse:Grep | 路由到 ast-grep 进行结构搜索 |
| file-claims | PreToolUse:Edit | 跟踪哪些会话编辑哪些文件 |
| signature-helper | PreToolUse:Edit | 注入函数签名 |
| import-validator | PostToolUse:Edit | 编辑后验证导入 |

### 验证
| 钩子 | 事件 | 目的 |
|------|-------|---------|
| typescript-preflight | PreToolUse:Bash | 运行前类型检查 |
| compiler-in-the-loop | Stop | 运行 Lean 编译器用于 /prove |

### 子代理协调
| 钩子 | 事件 | 目的 |
|------|-------|---------|
| subagent-start | SubagentStart | 初始化代理上下文 |
| subagent-stop | SubagentStop | 从代理提取学习 |

/help advanced

显示高级自定义：

## 高级：自定义与扩展

### 技能前件
技能使用 YAML 前件进行元数据和工具限制：

```yaml
---
name: my-skill
description: 它的功能
triggers: ["keyword1", "keyword2"]
allowed-tools: [Bash, Read, Edit]
priority: high
skills: [other-skill]  # 自动加载依赖项
---

代理前件

代理声明其能力：

---
name: my-agent
description: X 的专家
model: sonnet|haiku|claude-opus-4-5-20251101
tools: [Read, Grep, Glob, Bash]
---

MCP 服务器

外部工具集成：

服务器	目的
ast-grep	结构代码搜索/重构
firecrawl	网络爬取
github-search	搜索 GitHub 代码/问题
morph	快速文件编辑（10k 令牌/秒）
nia	文档搜索
perplexity	AI 驱动的网络研究

规则 (.claude/rules/*.md)

始终注入到上下文中的指令：

claim-verification.md - 断言前验证
dynamic-recall.md - 如何使用记忆系统
tldr-cli.md - TLDR 使用参考

创建自定义技能

mkdir -p .claude/skills/my-skill
# 使用前件创建 .claude/skills/my-skill/SKILL.md

创建自定义代理

# 使用前件创建 .claude/agents/my-agent.md


### /help <特定名称>

用于特定技能/代理查找：
1. 搜索匹配技能：`.claude/skills/<name>/SKILL.md`
2. 搜索匹配代理：`.claude/agents/<name>.md`
3. 读取文件并显示：
   - 描述
   - 使用示例
   - 何时使用
   - 相关技能/代理

## 动态发现

为保持帮助最新，动态读取前件：

```bash
# 列出所有技能及其描述
for f in .claude/skills/*/SKILL.md; do
  head -10 "$f" | grep -E "^(name|description):"
done

# 列出所有代理
for f in .claude/agents/*.md; do
  head -10 "$f" | grep -E "^(name|description):"
done

示例交互

用户：/help

Claude：

您想做什么？

[ ] 探索/理解代码库
    查找模式、架构、约定

[ ] 修复错误
    调查、诊断、实施修复

[ ] 构建功能
    规划、实施、测试新功能

[ ] 数学证明
    使用 Lean 4 进行形式化验证

[其他：描述您的目标]

用户选择：“修复错误”

Claude：

## 错误修复工具

### 快速路径
只需描述错误。我会自动使用 /fix 工作流。

### 手动控制
- **sleuth** 代理：深入调查、根本原因分析
- **debug-agent**：日志分析、状态检查
- **kraken** 代理：TDD 实施修复

### 命令
- `/fix` - 完整工作流（调查 → 诊断 → 实施 → 测试）
- `/debug` - 仅调查

### 提示
- 提供错误消息、日志、重现步骤
- 事前钩子将在实施前建议风险分析