protools_code_review_start
Initiate asynchronous code review. Returns task ID to query progress or retrieve partial results.
Instructions
启动异步代码审查任务,返回任务 ID 并支持查询进度或获取部分结果。
重要:审查结果需要批判性分析
不是所有报告的问题都需要修复,需根据项目实际情况判断
区分真正的问题 vs 过度工程化建议(如"建议添加更多配置")
INFO 级别通常可忽略,MINOR 需权衡成本,MAJOR/CRITICAL 才是重点
如果多个模型报告相同问题,可信度更高
高效等待(避免轮询)
设置较大的 wait_first_result_ms(如 60000)一次性等待首个结果
或在查询 status 前用 Bash sleep 间隔等待(如 sleep 15)
不要疯狂轮询 status,每次调用都消耗 token
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| cwd | No | 工作目录,多仓库工作区时指定要审查的项目路径(如 /home/user/Work/xxxx) | |
| mode | No | 代码压缩模式:full=完整代码 | compact=移除注释和import | skeleton=仅保留类/方法签名(适合全仓库审查) | compact |
| focus | No | 审查关注领域:security | performance | quality | maintainability | all | all |
| inputs | No | 要审查的文件/目录/glob 路径列表(与 git_mode 二选一) | |
| output | No | 输出方式:inline=直接返回 | file=写入文件 | inline |
| context | No | 附加的审查上下文或特殊说明 | |
| excludes | No | 排除的 glob 模式,如 ["**/test/**", "**/*.test.ts"] | |
| git_mode | No | Git diff 模式:staged=已暂存 | unstaged=未暂存 | all=全部未提交 | |
| provider | No | LLM Provider,默认从 LLM_PROVIDER 环境变量读取 | |
| providers | No | 并发审查使用的 provider 列表,默认使用 LLM_PROVIDER | |
| extensions | No | 过滤扩展名,如 [".ts", ".js"] | |
| output_dir | No | 输出目录(output=file 时使用) | |
| include_full_files | No | Git diff 模式下,是否同时包含变更文件的完整内容以提供更好的上下文 | |
| wait_first_result_ms | No | 等待首个模型结果的超时时间(毫秒),0 表示立即返回 | |
| include_project_context | No | 是否包含项目信息(package.json、目录结构等)以帮助模型理解项目背景 |