mcpField
S
semantic-review

semantic-review

github.com/mikker测试与质量8260 次安装7 周前更新
代码仓库

关于 semantic-review

semantic-review 是一项仅在明确请求时使用的技能，通过隔离分析流程审查已完成的仓库变更。它面向明确要求语义审查的用户，并将审查反馈作为变更请求处理。

主要功能

  1. 01仅在明确请求时运行
  2. 02默认隔离分析
  3. 03选择 CLI 或 API 后端
  4. 04设置模型与分析力度
  5. 05通过浏览器查看并处理反馈

适用场景

  1. 01验证完成后审查仓库变更
  2. 02不带对话历史运行分析
  3. 03比较多个审查后端
  4. 04根据审查意见处理变更请求

安装

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

$npx skills add https://github.com/mikker/semantic-review --skill semantic-review

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

附带文件agents/openai.yaml

详细介绍

语义审查

此技能必须由用户明确按名称请求后才能运行，默认不运行。

实现和验证全部完成后，从仓库根目录运行审查。将用户随技能提供的参数理解为有关如何生成分析的自然语言偏好。

隔离分析（默认）

如果用户没有指定运行环境或模型偏好，请将分析与主对话隔离，并且不要向分析器提供任何实现历史：

  1. 如果此技能已在分叉或子 Agent 上下文中运行，请按照下方由调用方提供的工作流在那里生成分析。
  2. 否则，优先通过 --with claude、--with codex、--with gemini 或 --with pi，使用当前运行环境新启动一次非交互式调用。不要传递对话历史。跳过调用方提供的工作流，因为 CLI 会直接处理分析。
  3. 如果当前运行环境没有 CLI 后端，请使用原生隔离子 Agent 根据生成的提示词生成 JSON。
  4. 只有在无法隔离时，才在主托管上下文中生成分析。
调用方提供的分析工作流
  1. 在仓库之外创建临时提示词文件和 JSON 文件。
  2. 运行 npx --yes semantic-review --emit-prompt [git diff args...] > <prompt-file>。
  3. 阅读完整的提示词文件并按其要求执行。仅将所要求的 JSON 对象写入 JSON 文件，不要添加 Markdown 代码围栏或说明。
  4. 从生成提示词到打开报告期间，不要更改工作树。
  5. 在前台运行 npx --yes semantic-review --analysis <json-file> [the same git diff args...]，并设置较长的超时时间。
  6. 命令退出后删除这两个临时文件。

如果没有提供 git diff 参数，则会将暂存、未暂存和未跟踪的更改与 HEAD 进行审查。如需审查分支，请向两个命令传入相同的范围，例如 main...HEAD。自定义范围和管道传入的 diff 将按原样审查，因此请确保显式包含仍处于未跟踪状态的新增文件。

辅助分析

用户以任何方式表达了对运行环境或模型的偏好时，都要将其转换为独立的辅助调用。模型 ID 必须原样传递；effort 必须是 low、medium、high、xhigh 或 max 之一。如果无法确定用户所指的运行环境或模型，请向用户确认，而不是要求其使用特殊语法或擅自猜测。

npx --yes semantic-review --with anthropic --model claude-sonnet-5 --effort medium
npx --yes semantic-review --with openai --model gpt-5.6
npx --yes semantic-review --with claude --model sonnet
npx --yes semantic-review --with codex --model gpt-5.3-codex-spark
npx --yes semantic-review --with gemini --model gemini-2.5-pro
npx --yes semantic-review --with pi --model google/gemini-2.5-pro

例如，“使用 Claude Code 和 fable”表示 --with claude --model fable。可用的后端包括 anthropic、openai、claude、codex、gemini 和 pi。CLI 后端会复用现有的本地身份验证；API 后端使用 ANTHROPIC_API_KEY/ANTHROPIC_AUTH_TOKEN 和 OPENAI_API_KEY。如果用户只指定后端而未指定模型，请省略 --model，让该后端选择默认模型。

如需比较多个运行环境，请提供以逗号分隔的列表。不要添加 --model，因为模型 ID 因后端而异：

npx --yes semantic-review --with anthropic,codex

工作流

  1. 在前台运行最终审查命令，并设置较长的超时时间。绝不要在后台运行。
  2. 等待浏览器报告保持打开状态。审查者点击 Done 后，命令才会退出。
  3. 阅读标准输出。标准错误中的状态消息和审查 URL 不属于反馈。
  4. 如果标准输出表明审查已通过且没有评论，请结束。
  5. 否则，将每条评论都视为变更请求。完成请求的更改、验证，并总结所做的更改。
  6. 如果反馈不清楚、相互矛盾或不安全，请先询问用户再继续。

不要用语义审查代替测试、类型检查或常规代码检查。

评论

支持 Markdown