mcpField
K
kodevu

kodevu

github.com/gyteng测试与质量0687 次安装30 周前更新
代码仓库

关于 kodevu

kodevu 是一款 Node.js 命令行工具，可调用支持的 AI 审查 CLI 检查 Git 提交或 SVN 修订，并生成 Markdown 或 JSON 报告。它支持配置审查后端、提示词和持久化设置。

主要功能

  1. 01审查 Git 提交和 SVN 修订
  2. 02审查未提交的变更
  3. 03选择支持的审查后端
  4. 04生成 Markdown 或 JSON 报告
  5. 05配置提示词和持久化设置

适用场景

  1. 01审查最新或指定提交
  2. 02提交前检查未提交的变更
  3. 03将审查结果保存为指定目录中的 JSON
  4. 04应用自定义审查指令

安装

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

$npx skills add https://github.com/gyteng/kodevu --skill kodevu

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

包含的文件

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

package.json
.eslintrc.json
eslint.config.js
LICENSE
README.md
.gitignore
package-lock.json
.github/workflows/
publish-npm.yml
src/
diff-processor.js
config.js
logger.js
index.js
report-generator.js
shell.js
review-runner.js
progress-ui.js
git-client.js
svn-client.js
reviewers.js
prompts.js
token-usage.js
vcs-client.js
utils.js

详细介绍

Kodevu 技能

Kodevu 是一个 Node.js 工具，可获取 Git 提交或 SVN 修订版本，将差异发送给受支持的 AI 审查器 CLI，并将审查结果写入报告文件。它支持使用 ~/.kodevu/config.json 中的可选持久化配置文件，保存需要跨会话保留的设置。

用法

使用 npx kodevu 审查代码库。

审查最新提交
npx kodevu .
审查指定提交
npx kodevu . --rev <commit-hash>
审查最近 N 次提交
npx kodevu . --last 3
审查未提交的更改
npx kodevu . --uncommitted
支持的审查器

kodevu 支持多种 AI 审查器后端：auto、openai、gemini、codex、copilot。默认值为 auto，它会探测 PATH 中可用的 CLI 工具。

使用 OpenAI 的示例：

npx kodevu . --reviewer openai --openai-api-key <YOUR_API_KEY> --openai-model gpt-5-mini
生成 JSON 报告

默认情况下，审查报告会以 Markdown 文件形式生成在 ~/.kodevu/ 中。你可以指定 --format json，或使用 --output <dir> 更改输出目录。

npx kodevu . --format json --output ./reports
自定义提示词

你可以使用 --prompt 向审查器提供额外指令：

npx kodevu . --prompt "Focus on security issues and suggest optimizations."

也可以通过文件提供：--prompt @my-rules.txt

环境变量

所有选项也可以通过环境变量设置，避免重复指定标志：

  • KODEVU_REVIEWER – 默认审查器。
  • KODEVU_LANG – 默认输出语言。
  • KODEVU_OUTPUT_DIR – 默认输出目录。
  • KODEVU_PROMPT – 默认提示词指令。
  • KODEVU_OPENAI_API_KEY – openai 的 API 密钥。
  • KODEVU_OPENAI_BASE_URL – openai 的基础 URL。
  • KODEVU_OPENAI_MODEL – openai 的模型。
配置文件

要保存可跨 Shell 和 AI 工具调用保留的设置，请创建 ~/.kodevu/config.json：

{
  "reviewer": "openai",
  "openaiApiKey": "sk-...",
  "openaiBaseUrl": "https://your-gateway.example.com/v1",
  "openaiModel": "gpt-4o",
  "lang": "zh"
}

该文件为可选项，缺失时会被静默忽略。优先级：CLI 标志 > 环境变量 > 配置文件 > 默认值。

使用目标仓库

  • Git：target 必须是本地仓库或子目录。
  • SVN：target 可以是工作副本路径或仓库 URL。
npx kodevu /path/to/project --last 1

评论

支持 Markdown