常用命令速查表

<!-- 文件路径：.claude/commands/recap.md -->
---
description: 给出当前任务的中文进度摘要
argument-hint: "[关注点]"
---

请用中文输出当前任务的：
1. 已完成事项（要点 list）
2. 阻塞 / 风险
3. 下一步建议

如果传入了关注点 $ARGUMENTS，请围绕该关注点展开。

{
  "$schema": "https://json.schemastore.org/claude-code-settings.json",
  "permissions": {
    "defaultMode": "acceptEdits",
    "allow": [
      "Bash(pnpm install)",
      "Bash(pnpm dev:*)",
      "Bash(pnpm test:*)",
      "Bash(pnpm lint:*)",
      "Bash(git status)",
      "Bash(git diff:*)",
      "Bash(git log:*)",
      "Read(./**)",
      "WebFetch(domain:docs.anthropic.com)"
    ],
    "deny": [
      "Bash(rm -rf *)",
      "Bash(git push --force*)",
      "Read(./.env*)",
      "Read(./secrets/**)"
    ],
    "ask": [
      "Bash(git push:*)",
      "Bash(pnpm publish:*)"
    ]
  },
  "env": {
    "NODE_ENV": "development"
  }
}

{
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "Bash",
        "hooks": [
          {
            "type": "command",
            "command": "node ~/.claude/hooks/guard-rm.js",
            "timeout": 5000
          }
        ]
      }
    ],
    "PostToolUse": [
      {
        "matcher": "Edit|Write",
        "hooks": [
          {
            "type": "command",
            "command": "pnpm exec prettier --write \"$CLAUDE_FILE_PATHS\""
          }
        ]
      }
    ],
    "UserPromptSubmit": [
      {
        "hooks": [
          {
            "type": "command",
            "command": "echo \"[$(date +%H:%M)] $(git rev-parse --short HEAD)\""
          }
        ]
      }
    ],
    "Stop": [
      {
        "hooks": [
          { "type": "command", "command": "afplay /System/Library/Sounds/Glass.aiff" }
        ]
      }
    ]
  }
}

# 项目名

## 项目简介
1-2 段说明项目目标、技术栈、核心业务名词。

## 技术栈
- 语言：TypeScript 5.x
- 框架：Nuxt 4 / Vue 3
- 数据库：PostgreSQL + Drizzle ORM
- 包管理：pnpm（**禁止使用 npm/yarn**）

## 目录约定
- `apps/web` —— 前端应用
- `packages/ui` —— 共享 UI 组件
- `packages/types` —— 跨端 TS 类型

## 命令
- `pnpm dev:web` —— 启动 Web 开发服务器
- `pnpm test` —— 运行所有测试
- `pnpm lint` —— Lint + typecheck

## 编码规范
- 严格 TS：禁止 `any`、禁止 `// @ts-ignore`
- 命名：组件 PascalCase，文件 kebab-case
- 测试：每个 service 必须有单元测试

## 工作流
- 分支风格：trunk-based
- Commit message：中文，祈使语气
- PR：先 self-review，再请求他人

## 上下文外部链接
@docs/architecture.md
@docs/glossary.md

.claude/skills/<skill-name>/
├── SKILL.md           # 必须，含 frontmatter 元数据
├── references/        # 可选，详细参考资料
│   └── api.md
├── scripts/           # 可选，可执行脚本
│   └── run.sh
└── assets/            # 可选，模板 / 静态资源
    └── template.html

---
name: changelog-writer
description: 当用户要求"写 changelog""更新 CHANGELOG"或在合并 PR 后整理变更日志时使用。基于 git log 与 PR 描述生成符合 Keep a Changelog 规范的中文条目。
---

# Changelog Writer

## 何时触发
- 用户说"写 changelog""更新版本说明""整理 release notes"
- 合并 PR 后，用户希望沉淀对外版本说明

## 步骤
1. 询问目标版本号（语义化版本）
2. 从 `git log <last-tag>..HEAD` 提取提交
3. 按 Added / Changed / Fixed / Removed 分类
4. 写入 `CHANGELOG.md` 顶部，保留既有内容

## 规范
- 中文为主，技术名词保留英文
- 每条 ≤ 1 行，必要时附 PR 链接
- 用户视角而非实现视角

## 反例
- 「重构 user service」← 实现视角，禁止
- 「登录失败时显示更明确的错误信息」← 用户视角，✅

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/Users/me/projects"]
    },
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "${GITHUB_TOKEN}"
      }
    },
    "postgres": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-postgres"],
      "env": {
        "DATABASE_URL": "${DATABASE_URL}"
      }
    }
  }
}

进入 plan 模式（/plan 或 Shift+Tab 切换），然后描述：

我要给登录接口加上短信验证码功能。请先调研现有代码，
给出一份方案：
1. 涉及哪些文件
2. 需要新增哪些类型 / 接口
3. 改动顺序
4. 风险点 / 待确认问题
不要直接修改代码。

请用中文给我一份当前任务的进度摘要：
1. 已完成
2. 进行中（具体卡在哪）
3. 待办
4. 任何需要我决策的问题

现象：<bug 描述>
请：
1. 提出 3 个可能的根因，按概率排序
2. 给出每个根因的验证方法
3. 不要直接改代码，先告诉我你倾向哪个

开始之前，列出你为完成这个任务做出的所有假设。
我会逐条确认 / 修正。

假设这次改动一周后线上出了事故。请列出：
1. 最可能的 5 种事故
2. 各自的兆头 / 监控点
3. 现在能加哪些防御

请以严格的 senior reviewer 视角审查 git diff：
- 安全
- 边界条件
- 命名 / 可读性
- 测试覆盖
对每条 finding 标注严重性（blocker / major / minor / nit）。

完成后，用中文给我一份学习笔记：
- 你做了什么
- 为什么这样做（替代方案与权衡）
- 我后续应该补哪些知识

# 自检环境
claude doctor

# 看版本
claude --version

# 看当前会话状态
/status

# 看成本与 token
/cost

# 看权限
/permissions

# 看 hooks
/hooks

# 看记忆
/memory

# 看 MCP
/mcp

{
  "permissions": {
    "allow": [
      "Bash(pnpm install)",
      "Bash(pnpm add:*)",
      "Bash(pnpm remove:*)",
      "Bash(pnpm dev:*)",
      "Bash(pnpm build:*)",
      "Bash(pnpm test:*)",
      "Bash(pnpm lint:*)",
      "Bash(pnpm typecheck)",
      "Bash(pnpm format)",
      "Bash(pnpm exec:*)",
      "Bash(pnpm dlx:*)"
    ]
  }
}

{
  "permissions": {
    "allow": [
      "Bash(git status)",
      "Bash(git status -s)",
      "Bash(git diff)",
      "Bash(git diff --cached)",
      "Bash(git diff:*)",
      "Bash(git log)",
      "Bash(git log:*)",
      "Bash(git show:*)",
      "Bash(git branch)",
      "Bash(git branch -a)",
      "Bash(git remote -v)",
      "Bash(git rev-parse:*)",
      "Bash(git stash list)",
      "Bash(git tag)",
      "Bash(git fetch)",
      "Bash(git fetch:*)"
    ],
    "ask": [
      "Bash(git push:*)",
      "Bash(git reset --hard:*)",
      "Bash(git rebase:*)",
      "Bash(git checkout --:*)"
    ],
    "deny": [
      "Bash(git push --force:*)",
      "Bash(git push -f:*)",
      "Bash(rm -rf *)"
    ]
  }
}

{
  "permissions": {
    "allow": [
      "Bash(ls:*)",
      "Bash(pwd)",
      "Bash(fd:*)",
      "Bash(rg:*)",
      "Bash(jq:*)",
      "Bash(cat:*)",
      "Bash(wc:*)",
      "Bash(head:*)",
      "Bash(tail:*)",
      "Bash(tree:*)"
    ]
  }
}

{
  "permissions": {
    "allow": [
      "Bash(docker ps)",
      "Bash(docker compose ps)",
      "Bash(docker compose logs:*)",
      "Bash(docker logs:*)"
    ],
    "ask": [
      "Bash(docker compose up:*)",
      "Bash(docker compose down:*)",
      "Bash(docker run:*)"
    ],
    "deny": [
      "Bash(docker system prune:*)",
      "Bash(docker volume rm:*)"
    ]
  }
}

# 把 prompt 直接传入，输出 JSON 便于解析
claude -p "审查当前 git diff 并把问题写入 review.md" \
  --output-format json \
  --permission-mode acceptEdits

name: claude-review
on:
  pull_request:
    types: [opened, synchronize]

jobs:
  review:
    runs-on: ubuntu-latest
    permissions:
      contents: read
      pull-requests: write
    steps:
      - uses: actions/checkout@v4
        with: { fetch-depth: 0 }
      - name: Install Claude Code
        run: npm i -g @anthropic-ai/claude-code
      - name: Run review
        env:
          ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}
        run: |
          claude -p "对本 PR 的 diff 做 senior reviewer 评审，输出 markdown 到 review.md" \
            --permission-mode acceptEdits \
            --output-format text
      - name: Comment on PR
        run: gh pr comment ${{ github.event.pull_request.number }} --body-file review.md

{
  "hooks": {
    "Stop": [
      {
        "hooks": [
          {
            "type": "command",
            "command": "bash -c 'cd \"$CLAUDE_PROJECT_DIR\" && git add -A && git diff --cached --quiet || git commit -m \"chore(claude): autosave $(date +%H%M)\"'"
          }
        ]
      }
    ]
  }
}

.claude/agents/
├── reviewer.md       # 项目级
└── researcher.md
~/.claude/agents/
└── chinese-writer.md # 用户全局

---
name: code-reviewer
description: 审查最近的 git diff，给出 blocker/major/minor 分级反馈
tools:
  - Read
  - Grep
  - Glob
  - Bash(git diff:*)
  - Bash(git log:*)
model: claude-opus-4-7
---

你是一位严格的资深代码评审员。原则：
- 优先指出安全 / 数据正确性问题
- 关注边界条件、错误路径、并发
- 不放过命名歧义与可读性
- 反例使用代码片段说明

输出格式：
## Blockers
- ...
## Majors
- ...
## Minors / Nits
- ...

请用 code-reviewer 子智能体评审当前的 git diff。

任务：理解 <path/to/file.ts>。
请：
1. 用 5 行以内中文概括它做了什么
2. 列出它依赖的关键模块（不超过 8 条）
3. 列出调用它的地方（用 grep 实证）
不要修改任何文件。

我要修这个 bug：<现象描述>
约束：
- 单文件、最少行变更
- 不引入新依赖
- 必须新增 / 修改至少 1 个测试覆盖该 case
- 修完后跑 `pnpm test` 直到通过

重构开始前请回答：
1. 当前结构的痛点（具体例子）
2. 你计划的目标结构（一句话 + 一张文字版示意）
3. 兼容策略（如何保证调用方不动）
4. 回滚方案（万一失败如何 5 分钟内回滚）

用一段话向产品经理解释这次改动：
- 解决了什么问题
- 用户能感知到什么
- 上线后我们应该观察哪个指标
不要出现技术术语。

完成前必须：
1. `pnpm typecheck` 通过
2. `pnpm lint` 无 error
3. `pnpm test` 全绿
4. 自己 git diff 自检一遍，列出 3 条「我作为评审最担心的点」