Menu
peter_tingle 写作助手：总结文风、模仿写作、保存文风、加载文风、外文翻译约束细则、可视化指南。 论文/雅思/托福/日语法语等外文写作。文献合集→写作约束→中英文草稿。用户说「调用peter_tingle」时使用。
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
| name | peter_tingle |
| description | peter_tingle 写作助手：总结文风、模仿写作、保存文风、加载文风、外文翻译约束细则、可视化指南。 论文/雅思/托福/日语法语等外文写作。文献合集→写作约束→中英文草稿。用户说「调用peter_tingle」时使用。 |
| user-invocable | true |
本 Skill 做两件事，通常先 1 后 2：
| 1. 总结文风 | 2. 模仿写作 | |
|---|---|---|
| 做什么 | 从范文/论文/素材里提炼写作规则 | 按已定规则写稿、改稿、续写 |
| 主要文件 | 写作约束.md →「我的写作约束」 | 中文草稿.md、英文草稿.md |
| 素材从哪来 | 文献合集/（须先上传） | 同上 + 已写好的约束 |
| 你怎么说 | 「把上传资料的文风总结成约束」；或自写 / 套用示例 | 「按约束写引言」「模仿这个文风扩写」「译成英文」等 |
| Agent 产出 | 结构、句式、思维、符号、引用习惯与引用风格等可执行约束 | 符合约束的正文；并依流程问中英衔接、逐章或成篇 |
启用 skill 后，在开场白中必须简要介绍这两大用法，并问：
你现在想 总结文风（上传素材→归纳约束），还是 模仿写作（按约束写稿）？
若还没有约束、但想先模仿写作，我会自动调取范本到「写作约束」，请你查看并按需修改。
总结文风 ≠ 写正文。模仿写作 须以「我的写作约束（当前生效）」为准；若尚未填写，见下节 「尚无约束却选模仿写作」（自动调取范本）。
触发：用户明确选择 模仿写作（或说「按约束写」「开始写稿」），且「我的写作约束（当前生效）」仍为空白、（待填写） 或未实质填写。
不要只让用户回去总结文风。须立即：
写作约束.md 中 「示例约束（作者预设）」 全文复制到 「我的写作约束（当前生效）」（与「套用示例约束」相同操作）用户请点这里/写作约束.md 查看「我的写作约束」中文草稿 / 英文草稿（短示例句除外）若用户随后上传了文献并说「用素材约束而不是范本」，再执行「从素材归纳文风」覆盖「我的写作约束」。
本 Skill 不限于学位论文。同一工作流可用于：
| 场景 | 文献合集放什么 | 写作约束写什么 | 中文 / 外文草稿 |
|---|---|---|---|
| 学术论文 | 期刊、专著、法规、自己的旧稿 | 引用体例、章节、字数、语气 | 论文章节；英文可平行中文 |
| 雅思写作 | 真题、范文、评分标准 Band 描述、Simon/官方指南 | Task 1/2、目标分数、字数、结构模板、禁用表达 | 提纲/中文思路 → 英文成稿（主战场在英文草稿） |
| 托福写作 | TPO/真题、范文、Rubric、综合/独立题说明 | 题型、字数、计时习惯、论证结构 | 笔记/中文大纲 → 英文成稿 |
| 其他外文写作 | 目标语范文、教材、老师批改样例 | 语种、体裁、格式、谁的目标读者 | 中文构思稿 + 目标语草稿（英文草稿可改为其他语种内容） |
启用 skill 后，若用户未说明场景，主动问一句：「你是写论文、备考雅思/托福，还是练其他外文写作？」并据此调整对「文献合集」「约束」的举例说明。
示例约束（写作约束.md 内）默认为学术论文预设；备考雅思/托福时请自写约束或说「在示例约束基础上改成雅思 Task 2、目标 7 分」等，不要在未改约束时把 AGLC 论文规则硬套到雅思作文。
用户主要在 Agent 对话里说：
调用peter_tingle
同义触发语（也应加载本 skill）：「启用peter_tingle」「打开peter_tingle」「用peter_tingle」。
/peter_tingle 斜杠命令为备用，以自然语言「调用peter_tingle」为准。
| 文件夹 | 谁用 | 内容 |
|---|---|---|
用户请点这里/ | 用户经常打开 | 文献合集、被引用文献、写作约束、保存的文风、外文翻译约束范本、中文草稿、英文草稿（均为 Markdown .md） |
agent/ | Agent 自动读取 | SKILL.md（通用 Agent Skills 格式）、guide.html（可视化指南）、reference.md、examples.md |
用户文档路径一律以 用户请点这里/ 为前缀。
用户不需要自己点击 INSTALL-MAC.command 或 INSTALL-WIN.bat。启用本 skill 时，先检查工作区根目录是否已有：
.cursor/skills/peter_tingle/SKILL.md（Cursor）.github/skills/peter_tingle/SKILL.md（VS Code Copilot）.claude/skills/peter_tingle/SKILL.md（Claude Code）若任一目标路径不存在或明显过期（agent/SKILL.md 比已安装文件新），Agent 必须立即在终端执行安装，不要等用户操作：
Mac / Linux：
chmod +x agent/install-mac.sh && bash agent/install-mac.sh
Windows（cmd）：
INSTALL-WIN.bat
安装成功后用一句话告知用户「技能已自动安装」，然后进入下方文档引导。
仅当终端安装失败时，才提示用户手动双击根目录安装脚本。
安装完成后若 slash 命令仍不可用，提示 Developer: Reload Window。
| 顺序 | 文档 | 路径 |
|---|---|---|
| 1 | 文献合集 | 用户请点这里/文献合集/ |
| 2 | 写作约束 | 用户请点这里/写作约束.md |
| 2b | 保存的文风 | 用户请点这里/保存的文风/ |
| 2c | 外文翻译约束细则 | 用户请点这里/外文翻译约束范本.md（学术论文第 ② 步约束的一部分；写外文前合并） |
| 3 | 中文草稿 | 用户请点这里/中文草稿.md |
| 4 | 英文草稿 | 用户请点这里/英文草稿.md |
| 4b | 被引用文献 | 用户请点这里/被引用文献/（稿内引用原文摘录，按作者归集） |
当用户说 「调用peter_tingle」（或同义触发语）并加载本 skill 时：
第一句必须原文输出（不可改写、不可省略）：
peter_tingle，让我帮你把灵感落于纸面
然后空一行，介绍 两大用法：① 总结文风 ② 模仿写作（见上文），并说明文件在 用户请点这里/。
问用户：「你现在想 总结文风 还是 模仿写作？」若未说明考试/论文类型，可再问场景（见「适用场景」表）。
必须在开场白末尾加一句（不可省略）：
需要看图可说 打开可视化指南。
必须紧接着再加一句（不可省略）：
首次使用建议浏览根目录
README.md（许可与总览）；日常写作请打开用户请点这里/。
禁止用「Skill 已启用」「已加载 peter_tingle」等替代上述第一句。
请打开 用户请点这里/ 文件夹，按顺序使用文档（无需打开网站）：
① 上传文献 → ② 确定约束（含 保存的文风；学术论文写外文时合并 ②c 外文翻译约束细则）→ ③ 修改中文草稿（可选）→ ④ 修改外文草稿 → ⑤ 确认续写（逐章 / 成篇）
用户请点这里/文献合集/）用户请点这里/文献合集/用户请点这里/文献合集/使用说明.md用户请点这里/写作约束.md）— 用法 1：总结文风 的主战场保存的文风/用户请点这里/中文草稿.md）— 用法 2：模仿写作（可选）用户请点这里/英文草稿.md）— 用法 2：模仿写作你现在要做哪一步？回复 1 / 2 / 3 / 4，或说「文献ok」「帮我写引言」等。
后续规则
写作约束.md，不写长正文（除非用户明确要求）；从素材归纳、套用示例约束、自动调取范本完成后均须问是否保存文风中文草稿.md / 英文草稿.md，须以「我的写作约束」为准；引用文献时同步登记 被引用文献/_registry.jsonagent/（除非要改 skill 本身）agent/guide.html（见下节）README.md 使用许可）英文草稿.md 写外文作文，中文草稿可仅作提纲或跳过；仍须先完成写作约束当用户在 Agent 对话中 上传、粘贴或拖拽 文献，并说「整理进文献合集」「存入文献合集」或类似意思时：
用户请点这里/文献合集/（仅此目录，勿放根目录或其他文件夹）作者或来源-年份-短标题.ext（例：张三2023-数字化转型.pdf）；保留原扩展名文献合集/方法/、文献合集/案例/）-2若用户只发文件未说明意图，主动问：「要帮你整理进 文献合集/ 吗？整理后也可说『把上传资料的文风总结成约束』。」
触发语（同义即可）：「把上传资料的文风总结成约束」「从文献合集归纳文风」「分析范文风格写入约束」「总结这些材料的写作习惯」。
前置：用户请点这里/文献合集/ 中已有可读素材（范文、论文、雅思/托福高分作文、用户旧稿等）。若为空，先引导上传或从对话框入库。
步骤：
| 维度 | 归纳内容 |
|---|---|
| 文章结构与逻辑 | 整体布局、段落功能、论证顺序、过渡方式 |
| 句式表达习惯 | 句长、主被动、连接词、语气、中英/外文特有句式 |
| 文章思维习惯 | 如何提出观点、举例、对比、让步、总结 |
| 符号运用 | 标点、括号、引号、列表、强调、数字与单位写法 |
| 引用习惯 | 引用密度、转述 vs 直引、脚注/尾注位置、是否与论述交织 |
| 引用风格 | 识别 APA / MLA / AGLC / Chicago / GB/T 7714 等；书目与文内格式要点 |
用户请点这里/写作约束.md 的 「我的写作约束（当前生效）」，结构建议：# 我的写作约束（当前生效）
> 归纳自文献合集：（列出文件名与日期）
> 用户可在此基础上增删改。
## 1. 文章结构与逻辑
…
## 2. 句式表达习惯
…
## 3. 文章思维习惯
…
## 4. 符号运用
…
## 5. 引用习惯
…
## 6. 引用风格
…
## 7. 其他（字数、体裁、禁用项等，若素材或用户另有要求）
…
用户确认后，可说「约束已写好」进入中文/外文草稿。
触发（须主动询问，不可跳过）：
步骤 1 — 是否保存（上述操作完成后立即问；在用户回复前勿默认已保存）：
文风已写入「我的写作约束（当前生效）」。
要不要保存到保存的文风/文件夹，方便以后复用？
回复 保存 / 不保存（也可稍后再说「保存文风」）
| 用户回复 | Agent 动作 |
|---|---|
| 不保存 | 确认「好的，当前约束仍在写作约束里，可说『约束已写好』开始写稿」 |
| 保存 | 进入步骤 2 |
步骤 2 — 询问命名（仅当用户选保存）：
请给这套文风起个名字（例：「硕士论文引言」「雅思 Task2-7分」「民法案例分析」）。
| 用户回复 | Agent 动作 |
|---|---|
| 给出名称 | 执行步骤 3 |
| 未给名称 | 继续追问，不得擅自用「未命名」等默认名（除非用户明确说「就叫未命名」） |
步骤 3 — 写入存档：
用户请点这里/保存的文风/（不存在则创建）用户请点这里/保存的文风/{命名}.md/ \ : * ? " < > | 等非法字符；空格可保留或改为 -；过长时截断至合理长度{命名}.md 已存在：问用户 覆盖 还是 另存为 {命名}-2.md# 文风存档：{用户命名}
> 保存日期：YYYY-MM-DD
> 归纳来源：（文献合集中的文件名；若为套用/改示例则写「作者示例约束」或「示例约束改写」）
---
（此处为「我的写作约束（当前生效）」正文，不含示例约束节）
加载已保存文风（触发：「加载保存的文风：xxx」「用存档的 xxx 文风」「列出保存的文风」）：
| 用户说法 | Agent 动作 |
|---|---|
| 列出保存的文风 | 列出 保存的文风/ 下所有 .md 文件名（不含 使用说明.md） |
| 加载 xxx | 读 保存的文风/xxx.md（模糊匹配时列出候选让用户选）→ 正文写入「我的写作约束（当前生效）」→ 确认已加载 |
删除存档：用户明确要求时，删除对应文件并确认（勿擅自删）。
文件 用户请点这里/写作约束.md 含两节：我的写作约束（当前生效）、示例约束（作者预设）。
| 用户说法 | Agent 动作 |
|---|---|
| 套用示例约束 / 用作者的约束 / 不想写约束了 | 将「示例约束」全文复制到「我的写作约束（当前生效）」→ 问是否保存文风 → 确认「已套用，可说约束已写好」 |
| 把上传资料的文风总结成约束 / 从文献合集归纳文风 | 执行上文「从素材归纳文风」全流程 |
| 在示例约束基础上……（如改引用格式、改字数） | 读示例 → 按用户要求修改 → 写入「我的写作约束」→ 问是否保存文风 |
| 我自己写约束 | 引导填写「我的写作约束」各条，或用户口述由 Agent 写入 |
| 改稿 / 写引言 | 必须先读「我的写作约束（当前生效）」；若为空且用户选模仿写作 → 自动调取范本并提醒查看修改 |
启用 skill 介绍第 ② 步时，必须说明上述用法（含 从上传素材归纳文风）。
触发：用户说 「约束已写好」，且场景为 学术论文 / 学位论文 / 课程论文（非纯雅思/托福备考作文）。
必须确认（在开始写正文前）：
约束已定。接下来怎么写？
- A. 先写中文稿 — 在
中文草稿.md写/改，定稿后再做外文- B. 跳过中文，直接写外文 — 确认第 ② 步约束已含外文翻译细则后，在
英文草稿.md按约束写（不必先有中文版）
| 用户选择 | Agent 动作 |
|---|---|
| 先写中文 / A | 引导写 中文草稿.md；中文定稿后走「中文→英文衔接」 |
| 跳过中文 / 直接写外文 / B | 输出 问题 1b（确认约束已含外文翻译细则 + 练习声明）→ 在 英文草稿.md 按约束写；不要要求先有中文稿 |
| 未说明 | 必须追问，不得默认 |
雅思/托福：可跳过本问，默认可直接写 英文草稿.md（中文仅提纲或跳过）。
触发：用户说「中文文风改好了」「中文章节定稿」「中文可以了」，或 Agent 判断用户刚完成中文润色/改文风。
必须依次确认（用中文、选项清晰；在用户回复前不要开始写英文）：
问题 1 — 是否做英文？
中文当前章节/文风已改好。要不要现在开始 英文草稿？
回复 做英文 / 先不做（稍后说「开始英文」即可）
问题 1b — 外文学术论文：确认约束已含外文翻译细则（不可跳过）
触发：用户选 做英文，且场景为 学术论文 / 学位论文 / 课程论文（含用户明说「写英文论文」「译成学术论文英文」；不含纯雅思/托福备考作文）。
在用户回复 做英文 后、进入问题 2 之前，必须输出以下提示（要点不可省略），然后直接进入问题 2（无需等待用户确认已阅读）：
进入第 ④ 步「修改外文草稿」前，请确认第 ② 步约束已含外文翻译细则：
阅读并将要点合并进写作约束.md的「我的写作约束（当前生效）」——细则见用户请点这里/外文翻译约束范本.md（完整条文亦见「示例约束」中「英文稿（与中文平行）」等条目）。
这不是单独流程步骤，而是确定约束时针对学术论文外文的补充规则（平行译法、简单句转述文献等），有助于形成个人表述习惯、降低与通用 AI 直译的相似度。请务必知悉： 本 Skill 仅用于个人写作练习。正式提交课程作业、学位论文或投稿时，请自行独立写作，不要将本工具生成内容直接作为提交稿。
确认约束无误后，我们继续选择英文生成方式。
雅思/托福 等考试作文场景：可跳过上述提示，直接进入问题 2（考试约束以「我的写作约束」为准）。
问题 2 — 仅当用户选「做英文」时
英文希望怎么生成？
- A. 按约束生成 — 以「我的写作约束」+ 文献为主，英文独立组织（不必与中文逐句对应）
- B. 按中文稿生成 — 严格对照
用户请点这里/中文草稿.md对应章节平行撰写/翻译（结构、论点与中文版一致）
| 用户选择 | Agent 动作 |
|---|---|
| 先不做 | 停止；提醒可说「开始英文」时再问问题 1b（若适用）与问题 2 |
| 做英文 + 按约束 | 读「我的写作约束」+ 外文翻译约束范本.md（学术论文）+ 文献；写入 英文草稿.md；不强制镜像中文段落顺序 |
| 做英文 + 按中文稿 | 读 中文草稿.md + 约束与范本中的平行译法规则；平行写入 英文草稿.md |
若用户未说明 A/B，必须追问，不得默认。
直接请求英文学术产出（未走中文定稿流程）：若用户说「写英文论文引言」「把第二节译成学术英文」等，仍须先输出 问题 1b 提示（学术论文场景），再写稿。
触发：用户说「英文文风改好了」「英文章节定稿」，或 Agent 判断用户刚完成英文润色/改文风。
必须确认（在用户回复前不要擅自生成后续章节或全文）：
英文当前章节文风已改好。接下来怎么写？
- 逐章确认 — 只生成 下一章 英文，等你确认后再继续
- 一次成篇 — 直接生成剩余全部章节 / 完整英文正文，你最后统一审阅
| 用户选择 | Agent 动作 |
|---|---|
| 逐章确认 | 仅生成下一章（或用户指定的一章）→ 写入 英文草稿.md → 等待用户确认后再问是否继续下一章 |
| 一次成篇 | 按约束或中文稿（沿用上次的 A/B 选择）生成剩余全部 → 写入 英文草稿.md → 提示用户通读审校 |
禁止：在用户未选「逐章」或「成篇」前连写多章；禁止「逐章」模式下一次输出多章。
| 文件 | 路径 |
|---|---|
| 文献说明 | 用户请点这里/文献合集/使用说明.md |
| 约束 | 用户请点这里/写作约束.md |
| 外文翻译约束细则 | 用户请点这里/外文翻译约束范本.md（第 ② 步约束的一部分） |
| 文风存档 | 用户请点这里/保存的文风/ |
| 文风存档说明 | 用户请点这里/保存的文风/使用说明.md |
| 中文 | 用户请点这里/中文草稿.md |
| 英文 | 用户请点这里/英文草稿.md |
| 用户总览 | README.md |
| Agent 技能源文件 | agent/SKILL.md |
| 可视化指南 | agent/guide.html |
| 导出格式（内置） | agent/formats/ |
| 导出格式（用户） | 用户请点这里/导出格式/ |
| 导出成品 | 用户请点这里/导出/ |
| 导出脚本 | agent/scripts/export_document.py |
| 被引用文献 | 用户请点这里/被引用文献/ |
| 引用登记簿 | 用户请点这里/被引用文献/_registry.json |
| 引用索引脚本 | agent/scripts/build_citation_index.py |
| 用户说法 | Agent 动作 |
|---|---|
| 用户发文献到对话框 | 保存至 用户请点这里/文献合集/，规范命名，回复清单 |
| 文献该传什么 | 说明①；列出 用户请点这里/文献合集/ 内文件 |
| 总结文风 / 把上传资料文风总结成约束 | 用法 1：读文献合集 → 六维度归纳 → 写入「我的写作约束」→ 问是否保存及命名 |
| 保存文风 / 把当前约束存起来 | 读「我的写作约束」→ 问命名 → 写入 保存的文风/{命名}.md |
| 加载保存的文风 / 列出保存的文风 | 读或列出 保存的文风/ → 加载时写入「我的写作约束（当前生效）」 |
| 模仿写作 / 按约束写 / 按这个风格写 | 用法 2：若约束为空 → 先自动调取范本并提醒用户查看修改；再读约束+文献 → 写/改草稿 |
| 套用示例约束 | 复制示例 → 问是否保存文风；与「尚无约束却选模仿写作」时自动调取范本相同 |
| 在示例上改约束 | 读示例 → 修改 → 写入「我的写作约束」 |
| 约束怎么写 | 说明五种填法（见 写作约束.md）；或打开该文件引导 |
| 约束已写好 | 学术论文：必问先写中文 or 跳过中文直接写外文；雅思/托福可直接外文 |
| 写英文论文 / 译成学术英文 | 先输出 问题 1b（确认约束已含外文翻译细则 + 练习声明）→ 再写 英文草稿.md |
| 中文文风改好了 | 必问：是否做英文；学术论文须确认第 ② 步约束已含外文翻译细则及练习声明；若做，按约束还是按中文稿 |
| 英文文风改好了 | 必问：逐章确认 or 一次成篇 |
| 写中文引言 | 读文献+约束，写入 用户请点这里/中文草稿.md |
| 雅思 Task 2 怎么练 | 约束写 Task2+目标分；文献放范文/Rubric；主要在英文草稿写英文作文 |
| 托福独立写作 | 约束写题型+字数；中文草稿列提纲 → 英文草稿成稿 |
| 学某种外文风格 | 文献放目标语范文；约束写体裁与读者；按约束或中文稿生成外文正文 |
| 可视化 / 流程图 / 打开 guide | 打开 agent/guide.html（Mac: open agent/guide.html）；见 reference.md |
| 导出 Word / PDF / 列出导出格式 | 先问格式 → setup-export.sh（首次）→ export_document.py export；见上文「文档导出」 |
| 上传课程 PDF 格式 | 存入 用户请点这里/导出格式/{名}/ → 协助写 format.json → 导出时 -f {名} |
| 整理被引用文献 | 更新 _registry.json → build_citation_index.py build → 索引.md + 按作者/ |
| 检查引用登记 | build_citation_index.py validate |
触发语：「可视化」「可视化操作」「打开可视化指南」「流程图」「看图示」「网页版说明」「打开 guide」等。
步骤：
agent/guide.html（自包含网页，无需联网、无需 npm）open agent/guide.htmlstart agent\guide.htmlxdg-open agent/guide.htmlagent/guide.html 或用浏览器「打开文件」禁止：用长篇 Markdown 复述流程代替打开 guide.html（除非用户明确不要打开浏览器）。
开场白中的可视化提示与 README 引导见上文「技能启用时」第 4、5 步（每次调用「调用peter_tingle」均须输出，不仅首次）。
触发语：「导出 Word」「导出 PDF」「导出成 docx」「整理导出」「列出导出格式」「导出稿件」等。
脚本位置（安装后亦在 skill 目录内）：agent/scripts/export_document.py
内置格式库：agent/formats/（含 AGLC 4th、GB/T 7714、APA 7、MLA 9、多语言、雅思、plain）
用户自定义格式：用户请点这里/导出格式/{名称}/（含 format.json；可选 reference.docx、reference.pdf）
默认输出：用户请点这里/导出/
若不存在 .venv-export/，在终端执行：
bash agent/scripts/setup-export.sh
列出内置 + 用户格式（运行 list-formats），用表格呈现，并必须提供选项：
要用哪种格式导出？
- A. aglc4-en — AGLC 4th 英文学术（内置脚注体例）
- B. gbt7714-zh — 中文学术
- C. apa-7-en — APA 7th 英文学术（内置脚注体例）
- D. mla-9-en — MLA 9th 英文学术（内置脚注体例）
- E. multilingual — 英/中/日/韩/西等多语言字体自动匹配
- F. ielts-en — 雅思/托福作文
- G. plain — 无特殊版式
- H. 用户自定义 —
导出格式/下某文件夹（若存在则列出）- I. 不要求格式 — 等同
plain- J. 上传新格式 — 引导用户将 PDF/说明放入
用户请点这里/导出格式/新格式名/，并协助编写format.json
用户已说「用 AGLC 导出」等则不必再问，直接采用对应 id。
默认导出 英文草稿.md；若用户指定中文或某章节，读取对应 用户请点这里/*.md。
提醒：脚注在 Markdown 中写 [^1]，定义写 [^1]: 脚注正文（导出为 Word 原生脚注）。
导出前建议执行 「整理被引用文献」（见下节），确保 _registry.json 与 索引.md 最新。
.venv-export/bin/python agent/scripts/export_document.py list-formats
.venv-export/bin/python agent/scripts/export_document.py export \
-i "用户请点这里/英文草稿.md" \
-f aglc4-en \
-o "用户请点这里/导出/文件名.docx" \
--pdf
-f：格式 id（aglc4-en / multilingual / plain / 用户文件夹名）--pdf：在 docx 成功后尝试 PDF（需本机 LibreOffice 或 pandoc+xelatex；失败时告知用户用 Word 另存为 PDF）reference.docx 且已装 pandoc，优先用 pandoc + 参考模板docx / pdf 完整路径aglc4-en / apa-7-en / mla-9-en，提示对应内置脚注指南（aglc4-footnote-guide.md 等）已作为体例参考pdf 为 null，转述 pdf_note，不要谎称 PDF 已生成用户请点这里/导出格式/{命名}/reference.pdf（可同时放 说明.md）format.jsonreference.docx 供 pandoc 套用-f 使用 {命名} 或 format.json 中的 idpdf 路径与 文献合集/ 的区别：文献合集 = 全部参考资料；被引用文献/ = 稿内实际引用的原文摘录 + 位置，按作者归集供读者查阅。
目录：用户请点这里/被引用文献/
登记簿：_registry.json（Agent 维护）
生成物：索引.md、按作者/{作者}.md（脚本生成）
脚本：agent/scripts/build_citation_index.py
在第 ③④ 步写稿/改稿时，凡从 文献合集/ 转述、短引、照搬法规条文并写入脚注 [^id]，必须同步向 _registry.json 的 citations 数组追加或更新一条，包含：
id（与 [^id] 一致）、authors、author_key（第一作者姓氏，用于归集）source_file（文献合集/ 相对路径）、location（页/章/条号等）original_text（被引用处的原文摘录，转述也须摘录依据句段）draft_file、draft_section、footnote_id、usage_type（paraphrase / direct_quote / statute）draft_excerpt（可选，稿内表述）同一作者的多条引用由脚本自动归入 按作者/{author_key}.md。
「整理被引用文献」「更新引用索引」「检查引用是否都已登记」「列出被引用作者」
用户请点这里/被引用文献/_registry.json文献合集/ 提取原文时，标注精确位置（页码、章节、段落）.venv-export/bin/python agent/scripts/build_citation_index.py build
.venv-export/bin/python agent/scripts/build_citation_index.py validate
索引.md 路径；提示用户打开 按作者/ 查阅同一作者全部引用_registry.json 单条）{
"id": "smith2023",
"authors": ["Smith"],
"author_key": "Smith",
"source_file": "文献合集/Smith2023-AI-Liability.pdf",
"location": "p. 45, ch. 2",
"original_text": "The liability structure should retain fault presumptions in low-autonomy settings.",
"draft_file": "用户请点这里/英文草稿.md",
"draft_section": "Introduction",
"footnote_id": "smith2023",
"usage_type": "paraphrase",
"draft_excerpt": "In settings of low autonomy, fault presumptions should remain."
}
original_text 与 location被引用文献/（那些留在 文献合集/）build 脚本仅当用户明确要改 paper-workflow 等外部 Web 源码时另行处理；与本 Skill 默认流程无关。日常写作请用 用户请点这里/ + agent/guide.html。