科研 Skill
中国传统音乐数字化
arts-chinese-traditional-music
将简谱、工尺谱、减字谱转写为MusicXML/kern,做宫调判别与旋律统计分析。适用于民歌色彩区划、曲牌比较与古谱打谱研究。
发布者 Codar安全审核通过v0.1.0更新于 2026-11-18
SKILL.md
中国传统音乐研究与乐谱数字化(Chinese Traditional Music Research & Notation Encoding)
适用场景
- 将简谱、工尺谱(含昆曲曲谱、俗字谱)、古琴减字谱等转写为可计算的编码格式,建立可检索的曲谱语料库。
- 对民歌、器乐曲、戏曲唱腔做五声调式(宫商角徵羽)与“七声三种音阶”(清乐、雅乐、燕乐)判别,统计主音、骨干音与终止式。
- 比较同一曲牌或板式(如京剧西皮/二黄、昆曲南北曲牌)的不同版本,分析“依字行腔”中字调与旋律走向的关系。
- 民歌色彩区划研究:按地域抽取旋律特征(音程分布、音阶结构、句式),做聚类与地图可视化。
- 古谱打谱的数字化记录:保留原谱符号、版本异文与打谱者的节奏解释,供校勘复核。
边界与不适用
- 通用的 MusicXML 读取、music21 基础分析、librosa 音频特征提取由其他 Plugin 覆盖(如 music21 / librosa 相关 Skill),此处只处理中国传统记谱与调式体系的特殊问题。
- 演奏录音的速度、力度分析见
arts-performance-recording-analysis;田野录音档案规范见arts-ethnomusicology-fieldwork。 - 不替代打谱专家对古谱节奏的学术判断;自动转写结果只能作为待校勘的草稿。
- 不提供受版权保护的现代出版乐谱全文,语料库发布需确认版权状态。
工作流
-
界定语料与版本
- 输入:研究问题(如“陕北信天游的音阶结构”)、候选谱本清单(《中国民间歌曲集成》各省卷、《中国戏曲音乐集成》、《九宫大成南北词宫谱》、《纳书楹曲谱》、琴谱如《神奇秘谱》等)。
- 操作:登记每首曲目的出处卷册、页码、采录者/记谱者、采录地、版本。
- 产出:曲目元数据表。决策点:同曲多版本时,先确定“底本”与“参校本”。
-
选择编码方案
- 简谱、工尺谱转为五线谱语义后可用 MusicXML 或 MEI;需大规模统计时推荐 Humdrum
**kern(逐行文本,便于 grep 式分析)。 - 必须额外保留原记谱信息:工尺字(上尺工凡六五乙)、板眼符号(板、眼、底板、腰板)、简谱首调“1=D”等调高标记。在 MEI 中可用注释或自定义属性;在 kern 中可增加
**gongche等自定义 spine。 - 减字谱:记录指法、徽位、弦序,音高与节奏解释分 spine 存放,以区分“谱面信息”与“打谱解释”。
- 产出:编码规范文档(字段说明 + 示例)。
- 简谱、工尺谱转为五线谱语义后可用 MusicXML 或 MEI;需大规模统计时推荐 Humdrum
-
转写与校对
- 简谱可手工录入或借助 OMR 工具后人工核对;工尺谱、减字谱目前基本依赖人工录入。
- 双人独立录入 10%–20% 样本,计算一致率;不一致处回到原谱裁定。
- 产出:编码文件 + 校勘记录表(曲目、小节、原谱、录入、裁定理由)。
-
调式与宫调分析
- 统计音级出现频次(按时值加权)、首尾音、句末音,判定五声骨干与偏音(清角、变宫、闰、变徵)。
- 依“以宫定调、以主音定式”的分析习惯,同时报告“宫音位置”与“调式主音”,避免只给西方大小调标签。
- 戏曲唱腔另需标注板式、字位与行腔,统计字调(阴平/阳平/上/去,或方言调类)与旋律升降的对应率。
- 决策点:调式归属存在争议(如徵/羽交替)时,如实报告多候选并说明依据。
-
跨曲目比较与可视化
- 特征:音阶类型、音程直方图、旋律轮廓、句数句式、终止音。
- 方法:层次聚类、主成分分析,按采录地绘地图。
- 产出:图表 + 特征矩阵 CSV。
-
解释与回到文献
- 将计算结果与已有区划理论、乐种史料对照;差异需检查是否来自记谱者习惯(如统一记为“1=C”)而非音乐本身。
工具与数据源
- 编码格式:MusicXML、MEI(Music Encoding Initiative,music-encoding.org)、Humdrum
**kern(Humdrum Toolkit 与 humlib)。 - 软件:MuseScore(简谱需插件或转五线谱录入)、Verovio(MEI/kern 渲染)、music21(读写 kern/MusicXML/MEI)。
- 曲谱文献:《中国民族民间器乐曲集成》《中国民间歌曲集成》《中国戏曲音乐集成》《中国曲艺音乐集成》,《九宫大成南北词宫谱》,《琴曲集成》。
- 文献检索:CNKI、中国音乐学院/中央音乐学院图书馆、中华经典古籍库、国家图书馆“中华古籍资源库”。
- 已有数字语料:Essen Folksong Collection 中含部分中国民歌(kern 格式,随 Humdrum/music21 语料分发);CompMusic 项目的京剧唱腔语料(Jingju a cappella singing dataset)。
最小示例:从 kern 统计五声音级分布
# pip install music21
from collections import Counter
from music21 import converter
score = converter.parse("song.krn") # Humdrum kern 文件
weights = Counter()
for n in score.flatten().notes:
for p in n.pitches:
weights[p.pitchClass] += float(n.quarterLength)
total = sum(weights.values())
for pc, w in sorted(weights.items(), key=lambda x: -x[1]):
print(pc, round(w / total, 3))
# 候选宫音:寻找使“宫商角徵羽”五音权重之和最大的音级
PENTA = [0, 2, 4, 7, 9]
best = max(range(12), key=lambda g: sum(weights[(g + i) % 12] for i in PENTA))
coverage = sum(weights[(best + i) % 12] for i in PENTA) / total
print("候选宫音 pitch class:", best, "五声覆盖率:", round(coverage, 3))
说明:以上仅给出“宫音候选”与五声覆盖率,调式主音需结合句末音、终止音另行判断。
质量检查
- 每首曲目可追溯到集成卷册/古谱版本与页码。
- 原谱符号(工尺字、板眼、减字谱指法)在编码中有保留,未被“西化”丢失。
- 抽样双录一致率已报告,校勘记录完整。
- 调式判定同时报告宫音与主音,争议曲目给出多候选。
- 区分记谱者习惯(统一调高、简化装饰音)造成的偏差与真实音乐差异。
- 打谱/节奏解释与谱面信息分开存储并署名。
- 语料公开前确认版权与出版社授权;集成类出版物不可整卷公开。
输出格式
- 曲目元数据表:曲目ID、曲名、乐种/体裁、地区、采录/记谱者、出处卷册、页码、原记谱类型、编码文件名。
- 分析结果表:曲目ID、宫音、调式主音、调式名(如“D徵调式”)、音阶类型、偏音、句数、终止音、备注。
- 报告章节:语料说明 → 编码规范 → 校勘方法与一致率 → 调式/旋律分析 → 比较与可视化 → 讨论与局限。
参考规范与文献
- 杨荫浏,《中国古代音乐史稿》,1981。
- 黄翔鹏,《传统是一条河流》,1990。
- 杜亚雄,《中国民族基本乐理》。
- 苗晶、乔建中关于汉族民歌近似色彩区划分的研究(20 世纪 80 年代)。
- 童忠良等,《中国传统乐理基础教程》。
- Huron, D. (1994). The Humdrum Toolkit: Reference Manual.
- Music Encoding Initiative, MEI Guidelines.
示例提示词
帮我把《中国民间歌曲集成·陕西卷》中 30 首信天游简谱编码为 kern,并统计各曲的宫音、调式主音与五声覆盖率。
所属插件
安装该插件会一并获得同领域的 11 个 Skill / MCP。
同插件的其他科研 Skill
- 书画著录流传考证整理题跋印鉴、检索著录书与博物馆开放数据,建立带证据等级的流传链条。适用于书画鉴藏史与流散文物追索研究,不做真伪鉴定。
- 色彩构图计算分析在CIELAB空间用k-means提取主色、计算显著性图与构图线指标。适用于绘画设计作品的形式分析与风格量化研究。
- 设计评价与用户实验用SUS、NASA-TLX、语义差异法与眼动追踪设计用户实验并做统计分析。适用于产品界面包装设计的效果评价研究。
- 设计研究方法按双钻模型组织设计民族志、文化探针与用户旅程图,提炼可迁移知识贡献。适用于设计学论文与研究型设计的过程记录。
- 民族音乐学田野采录规范田野录音设备参数、元数据与长期保存格式,处理知情同意与传承人权益。适用于少数民族音乐田野调查与资料库建设。
- 影视产业票房数据整合官方与平台票房数据,辨析统计口径差异并做回归面板分析。适用于档期效应、口碑传播与电影政策研究,须遵守爬取合规。
- 电影镜头计算分析用PySceneDetect自动切镜并人工校正,计算镜头长度分布与剪辑节奏曲线。适用于导演风格与类型片剪辑节奏的电影学研究。
- 图像志与图像学分析按潘诺夫斯基三层次组织图像释读,用Iconclass与自定义编码表考证母题谱系。适用于美术史图像释读与跨文化图像比较。
- 演奏录音表演分析在Sonic Visualiser标注拍点,计算速度弹性与力度曲线并用DTW对齐多版本演奏。适用于名家录音诠释风格的比较研究。
- 技术美术史材料分析用红外、X光、多光谱成像与XRF/拉曼光谱做绘画材料无损检测。适用于书画材料研究与修复前评估,不单独构成真伪定论。
常见问题
中国传统音乐数字化能做什么?
将简谱、工尺谱、减字谱转写为MusicXML/kern,做宫调判别与旋律统计分析。适用于民歌色彩区划、曲牌比较与古谱打谱研究。
如何安装中国传统音乐数字化?
在科搭 Codar 左侧点击「插件」,在「组件」页签搜索「中国传统音乐数字化」并安装;在 Claude Code 或 Codex 中可以发送本页的安装提示词,或下载 Skill 包后解压到 ~/.claude/skills 或 ~/.codex/skills。
中国传统音乐数字化需要哪些权限?
该科研 Skill没有声明额外权限;执行具体操作时仍由 Agent 按自身规则请求确认。
中国传统音乐数字化经过官方审核吗?
是。SpeedSkills 收录的每个版本都会记录内容摘要与权限声明,当前版本已通过安全审核。