关于 peer-review-template
peer-review-template 是用于在重要分析交付利益相关方前开展评审的技能,涵盖确定范围、检查分析与代码、记录反馈及作者回应,并完成签核。
主要功能
- 01明确评审范围与预期
- 02分析严谨性检查清单
- 03代码与 SQL 评审指引
- 04分类反馈与回应模板
- 05记录评审签核
适用场景
- 01仪表板上线前评审
- 02检查战略报告中的分析
- 03评估 A/B 测试结论
- 04评审拟对外引用的分析
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ nimrodfisher/ data-analytics-skills --skill peer-review-template安装后在 Claude Code 中输入/peer-review-template确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
assets/peer_review_template.mdreview_response_template.mdreferences/analytical_rigor_checklist.mdcode_review_for_analysis.mdpeer_review_framework.md详细介绍
适用时机
在向利益相关方交付任何会影响重大决策的分析之前。同行评审应作为标准交付检查清单的一部分,适用于即将投入生产的仪表板、用于战略决策的报告、A/B 测试结论,以及任何将被外部引用的分析。
流程
- 确定评审范围 — 与作者明确需要哪种评审:逻辑检查、统计有效性、代码评审或呈现清晰度。使用
references/peer_review_framework.md明确预期。 - 评审分析严谨性 — 按照
references/analytical_rigor_checklist.md逐项检查:问题与方法是否一致?假设是否成立?结论是否有数据支持? - 评审代码或 SQL — 如果分析涉及代码,请按照
references/code_review_for_analysis.md检查:可复现性、正确性、可读性和性能。 - 撰写反馈 — 使用
assets/peer_review_template.md中的反馈结构:必须修复的问题、建议修复的问题和可选改进。具体指出问题;“这里不清楚”不是可执行的反馈。 - 作者回复 — 作者逐项处理反馈并注明处理方式(已修复/接受现状并说明理由/暂缓);使用
assets/review_response_template.md。 - 结束评审 — 评审者确认必须修复的问题均已解决并签字确认;在
assets/peer_review_template.md中记录评审结果。
此技能所需输入
- 待评审的分析产出(笔记本、报告、仪表板规范或 SQL)
- 与作者商定的评审范围
- 评审者姓名和角色
输出
- 已完成的评审及分类反馈(
peer_review_template.md) - 作者回复记录(
review_response_template.md) - 签字确认
评论
支持 Markdown