05e - 高级 CLI 技巧

项目级：  .claude/commands/         → /project:命令名
用户级：  ~/.claude/commands/       → /user:命令名

<!-- .claude/commands/commit.md -->
---
description: 生成规范化 commit message 并提交
allowed-tools: Bash(git add:*), Bash(git commit:*)
argument-hint: [message]
model: haiku
---
 
# 提交变更
 
<git_diff>
!`git diff --cached`
</git_diff>
 
按照 Conventional Commits 规范生成 commit message。
如果提供了 $ARGUMENTS，将其作为 commit message 的描述部分。

<!-- .claude/commands/branch.md -->
---
description: 创建功能分支
allowed-tools: Bash(git:*)
argument-hint: [分支描述]
model: haiku
---
 
基于 $ARGUMENTS 创建一个符合命名规范的功能分支。
分支名格式：feat/简短描述（kebab-case）

!`git log --oneline -10`

完整 Git 工作流命令集（放入 .claude/commands/）：

/branch [描述]  → 创建功能分支
/lint           → 运行 linter 并自动修复
/commit         → 分析 diff 生成 commit message
/push           → 暂存、提交、推送一步完成
/pr             → 生成 PR 描述并创建 PR
/fix-pipeline   → 分析 CI 失败日志并修复

# 完成功能 A 后
/clear

# 开始调试 Bug B（干净的上下文）
修复 src/auth.ts 第 47 行的认证错误...

/compact 只保留架构决策和文件变更记录，忽略调试尝试过程

# Compact instructions
当压缩上下文时，保留：
- 所有架构决策和理由
- 文件变更清单
- 未解决的 TODO 项
丢弃：
- 调试过程的中间尝试
- 已解决问题的详细讨论

/rename auth-refactor-v2
/clear
# 之后可以用 /resume 恢复
/resume

# ❌ 模糊引用（Claude 需要搜索）
找到用户服务的代码

# ✅ 精确引用（直接定位）
分析 @src/services/user.ts 中的认证逻辑

# .claudeignore
node_modules/
dist/
build/
.next/
coverage/
*.log
*.lock
__pycache__/
.git/objects/

# 同时引用多个项目目录
claude --add-dir ../shared-lib --add-dir ../api-types

精确文件引用模板：

分析 @[文件路径] 中的 [具体函数/类名]，
对比 @[另一个文件路径] 的实现，
找出 [具体问题描述]。

# 为新功能创建独立工作目录
git worktree add ../my-project-feature-auth feat/auth
git worktree add ../my-project-fix-perf fix/performance
 
# 查看所有 worktree
git worktree list

# 终端窗格 1
cd ../my-project-feature-auth && claude
 
# 终端窗格 2
cd ../my-project-fix-perf && claude

窗格 1（功能开发）：实现用户认证模块
窗格 2（性能优化）：优化数据库查询
窗格 3（安全审计）：运行安全扫描

每个窗格独立工作，完成后各自提交 PR

# 合并完成后清理
git worktree remove ../my-project-feature-auth

# 分析最近的代码变更
git diff | claude "解释这些变更的影响"
 
# 分析错误日志
cat error.log | claude "分析错误原因并给出修复建议"
 
# 分析测试失败
npm test 2>&1 | claude "分析测试失败原因"

> !git status
> !git log --oneline -5
> !npm run build

/branch "添加暗色模式"     → 创建 feat/add-dark-mode
/commit                    → 分析 diff，生成规范 commit
/push                      → 暂存 + 提交 + 推送
/pr                        → 生成 PR 描述并创建
/fix-pipeline              → 获取 CI 日志，分析并修复

Git 集成 prompt 模板：

分析 !`git diff HEAD~3..HEAD` 中的所有变更，
生成一份变更摘要，包含：
1. 新增功能
2. Bug 修复
3. 破坏性变更
4. 需要关注的风险点

# 简单任务用 Haiku（快速、便宜）
/model haiku
# 适用：文件读取、语法问题、简单重构、格式化

# 复杂任务用 Sonnet/Opus（强推理）
/model sonnet
# 适用：架构决策、多文件重构、复杂调试、代码审查

# ❌ 高成本（Claude 需要全局搜索）
项目里好像有个 bug

# ✅ 低成本（直接定位）
修复 @src/auth/login.ts 第 47 行的 TypeError，
错误信息是 "Cannot read property 'token' of undefined"

主会话：协调整体重构方案
  ├── Subagent 1：分析当前架构（独立上下文）
  ├── Subagent 2：生成新实现（独立上下文）
  └── Subagent 3：编写测试（独立上下文）

# 命名当前会话
/rename auth-refactor

# 查看历史会话
claude --resume

# 恢复指定会话
claude --resume auth-refactor

# 继续最近的会话
claude --continue

开始新任务 → 命名会话（/rename）
  ↓
工作中 → 监控上下文（/cost）
  ↓
中途切换 → 退出当前会话
  ↓
处理紧急任务 → 新会话处理
  ↓
回到原任务 → claude --resume [会话名]

# 直接将错误输出传给 Claude
npm run build 2>&1 | claude "分析构建错误并给出修复方案"
 
# 分析运行时错误
cat /var/log/app/error.log | claude "找出最频繁的错误模式"

# 按 Alt+Tab（或 Option+Tab）切换 thinking 模式
# 或在 prompt 中明确要求深度思考

请深入分析 @src/api/handler.ts 中的竞态条件问题，
逐步推理可能的执行顺序和数据竞争场景。

按 Esc+Esc → 打开回退菜单（rewind menu）
选择要回退到的检查点
Claude 会撤销该点之后的所有变更

# 启动时开启详细模式
claude --verbose
 
# 查看 Claude 的工具调用、文件读取等详细信息
# 有助于理解 Claude 的决策过程

调试 prompt 模板：

@[文件路径] 中的 [函数名] 在 [触发条件] 时出现 [错误类型]。
错误信息：[完整错误信息]
预期行为：[应该发生什么]
实际行为：[实际发生了什么]

请：
1. 分析根本原因
2. 给出修复方案
3. 添加防御性代码防止复发

// .claude/settings.json
{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Write|Edit",
        "command": "npx prettier --write \"$CLAUDE_FILE_PATH\""
      }
    ],
    "PreToolUse": [
      {
        "matcher": "Bash",
        "command": "echo '$CLAUDE_TOOL_INPUT' | node scripts/validate-command.js"
      }
    ]
  }
}

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Write",
        "command": "npx prettier --write \"$CLAUDE_FILE_PATH\" && npx eslint --fix \"$CLAUDE_FILE_PATH\""
      }
    ]
  }
}

{
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "Bash",
        "command": "node scripts/block-dangerous-commands.js"
      }
    ]
  }
}

# 单次执行，结果输出到 stdout
claude -p "运行测试并报告结果"
 
# 指定输出格式
claude -p "分析代码质量" --output-format json
 
# 管道输入
git diff | claude -p "为这些变更生成 changelog 条目"

# .github/workflows/ai-review.yml
name: AI Code Review
on: [pull_request]
 
jobs:
  review:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - name: AI Review
        run: |
          git diff origin/main...HEAD | claude -p \
            "审查这些代码变更，关注安全问题和性能问题" \
            --output-format json
        env:
          ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}

# 添加到 ~/.zshrc 或 ~/.bashrc
alias clint="claude -p '/lint'"
alias cpush="claude -p '/push'"
alias ccommit="claude -p '/commit'"
alias creview="claude -p '审查最近的代码变更'"

#!/bin/bash
# 批量为所有 TODO 生成修复建议
for file in $(grep -rl "TODO" src/); do
  echo "=== $file ==="
  claude -p "分析 @$file 中的 TODO 注释，给出实现建议"
done

# 1. 创建 .claudeignore
cat > .claudeignore << 'EOF'
node_modules/
dist/
.next/
coverage/
*.log
*.lock
EOF
 
# 2. 创建常用斜杠命令
mkdir -p .claude/commands
 
# 3. 创建 commit 命令
cat > .claude/commands/commit.md << 'EOF'
---
description: 规范化提交
allowed-tools: Bash(git:*)
model: haiku
---
!`git diff --cached`
按 Conventional Commits 生成 commit message 并提交。
EOF
 
# 4. 创建 review 命令
cat > .claude/commands/review.md << 'EOF'
---
description: 代码审查
model: sonnet
---
审查 @$1 的代码质量，关注：
1. 安全漏洞
2. 性能问题
3. 可维护性
4. 测试覆盖
EOF
 
# 5. 启动 Claude Code
claude

早上开始 → claude（新会话）
  ↓
功能开发 → 精确 @ 引用文件，Sonnet 模型
  ↓
提交代码 → /commit（Haiku 模型，快速便宜）
  ↓
切换任务 → /rename feature-x → /clear
  ↓
修复 Bug → 新会话，管道输入错误日志
  ↓
下班前   → /push 推送所有变更