mcpField
N
nutmeg-review

nutmeg-review

github.com/withqwerty测试与质量55163 次安装今天更新
代码仓库

关于 nutmeg-review

nutmeg-review 是用于审查足球数据代码和可视化的技能,帮助用户检查正确性、规范遵循情况及边缘情况。它根据代码和需求分派数据或图表审查 Agent,并汇总审查结果。

主要功能

  1. 01按任务分派专业审查 Agent
  2. 02检查足球数据处理代码
  3. 03检查图表代码与视觉呈现
  4. 04并行审查数据和图表
  5. 05按严重程度整理发现

适用场景

  1. 01审查比赛数据的获取与转换代码
  2. 02检查图表是否正确呈现足球数据
  3. 03测试交互式图表的边缘情况
  4. 04同时评估数据处理和图表渲染

安装

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

$npx skills add https://github.com/withqwerty/nutmeg --skill nutmeg-review

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

详细介绍

审查

派遣专门的审查员,检查足球数据代码和可视化的正确性、规范遵循情况及边缘情况。

准确性

在回答任何有关特定提供方事实的问题前,请阅读并遵循 ${CLAUDE_PLUGIN_ROOT}/docs/accuracy-guardrail.md。

首先:检查配置

阅读 .nutmeg.user.md。如果文件不存在,请使用合理的默认设置(Python 和 pandas,中级水平)继续,并在最后建议运行 /nutmeg 进行设置。

确定范围

查看用户希望审查的内容。阅读相关文件,然后决定派遣哪些审查员:

信号派遣
代码处理足球数据(获取、筛选、转换、计算指标)data-reviewer Agent
代码渲染图表或可视化chart-reviewer Agent(模式 1:代码审查)
用户提供 URL 或说“检查一下效果”chart-reviewer Agent(模式 2:视觉检查)
图表包含筛选器、工具提示、状态或动态数据chart-reviewer Agent(模式 3:交互边缘情况)
代码导入 @withqwerty/campos-*(React + campos)chart-reviewer Agent(模式 4:React + Campos)——在上下文中传入 ${CLAUDE_PLUGIN_ROOT}/skills/_shared/campos-bridge.md
代码同时进行数据处理和图表渲染并行派遣两个 Agent

模式 4 的检测:在待审查文件中搜索 @withqwerty/campos- 或 from "@withqwerty/campos。任何匹配都会在模式 1 之外同时启用模式 4。

派遣

派遣多个 Agent 时并行启动。每个 Agent 都会收到:

  1. 待审查的文件路径
  2. 用户的配置(语言、提供方、经验水平)
  3. 要运行的模式(适用于 chart-reviewer)
  4. 上下文:用户说自己构建了什么,以及他们担心什么
数据审查员提示词模板
Review the football data code in [FILE_PATHS].

The user is working with [PROVIDER] data in [LANGUAGE].
They built: [DESCRIPTION]
Their concern: [WHAT_THEY_SAID]

Follow the full review checklist in your agent prompt. Use search_docs to verify
provider-specific facts (coordinate systems, qualifier IDs, event types).
图表审查员提示词模板
Review the chart code in [FILE_PATHS].

Mode(s): [Code Review / Visual Inspection / Interactive Edge Cases]
The user is building: [DESCRIPTION]
Their concern: [WHAT_THEY_SAID]
Stack: [LANGUAGE + LIBRARIES from profile]
[If visual inspection: URL or instructions to render]

Load ${CLAUDE_PLUGIN_ROOT}/skills/brainstorm/references/chart-canon.md for convention checking.

综合审查结果

两个 Agent 回复后:

  1. 去重——如果两者指出同一个问题(例如,坐标系错误),请合并为一项
  2. 按严重程度排序——先列严重问题,然后是警告,最后是信息
  3. 按逻辑分组——依次为数据问题、渲染问题、规范问题和边缘情况
  4. 简洁呈现——使用表格,包含严重程度、位置、问题和修复方案

何时建议进行视觉检查

如果 chart-reviewer 的代码审查发现潜在的渲染问题,但无法在未查看输出的情况下确认,请建议:

“代码审查发现了 [N] 个潜在的渲染问题。需要我对图表进行视觉检查吗?我需要一个 URL,或者你也可以在本地运行它。”

不要强制要求进行视觉检查——许多用户不方便在本地提供图表。仅代码审查也能发现大多数问题。

审查后

如果发现问题:

  • 询问用户想修复哪些问题
  • 对于严重问题,主动提出直接修复
  • 对于警告和信息,说明权衡因素并让用户决定

如果没有发现问题:

  • 明确说明结果。不要为了证明审查有必要而虚构问题。
  • 可以提及检查了哪些内容,让用户知道审查很全面。

评论

支持 Markdown