关于 nutmeg-review
nutmeg-review 是用于审查足球数据代码和可视化的技能,帮助用户检查正确性、规范遵循情况及边缘情况。它根据代码和需求分派数据或图表审查 Agent,并汇总审查结果。
主要功能
- 01按任务分派专业审查 Agent
- 02检查足球数据处理代码
- 03检查图表代码与视觉呈现
- 04并行审查数据和图表
- 05按严重程度整理发现
适用场景
- 01审查比赛数据的获取与转换代码
- 02检查图表是否正确呈现足球数据
- 03测试交互式图表的边缘情况
- 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 都会收到:
- 待审查的文件路径
- 用户的配置(语言、提供方、经验水平)
- 要运行的模式(适用于 chart-reviewer)
- 上下文:用户说自己构建了什么,以及他们担心什么
数据审查员提示词模板
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 回复后:
- 去重——如果两者指出同一个问题(例如,坐标系错误),请合并为一项
- 按严重程度排序——先列严重问题,然后是警告,最后是信息
- 按逻辑分组——依次为数据问题、渲染问题、规范问题和边缘情况
- 简洁呈现——使用表格,包含严重程度、位置、问题和修复方案
何时建议进行视觉检查
如果 chart-reviewer 的代码审查发现潜在的渲染问题,但无法在未查看输出的情况下确认,请建议:
“代码审查发现了 [N] 个潜在的渲染问题。需要我对图表进行视觉检查吗?我需要一个 URL,或者你也可以在本地运行它。”
不要强制要求进行视觉检查——许多用户不方便在本地提供图表。仅代码审查也能发现大多数问题。
审查后
如果发现问题:
- 询问用户想修复哪些问题
- 对于严重问题,主动提出直接修复
- 对于警告和信息,说明权衡因素并让用户决定
如果没有发现问题:
- 明确说明结果。不要为了证明审查有必要而虚构问题。
- 可以提及检查了哪些内容,让用户知道审查很全面。
评论
支持 Markdown