name: poetry description: 中国古诗词展示和检索工具。当用户想要展示、检索、查找中国古诗词（包括唐诗、宋词、宋诗及其他朝代诗歌）时使用此 skill。用户可能提到"诗歌"、"古诗"、"诗词"、"唐诗"、"宋词"、"展示诗篇"、"找一首诗"等相关表达，或指定具体的诗人、诗名、诗句关键词。此 skill 负责从数据库中检索诗歌并按照特定格式展示，包括诗歌内容和作者简介。 metadata: version: "1.1.0"
Poetry Skill - 中国古诗词展示工具
本 skill 帮助用户检索和展示中国古诗词，按照规范的格式输出诗歌内容。
功能概述
- 从 chinese-poetry 数据库检索诗歌（支持唐诗、宋词、宋诗及其他朝代）
- 按照指定格式展示诗歌内容
- 提供作者简介和创作背景信息
诗歌展示格式
严格按照以下格式输出诗歌：
诗歌主体
- 标题：独占一行，居中显示
- 作者：独占一行，居中显示（与标题对齐）
- 诗句：以
。或；为断点，每句独占一行
示例：
静夜思
李白
床前明月光
疑是地上霜
举头望明月
低头思故乡
作者简介
在诗歌内容后隔两行，提供作者简介和创作背景。
要求：
- 字数控制在 200-300 字之间
- 包含以下信息（按优先级）：
- 生卒年份
- 字号、籍贯
- 文学成就和代表作品
- 本诗创作时的历史背景和诗人处境
示例：
李白（701-762），字太白，号青莲居士，祖籍陇西成纪（今甘肃天水）。唐代伟大的浪漫主义诗人，被后人誉为"诗仙"。其诗风豪放飘逸，想象丰富，语言流转自然，音律和谐多变。代表作有《将进酒》《蜀道难》《望庐山瀑布》等。《静夜思》作于唐玄宗开元十四年（726年），当时李白客居扬州旅舍，在一个月夜，诗人因思念故乡而作此诗，表达了浓浓的思乡之情。
使用流程
1. 理解用户需求
分析用户的查询，识别以下关键信息：
- 检索条件：诗人姓名、诗歌标题、诗句关键词、朝代、体裁等
- 输出要求：单首诗歌、多首诗歌、按条件筛选等
2. 检索诗歌
使用 scripts/poetry_loader.py 脚本从数据库检索诗歌：
python scripts/poetry_loader.py --query <检索条件>
支持的查询方式：
- 按作者：
--author "李白" - 按标题：
--title "静夜思" - 按关键词：
--keyword "明月" - 按朝代：
--dynasty "唐" - 按体裁：
--type "五言绝句"
组合查询示例：
python scripts/poetry_loader.py --author "李白" --type "七言绝句"
3. 格式化输出
使用检索到的诗歌数据，按照上述格式规则输出诗歌内容。
4. 补充作者简介
从 references/authors.json 获取作者简介信息。如果该作者的信息不存在：
- 使用通用知识编写简介（200-300字）
- 包含生卒年份、字号籍贯、文学成就、创作背景
- 确保信息准确可靠
数据访问脚本
poetry_loader.py 功能
脚本位置：scripts/poetry_loader.py
主要功能：
- 从 chinese-poetry 数据库下载和解析 JSON 数据
- 支持多种查询条件（作者、标题、关键词等）
- 返回格式化的诗歌数据
脚本使用方法：
# 基本查询
python scripts/poetry_loader.py --author "李白"
# 组合查询
python scripts/poetry_loader.py --author "苏轼" --type "宋词"
# 关键词搜索
python scripts/poetry_loader.py --keyword "明月"
# 限制返回数量
python scripts/poetry_loader.py --author "杜甫" --limit 5
输出格式（JSON）：
{
"poems": [
{
"title": "静夜思",
"author": "李白",
"contents": ["床前明月光", "疑是地上霜", "举头望明月", "低头思故乡"],
"strains": "五言绝句",
"dynasty": "唐"
}
]
}
注意事项
- 格式规范：严格遵守诗歌展示格式，标题和作者必须居中，诗句必须按断点分行
- 字数控制：作者简介严格控制在 200-300 字之间
- 信息准确：确保作者简介信息准确，必要时验证多个来源
- 数据缓存：首次运行 poetry_loader.py 会下载数据库，后续使用缓存
- 多首诗歌：如果检索到多首诗歌，优先展示最著名或最符合查询意图的诗歌
- 无结果处理：如果未找到匹配的诗歌，告知用户并建议调整查询条件
常见使用场景
场景 1：按作者检索
用户：找一首李白的诗
操作：使用 --author "李白" 查询，展示李白的代表作
场景 2：按标题检索
用户：展示《静夜思》
操作：使用 --title "静夜思" 查询，展示完整诗歌和作者简介
场景 3：关键词搜索
用户：找一首关于明月的诗
操作：使用 --keyword "明月" 查询，展示相关诗歌
场景 4：特定体裁
用户：找一首苏轼的宋词
操作：使用 --author "苏轼" --type "宋词" 查询
扩展功能
如果用户需要更高级的功能：
- 按朝代筛选：
--dynasty "唐"或--dynasty "宋" - 按体裁筛选：
--type "五言律诗"、--type "七言绝句"、--type "宋词" - 批量检索：使用
--limit控制返回数量 - 组合查询：同时使用多个条件进行精确检索