mcpField
C
critique

critique

github.com/b-open-io测试与质量1659 次安装4 周前更新
代码仓库

关于 critique

critique 是用于查看和审阅 Git 变更的命令行工具，面向开发者。它提供终端界面与 HTML 预览，并可生成 AI 变更说明。

主要功能

  1. 01语法高亮与分栏差异视图
  2. 02按字过滤并比较提交或分支
  3. 03监视文件变化并刷新
  4. 04生成可分享的 HTML 预览
  5. 05AI 分析并归组相关变更

适用场景

  1. 01检查暂存或未暂存的代码变更
  2. 02审阅提交及分支间差异
  3. 03查看 AI 生成的代码修改
  4. 04通过浏览器分享大型差异

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/b-open-io/prompts --skill critique

安装后在 Claude Code 中输入/critique确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

.clawnet/
unsigned-skill.json
scripts/
open-critique-pane.sh
open-critique.sh

详细介绍

通过语法高亮、分栏视图和逐词差异来查看 git 差异。使用终端界面或网页预览，向用户展示会话期间更改了哪些代码。

前提条件

Critique 需要 Bun（不支持 Node.js）：

# Run directly (no install needed)
bunx critique

# Or install globally
bun install -g critique

核心命令

查看当前更改
# Unstaged changes (includes untracked files)
critique

# Staged changes only
critique --staged

# Watch mode - auto-refresh on file changes
critique --watch
查看提交
# Last commit
critique HEAD

# Specific commit
critique --commit HEAD~1
critique --commit abc1234

# Combined changes from last N commits
critique HEAD~3 HEAD
比较分支（类似 PR）
# What feature-branch added vs main
critique main feature-branch

# What current branch added vs main
critique main HEAD
筛选文件
# Filter by glob pattern
critique --filter "src/**/*.ts"
critique --filter "src/**/*.ts" --filter "lib/**/*.js"

网页预览

生成可在浏览器中查看的 HTML 预览，适合分享或进行详细审查：

# Generate web preview
critique --web

# Generate and open in browser
critique --web --open

# Web preview for commits
critique HEAD --web --open
critique main HEAD --web --open

网页预览提供：

  • 完整的语法高亮
  • 显示更改前后内容的分栏视图
  • 可分享的 HTML 输出
  • 更适合查看大型差异

AI 驱动的审查

生成对代码更改的 AI 说明。最适合审查 AI 生成的更改：

# Review unstaged changes (uses OpenCode by default)
critique review

# Use Claude Code as the AI backend
critique review --agent claude

# Review specific commits
critique review HEAD
critique review --commit HEAD~1

# Review branch diff (like a PR)
critique review main HEAD

# Include session context for better explanations
critique review --agent claude --session <session-id>

# Generate web preview of AI review
critique review --web
critique review --web --open

AI 审查功能：

  • 按逻辑阅读顺序排列代码块
  • 将较大的代码块拆分为易于理解的小块
  • 使用图表和表格解释更改
  • 将不同文件中的相关更改分组

集成

Git Difftool

配置为默认的 git difftool：

git config --global diff.tool critique
git config --global difftool.critique.cmd 'critique difftool "$LOCAL" "$REMOTE"'

然后使用：git difftool HEAD~1

Lazygit

将以下内容添加到 ~/.config/lazygit/config.yml：

git:
  paging:
    pager: critique --stdin

从 Claude Code 运行

由于 TUI 在 Bash 工具中运行（隐藏/折叠），请使用以下方法之一：

选项 1：分屏（macOS + iTerm2，推荐）

在分屏中打开 critique，完成后自动关闭：

# Horizontal split (top/bottom)
/path/to/skills/critique/scripts/open-critique-pane.sh /path/to/repo -h

# Vertical split (side by side)
/path/to/skills/critique/scripts/open-critique-pane.sh /path/to/repo -v
选项 2：新建终端标签页（macOS + iTerm2）

在新标签页中打开 critique：

/path/to/skills/critique/scripts/open-critique.sh /path/to/repo
选项 3：网页预览（跨平台）

在浏览器中打开，适用于所有平台：

bunx critique --web --open

Claude 完成工作后的推荐用法

当用户想查看 Claude 修改后有哪些更改时：

  1. 新建终端标签页（macOS）：使用 osascript 在 iTerm 中打开 critique
  2. 网页预览：运行 critique --web --open，在浏览器中查看
  3. AI 说明式审查：运行 critique review --agent claude --web --open
  4. 与起始点比较：运行 critique HEAD~N HEAD --web --open

导航键（终端界面）

按键操作
j/k 或 ↓/↑浏览行
h/l 或 ←/→切换文件
Tab切换分栏/统一视图
q退出
?帮助

评论

支持 Markdown