help

/help - 工作区探索

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

用法

/help                    # Interactive guided discovery
/help workflows          # Workflow orchestration skills
/help agents             # Specialist agents catalog
/help tools              # CLI tools (tldr, prove, recall)
/help hooks              # Active hooks and what they do
/help advanced           # MCP, frontmatter, customization
/help <name>             # Deep dive on specific skill/agent

根据参数执行的行为

无参数：交互式探索

使用 AskUserQuestion 引导用户：

question: "What are you trying to do?"
header: "Goal"
options:
  - label: "Explore/understand a codebase"
    description: "Find patterns, architecture, conventions"
  - label: "Fix a bug"
    description: "Investigate, diagnose, implement fix"
  - label: "Build a feature"
    description: "Plan, implement, test new functionality"
  - label: "Prove something mathematically"
    description: "Formal verification with Lean 4"

根据用户的回答，显示相关工具：

目标	显示
探索代码库	scout Agent、tldr CLI、/explore 工作流
修复错误	/fix 工作流、sleuth Agent、debug-agent
构建功能	/build 工作流、architect Agent、kraken Agent
证明数学命题	/prove 技能、lean4 技能、Godel-Prover
查阅文档	oracle Agent、nia-docs、perplexity
配置工作区	hooks、rules、settings、frontmatter

/help workflows

显示工作流元技能：

## Workflow Skills

Orchestrate multi-agent pipelines for complex tasks.

| Workflow | Purpose | Agents Used |
|----------|---------|-------------|
| /fix | Bug investigation → diagnosis → implementation | sleuth → kraken → arbiter |
| /build | Feature planning → implementation → testing | architect → kraken → arbiter |
| /debug | Deep investigation of issues | debug-agent, sleuth |
| /tdd | Test-driven development cycle | arbiter → kraken → arbiter |
| /refactor | Code transformation with safety | phoenix → kraken → judge |
| /review | Code review and feedback | critic, judge |
| /security | Vulnerability analysis | aegis |
| /explore | Codebase discovery | scout |
| /test | Test execution and validation | arbiter, atlas |
| /release | Version bumps, changelog | herald |
| /migrate | Framework/infrastructure changes | pioneer, phoenix |

**Usage**: Just describe your goal. Claude routes to the right workflow.

/help agents

显示 Agent 目录：

## Specialist Agents

Spawn via Task tool with subagent_type.

### Exploration & Research
| Agent | Purpose | Model |
|-------|---------|-------|
| scout | Codebase exploration, pattern finding | sonnet |
| oracle | External research (web, docs, APIs) | sonnet |
| pathfinder | External repository analysis | sonnet |

### Planning & Architecture
| Agent | Purpose | Model |
|-------|---------|-------|
| architect | Feature planning, design docs | sonnet |
| plan-agent | Create implementation plans | sonnet |
| phoenix | Refactoring & migration planning | sonnet |

### Implementation
| Agent | Purpose | Model |
|-------|---------|-------|
| kraken | TDD implementation, refactoring | sonnet |
| spark | Quick fixes, lightweight changes | haiku |

### Review & Validation
| Agent | Purpose | Model |
|-------|---------|-------|
| arbiter | Test execution, validation | sonnet |
| critic | Code review | sonnet |
| judge | Refactoring review | sonnet |

### Investigation
| Agent | Purpose | Model |
|-------|---------|-------|
| sleuth | Bug investigation, root cause | sonnet |
| debug-agent | Issue investigation with logs | sonnet |
| profiler | Performance, race conditions | sonnet |

### Documentation & Handoff
| Agent | Purpose | Model |
|-------|---------|-------|
| scribe | Documentation, session summaries | sonnet |
| chronicler | Session analysis, learning extraction | sonnet |

/help tools

显示 CLI 工具及其功能：

## Built-in Tools

### TLDR Code Analysis
Token-efficient code exploration (95% savings vs reading raw files).

```bash
tldr tree src/              # File tree
tldr structure src/ --lang python  # Code structure (codemaps)
tldr search "pattern" src/  # Search files
tldr cfg file.py func       # Control flow graph
tldr dfg file.py func       # Data flow graph
tldr impact func src/       # Reverse call graph (who calls this?)
tldr dead src/              # Find dead code
tldr arch src/              # Detect architectural layers

/prove - 形式化验证

无需学习 Lean 语法，即可获得机器验证的证明。

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

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

记忆系统

在不同会话间存储和回忆经验。

# Recall past learnings
(cd opc && uv run python scripts/core/recall_learnings.py --query "hook patterns")

# Store new learning (via /remember skill)
/remember "Hook X works by..."

事前风险分析

在故障发生前识别其可能的诱因。

/premortem [plan-file]     # Analyze implementation plan for risks

### /help hooks

Display active hooks:

```markdown
## Active Hooks

Hooks extend Claude's behavior at key lifecycle points.

### Session Lifecycle
| Hook | Event | Purpose |
|------|-------|---------|
| session-register | SessionStart | Register session in coordination DB |
| session-start-recall | SessionStart | Auto-inject relevant learnings |
| session-end-cleanup | SessionEnd | Cleanup temp files |
| session-outcome | SessionEnd | Prompt for session outcome |

### User Prompt Processing
| Hook | Event | Purpose |
|------|-------|---------|
| skill-activation-prompt | UserPromptSubmit | Suggest relevant skills |
| premortem-suggest | UserPromptSubmit | Suggest risk analysis for implementations |

### Tool Interception
| Hook | Event | Purpose |
|------|-------|---------|
| tldr-read-enforcer | PreToolUse:Read | Suggest tldr for large files |
| smart-search-router | PreToolUse:Grep | Route to ast-grep for structural search |
| file-claims | PreToolUse:Edit | Track which sessions edit which files |
| signature-helper | PreToolUse:Edit | Inject function signatures |
| import-validator | PostToolUse:Edit | Validate imports after edits |

### Validation
| Hook | Event | Purpose |
|------|-------|---------|
| typescript-preflight | PreToolUse:Bash | Type-check before running |
| compiler-in-the-loop | Stop | Run Lean compiler for /prove |

### Subagent Coordination
| Hook | Event | Purpose |
|------|-------|---------|
| subagent-start | SubagentStart | Initialize agent context |
| subagent-stop | SubagentStop | Extract learnings from agents |

/help advanced

显示高级自定义选项：

## Advanced: Customization & Extension

### Skill Frontmatter
Skills use YAML frontmatter for metadata and tool restrictions:

```yaml
---
name: my-skill
description: What it does
triggers: ["keyword1", "keyword2"]
allowed-tools: [Bash, Read, Edit]
priority: high
skills: [other-skill]  # Auto-load dependencies
---

Agent Frontmatter

Agent 声明其能力：

---
name: my-agent
description: Specialist for 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
# Create .claude/skills/my-skill/SKILL.md with frontmatter

创建自定义 Agent

# Create .claude/agents/my-agent.md with frontmatter

### /help <specific-name>

For specific skill/agent lookup:

1. Search for matching skill: `.claude/skills/<name>/SKILL.md`
2. Search for matching agent: `.claude/agents/<name>.md`
3. Read the file and display:
   - Description
   - Usage examples
   - When to use
   - Related skills/agents

## Dynamic Discovery

To keep help current, dynamically read frontmatter:

```bash
# List all skills with descriptions
for f in .claude/skills/*/SKILL.md; do
  head -10 "$f" | grep -E "^(name|description):"
done

# List all agents
for f in .claude/agents/*.md; do
  head -10 "$f" | grep -E "^(name|description):"
done

交互示例

用户：/help

Claude：

What are you trying to do?

[ ] Explore/understand a codebase
    Find patterns, architecture, conventions

[ ] Fix a bug
    Investigate, diagnose, implement fix

[ ] Build a feature
    Plan, implement, test new functionality

[ ] Prove something mathematically
    Formal verification with Lean 4

[Other: describe your goal]

用户选择：「修复错误」

Claude：

## Bug Fixing Tools

### Quick Path
Just describe the bug. I'll use the /fix workflow automatically.

### Manual Control
- **sleuth** agent: Deep investigation, root cause analysis
- **debug-agent**: Log analysis, state inspection
- **kraken** agent: TDD implementation of fix

### Commands
- `/fix` - Full workflow (investigate → diagnose → implement → test)
- `/debug` - Investigation only

### Tips
- Provide error messages, logs, reproduction steps
- The premortem hook will suggest risk analysis before implementation