| name | csl |
| description | 根据用户描述的引用格式，生成 Zotero 可用的 CSL 样式文件 |
| argument-hint | [引用格式描述，如：GB/T 7714、APA、自定义格式说明] |
| user-invocable | true |
所有模板、参数、规则均位于 ${CLAUDE_SKILL_DIR} 目录下。
以下路径常量贯穿全流程：
| 常量 | 路径 |
|---|---|
| 预设目录 | ${CLAUDE_SKILL_DIR}/presets/ |
| 组件目录 | ${CLAUDE_SKILL_DIR}/components/ |
| 校验脚本 | ${CLAUDE_SKILL_DIR}/scripts/validate_csl.py |
| 预览脚本 | ${CLAUDE_SKILL_DIR}/scripts/preview_csl.py |
| 校验规则 | ${CLAUDE_SKILL_DIR}/validate/rules.md |
| 输出目录 | ${CLAUDE_SKILL_DIR}/output/ |
分析用户输入 $ARGUMENTS，判断信息是否充足。如果不足，必须先向用户确认以下内容再开始生成：
正文引用方式（三选一，决定 CSL class 和 citation 配置）：
[1-3] 以上标形式出现 → class="in-text", vertical-align="sup"[1-3] 与正文同行同字号 → class="in-text"class="note"参考文献列表示例：至少需要用户提供 2-3 条不同类型（期刊、书籍、会议等）的参考文献原文，用于反推格式参数。
正文引用示例（可选）：包含引用标记的原文段落，用于确认引用样式。
如果用户已经提供了上述信息（如粘贴了参考文献和正文），直接进入 Step 1 分析。
从用户输入提取格式需求，匹配预设关键词：
| 关键词 | 预设文件 |
|---|---|
| GB/T 7714、国标、中文顺序编码 | gbt7714-numeric.md |
| GB/T 7714 著者-出版年、author-date | gbt7714-author-date.md |
| APA | apa7.md |
| Chicago Notes、芝加哥脚注 | chicago-notes.md |
| IEEE | ieee.md |
| MLA | mla9.md |
| 中文社科 note、脚注样式 | chinese-note.md |
2a 预设路径： 读取 ${CLAUDE_SKILL_DIR}/presets/{preset}.md，获取全部参数。
2b 自定义路径： 按需读取 ${CLAUDE_SKILL_DIR}/components/ 下的组件模板：
| 组件 | 文件 | 职责 |
|---|---|---|
| 作者 | name.md | 姓名格式、et-al、排序 |
| 标题 | title.md | 斜体/引号/书名号 |
| 日期 | date.md | 年/月/日格式 |
| 期刊/书籍容器 | container.md | 期刊名、书名格式 |
| 卷期页 | locators.md | 卷/期/页码格式 |
| 出版信息 | publisher.md | 出版地、出版社 |
| DOI/URL | access.md | 电子资源访问信息 |
| 正文引用 | citation.md | citation 布局 |
| 参考文献列表 | bibliography.md | bibliography 布局 |
| 中文术语 | locale-zh.md | 中文本地化术语 |
| 英文术语 | locale-en.md | 英文本地化术语 |
根据用户需求选择性读取相关组件，无需全部加载。
按以下骨架组装完整 .csl 文件：
style (xmlns, class, version, default-locale)
├── info (title, id, category, updated)
├── locale × N (术语覆盖)
├── macro × N (按组件模板填充)
├── citation (正文引用 / 脚注)
└── bibliography (参考文献列表)
${CLAUDE_SKILL_DIR}/output/{style-name}.cslpython ${CLAUDE_SKILL_DIR}/scripts/validate_csl.py <file>
"status": "FAIL"，根据 errors 修复后重新校验，直到 PASS${CLAUDE_SKILL_DIR}/validate/rules.md 做补充审核（常见陷阱检查）python ${CLAUDE_SKILL_DIR}/scripts/preview_csl.py <file>
当用户提供现有 .csl 文件要求修改时：