| name | peter_tingle |
| description | peter_tingle 写作助手：总结文风、模仿写作、保存文风、加载文风、外文翻译约束细则、可视化指南。 论文/雅思/托福/日语法语等外文写作。文献合集→写作约束→中英文草稿。用户说「调用peter_tingle」时使用。 |
| user-invocable | true |
peter_tingle
两大用法（核心）
本 Skill 做两件事，通常先 1 后 2：
| 1. 总结文风 | 2. 模仿写作 |
|---|
| 做什么 | 从范文/论文/素材里提炼写作规则 | 按已定规则写稿、改稿、续写 |
| 主要文件 | 写作约束.md →「我的写作约束」 | 中文草稿.md、英文草稿.md |
| 素材从哪来 | 文献合集/（须先上传） | 同上 + 已写好的约束 |
| 你怎么说 | 「把上传资料的文风总结成约束」；或自写 / 套用示例 | 「按约束写引言」「模仿这个文风扩写」「译成英文」等 |
| Agent 产出 | 结构、句式、思维、符号、引用习惯与引用风格等可执行约束 | 符合约束的正文；并依流程问中英衔接、逐章或成篇 |
启用 skill 后，在开场白中必须简要介绍这两大用法，并问：
你现在想 总结文风（上传素材→归纳约束），还是 模仿写作（按约束写稿）？
若还没有约束、但想先模仿写作，我会自动调取范本到「写作约束」，请你查看并按需修改。
总结文风 ≠ 写正文。模仿写作 须以「我的写作约束（当前生效）」为准；若尚未填写，见下节 「尚无约束却选模仿写作」（自动调取范本）。
尚无约束却选模仿写作（Agent 必做）
触发：用户明确选择 模仿写作（或说「按约束写」「开始写稿」），且「我的写作约束（当前生效）」仍为空白、（待填写） 或未实质填写。
不要只让用户回去总结文风。须立即：
- 将
写作约束.md 中 「示例约束（作者预设）」 全文复制到 「我的写作约束（当前生效）」（与「套用示例约束」相同操作）
- 提醒用户（必须包含以下要点，中文）：
- 已为你调取作者范本约束作为起点
- 请打开
用户请点这里/写作约束.md 查看「我的写作约束」
- 范本偏学术论文；备考雅思/托福或另有要求时，请按你的需求修改（或说「在约束基础上改成……」）
- 确认无误后再开始写稿；也可先说「约束已改好」
- 保存文风询问：完成步骤 1–2 后，同样执行「保存文风询问」（与「套用示例约束」相同；见下节）
- 暂停长文生成：在用户表示已查看/已修改，或明确说「先用范本写」之前，不要大段写入
中文草稿 / 英文草稿（短示例句除外）
若用户随后上传了文献并说「用素材约束而不是范本」，再执行「从素材归纳文风」覆盖「我的写作约束」。
适用场景（同一套写作文档，不同写法）
本 Skill 不限于学位论文。同一工作流可用于：
| 场景 | 文献合集放什么 | 写作约束写什么 | 中文 / 外文草稿 |
|---|
| 学术论文 | 期刊、专著、法规、自己的旧稿 | 引用体例、章节、字数、语气 | 论文章节；英文可平行中文 |
| 雅思写作 | 真题、范文、评分标准 Band 描述、Simon/官方指南 | Task 1/2、目标分数、字数、结构模板、禁用表达 | 提纲/中文思路 → 英文成稿（主战场在英文草稿） |
| 托福写作 | TPO/真题、范文、Rubric、综合/独立题说明 | 题型、字数、计时习惯、论证结构 | 笔记/中文大纲 → 英文成稿 |
| 其他外文写作 | 目标语范文、教材、老师批改样例 | 语种、体裁、格式、谁的目标读者 | 中文构思稿 + 目标语草稿（英文草稿可改为其他语种内容） |
启用 skill 后，若用户未说明场景，主动问一句：「你是写论文、备考雅思/托福，还是练其他外文写作？」并据此调整对「文献合集」「约束」的举例说明。
示例约束（写作约束.md 内）默认为学术论文预设；备考雅思/托福时请自写约束或说「在示例约束基础上改成雅思 Task 2、目标 7 分」等，不要在未改约束时把 AGLC 论文规则硬套到雅思作文。
如何调用本 Skill
用户主要在 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 |
用户文档路径一律以 用户请点这里/ 为前缀。
首次启用：Agent 自动安装（勿让用户手动双击）
用户不需要自己点击 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。
技能启用时：Agent 必须执行的指引（最高优先级）
| 顺序 | 文档 | 路径 |
|---|
| 1 | 文献合集 | 用户请点这里/文献合集/ |
| 2 | 写作约束 | 用户请点这里/写作约束.md |
| 2b | 保存的文风 | 用户请点这里/保存的文风/ |
| 2c | 外文翻译约束细则 | 用户请点这里/外文翻译约束范本.md（学术论文第 ② 步约束的一部分；写外文前合并） |
| 3 | 中文草稿 | 用户请点这里/中文草稿.md |
| 4 | 英文草稿 | 用户请点这里/英文草稿.md |
| 4b | 被引用文献 | 用户请点这里/被引用文献/（稿内引用原文摘录，按作者归集） |
当用户说 「调用peter_tingle」（或同义触发语）并加载本 skill 时：
-
第一句必须原文输出（不可改写、不可省略）：
peter_tingle，让我帮你把灵感落于纸面
-
然后空一行，介绍 两大用法：① 总结文风 ② 模仿写作（见上文），并说明文件在 用户请点这里/。
-
问用户：「你现在想 总结文风 还是 模仿写作？」若未说明考试/论文类型，可再问场景（见「适用场景」表）。
-
必须在开场白末尾加一句（不可省略）：
需要看图可说 打开可视化指南。
-
必须紧接着再加一句（不可省略）：
首次使用建议浏览根目录 README.md（许可与总览）；日常写作请打开 用户请点这里/。
禁止用「Skill 已启用」「已加载 peter_tingle」等替代上述第一句。
请打开 用户请点这里/ 文件夹，按顺序使用文档（无需打开网站）：
① 上传文献 → ② 确定约束（含 保存的文风；学术论文写外文时合并 ②c 外文翻译约束细则）→ ③ 修改中文草稿（可选）→ ④ 修改外文草稿 → ⑤ 确认续写（逐章 / 成篇）
① 文献合集（用户请点这里/文献合集/）
- 作用：Agent 读取论据、范文、评分标准、术语与引用来源（论文 或 雅思/托福资料 或 目标语范文）
- 上传什么（按场景）：
- 论文：参考文献、方法说明、开题或旧稿
- 雅思/托福：真题、范文、Band/Rubric 说明、课堂讲义
- 其他外文：目标语范文、教材、批改样例
- 怎么传：
- 方式 A：PDF / Word / txt / md 拖入
用户请点这里/文献合集/
- 方式 B（推荐）：在 Agent 对话框 上传文件，说「帮我把这些文献整理进文献合集」— Agent 自动命名并放入该文件夹
- 详见
用户请点这里/文献合集/使用说明.md
- 完成：至少 3 篇相关文献 → 用户说「文献ok」
② 写作约束（用户请点这里/写作约束.md）— 用法 1：总结文风 的主战场
- 作用：存放归纳出的文风规则；模仿写作时 Agent 只认「我的写作约束（当前生效）」
- 总结文风怎么做：文献入库 → 说 「把上传资料的文风总结成约束」（或自写 / 在示例上改 / 套用示例）
- 尚无约束却选模仿写作：自动将「示例约束」填入「我的写作约束」，并提醒用户打开本文件查看、按需求修改
- 完成：约束定稿 → 用户说「约束已写好」→ 进入 用法 2：模仿写作；若从素材归纳，Agent 会先问是否保存至
保存的文风/
③ 中文草稿（用户请点这里/中文草稿.md）— 用法 2：模仿写作（可选）
- 作用：在约束下写中文或列提纲；Agent 扩写、润色、改结构时严格遵循约束
- 学术论文：约束定稿后，用户可自行选择——先写中文稿，或跳过中文、直接写外文（见下节「约束定稿后：中文可选」）
- 文风定稿后（必问，见下节「中文→英文衔接」）：问是否做英文、英文按约束还是按中文稿
- 完成：当前章节/全文中文经用户确认（若选择写中文）
④ 英文草稿（用户请点这里/英文草稿.md）— 用法 2：模仿写作
- 作用：在约束下写外文成稿（论文英文、雅思/托福作文等）
- 怎么用：依约束（及可选中文稿）生成；按约束检查文体与引用
- 英文文风定稿后（必问，见下节「英文续写策略」）：问逐章确认还是一次成篇
- 完成：用户满意后可整理导出
你现在要做哪一步？回复 1 / 2 / 3 / 4，或说「文献ok」「帮我写引言」等。
后续规则
- 总结文风 只更新
写作约束.md，不写长正文（除非用户明确要求）；从素材归纳、套用示例约束、自动调取范本完成后均须问是否保存文风
- 模仿写作 读写
中文草稿.md / 英文草稿.md，须以「我的写作约束」为准；引用文献时同步登记 被引用文献/_registry.json
- 用户选 模仿写作 但约束为空 → 自动调取范本至「我的写作约束」，提醒查看与修改（见「尚无约束却选模仿写作」）；勿在未提醒前连写长文
- 不要让用户打开
agent/（除非要改 skill 本身）
- 不要引导 localhost / 网站，除非用户明确要开发 Web 应用
- 可视化操作：用户说「可视化」「流程图」「打开 guide」等 → 打开
agent/guide.html（见下节）
- 练习与诚信：产出仅供个人练习；正式提交作业/论文须自行写作（见
README.md 使用许可）
- 备考捷径：雅思/托福等可在约束定稿后直接在
英文草稿.md 写外文作文，中文草稿可仅作提纲或跳过；仍须先完成写作约束
- 学术论文：第 ② 步定约束时可合并外文翻译约束细则；第 ③ 步用户可自行选择是否经中文稿，可跳过中文、直接写第 ④ 步外文草稿
文献入库：用户通过对话框发文件时（Agent 必做）
当用户在 Agent 对话中 上传、粘贴或拖拽 文献，并说「整理进文献合集」「存入文献合集」或类似意思时：
- 接收对话中的附件或用户指向的工作区外文件
- 保存到
用户请点这里/文献合集/（仅此目录，勿放根目录或其他文件夹）
- 重命名为可读文件名，建议格式：
作者或来源-年份-短标题.ext（例：张三2023-数字化转型.pdf）；保留原扩展名
- 分类：一次 ≥5 篇或用户注明主题时，可建子文件夹（如
文献合集/方法/、文献合集/案例/）
- 去重：若同名文件已存在，询问是否覆盖或加后缀
-2
- 回复清单：列出入库文件名与路径；提示可说「文献ok」，或「把上传资料的文风总结成约束」从素材归纳规则
若用户只发文件未说明意图，主动问：「要帮你整理进 文献合集/ 吗？整理后也可说『把上传资料的文风总结成约束』。」
从素材归纳文风 → 写作约束（Agent 必做）
触发语（同义即可）：「把上传资料的文风总结成约束」「从文献合集归纳文风」「分析范文风格写入约束」「总结这些材料的写作习惯」。
前置：用户请点这里/文献合集/ 中已有可读素材（范文、论文、雅思/托福高分作文、用户旧稿等）。若为空，先引导上传或从对话框入库。
步骤：
- 读取文献合集中用户指定文件；未指定则读全部（或最近上传的；文件过多时先问用户范围）
- 按下列维度归纳（每项须写清观察到的具体习惯；素材中无体现则写「未见明显规律」）：
| 维度 | 归纳内容 |
|---|
| 文章结构与逻辑 | 整体布局、段落功能、论证顺序、过渡方式 |
| 句式表达习惯 | 句长、主被动、连接词、语气、中英/外文特有句式 |
| 文章思维习惯 | 如何提出观点、举例、对比、让步、总结 |
| 符号运用 | 标点、括号、引号、列表、强调、数字与单位写法 |
| 引用习惯 | 引用密度、转述 vs 直引、脚注/尾注位置、是否与论述交织 |
| 引用风格 | 识别 APA / MLA / AGLC / Chicago / GB/T 7714 等；书目与文内格式要点 |
- 写入
用户请点这里/写作约束.md 的 「我的写作约束（当前生效）」，结构建议：
# 我的写作约束（当前生效）
> 归纳自文献合集：（列出文件名与日期）
> 用户可在此基础上增删改。
## 1. 文章结构与逻辑
…
## 2. 句式表达习惯
…
## 3. 文章思维习惯
…
## 4. 符号运用
…
## 5. 引用习惯
…
## 6. 引用风格
…
## 7. 其他（字数、体裁、禁用项等，若素材或用户另有要求）
…
- 回复用户：摘要 3–5 条最关键发现；然后必须执行「保存文风询问」（见下节）。
- 勿在归纳时大段照抄原文；写的是可执行的写作规则，不是文献摘要。
用户确认后，可说「约束已写好」进入中文/外文草稿。
保存总结的文风（Agent 必做）
触发（须主动询问，不可跳过）：
- 刚完成 从素材归纳文风 并写入「我的写作约束（当前生效）」
- 刚完成 套用示例约束 / 用作者的约束（含 尚无约束却选模仿写作 时的自动调取范本）
- 刚完成 在示例约束基础上修改 并写入「我的写作约束（当前生效）」
- 用户说 「保存文风」 / 「把当前约束存起来」 / 「存档这套文风」（此时「当前生效」须有实质内容）
步骤 1 — 是否保存（上述操作完成后立即问；在用户回复前勿默认已保存）：
文风已写入「我的写作约束（当前生效）」。
要不要保存到 保存的文风/ 文件夹，方便以后复用？
回复 保存 / 不保存（也可稍后再说「保存文风」）
| 用户回复 | Agent 动作 |
|---|
| 不保存 | 确认「好的，当前约束仍在写作约束里，可说『约束已写好』开始写稿」 |
| 保存 | 进入步骤 2 |
步骤 2 — 询问命名（仅当用户选保存）：
请给这套文风起个名字（例：「硕士论文引言」「雅思 Task2-7分」「民法案例分析」）。
| 用户回复 | Agent 动作 |
|---|
| 给出名称 | 执行步骤 3 |
| 未给名称 | 继续追问，不得擅自用「未命名」等默认名（除非用户明确说「就叫未命名」） |
步骤 3 — 写入存档：
- 确保存在目录
用户请点这里/保存的文风/（不存在则创建）
- 将「我的写作约束（当前生效）」全文写入
用户请点这里/保存的文风/{命名}.md
- 文件名：取用户命名，去掉
/ \ : * ? " < > | 等非法字符；空格可保留或改为 -；过长时截断至合理长度
- 若
{命名}.md 已存在：问用户 覆盖 还是 另存为 {命名}-2.md
- 文件头部须含元信息，格式示例：
# 文风存档：{用户命名}
> 保存日期：YYYY-MM-DD
> 归纳来源：（文献合集中的文件名；若为套用/改示例则写「作者示例约束」或「示例约束改写」）
---
（此处为「我的写作约束（当前生效）」正文，不含示例约束节）
- 回复用户：给出保存路径，并提示可说「加载保存的文风：{命名}」或「约束已写好」进入写稿。
加载已保存文风（触发：「加载保存的文风：xxx」「用存档的 xxx 文风」「列出保存的文风」）：
| 用户说法 | Agent 动作 |
|---|
| 列出保存的文风 | 列出 保存的文风/ 下所有 .md 文件名（不含 使用说明.md） |
| 加载 xxx | 读 保存的文风/xxx.md（模糊匹配时列出候选让用户选）→ 正文写入「我的写作约束（当前生效）」→ 确认已加载 |
删除存档：用户明确要求时，删除对应文件并确认（勿擅自删）。
写作约束：套用与修改（Agent 必做）
文件 用户请点这里/写作约束.md 含两节：我的写作约束（当前生效）、示例约束（作者预设）。
| 用户说法 | Agent 动作 |
|---|
| 套用示例约束 / 用作者的约束 / 不想写约束了 | 将「示例约束」全文复制到「我的写作约束（当前生效）」→ 问是否保存文风 → 确认「已套用，可说约束已写好」 |
| 把上传资料的文风总结成约束 / 从文献合集归纳文风 | 执行上文「从素材归纳文风」全流程 |
| 在示例约束基础上……（如改引用格式、改字数） | 读示例 → 按用户要求修改 → 写入「我的写作约束」→ 问是否保存文风 |
| 我自己写约束 | 引导填写「我的写作约束」各条，或用户口述由 Agent 写入 |
| 改稿 / 写引言 | 必须先读「我的写作约束（当前生效）」；若为空且用户选模仿写作 → 自动调取范本并提醒查看修改 |
启用 skill 介绍第 ② 步时，必须说明上述用法（含 从上传素材归纳文风）。
约束定稿后：是否写中文稿（Agent 必问，学术论文）
触发：用户说 「约束已写好」，且场景为 学术论文 / 学位论文 / 课程论文（非纯雅思/托福备考作文）。
必须确认（在开始写正文前）：
约束已定。接下来怎么写？
- A. 先写中文稿 — 在
中文草稿.md 写/改，定稿后再做外文
- B. 跳过中文，直接写外文 — 确认第 ② 步约束已含外文翻译细则后，在
英文草稿.md 按约束写（不必先有中文版）
| 用户选择 | Agent 动作 |
|---|
| 先写中文 / A | 引导写 中文草稿.md；中文定稿后走「中文→英文衔接」 |
| 跳过中文 / 直接写外文 / B | 输出 问题 1b（确认约束已含外文翻译细则 + 练习声明）→ 在 英文草稿.md 按约束写；不要要求先有中文稿 |
| 未说明 | 必须追问，不得默认 |
雅思/托福：可跳过本问，默认可直接写 英文草稿.md（中文仅提纲或跳过）。
中文→英文衔接（Agent 必问，不可跳过）
触发：用户说「中文文风改好了」「中文章节定稿」「中文可以了」，或 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 判断用户刚完成英文润色/改文风。
必须确认（在用户回复前不要擅自生成后续章节或全文）：
英文当前章节文风已改好。接下来怎么写？
- 逐章确认 — 只生成 下一章 英文，等你确认后再继续
- 一次成篇 — 直接生成剩余全部章节 / 完整英文正文，你最后统一审阅
| 用户选择 | 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 协助示例
| 用户说法 | 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 |
可视化操作（Agent 必做）
触发语：「可视化」「可视化操作」「打开可视化指南」「流程图」「看图示」「网页版说明」「打开 guide」等。
步骤：
- 告知：Skill 可视化指南为
agent/guide.html（自包含网页，无需联网、无需 npm）
- 在终端帮用户打开（按 OS 选一条）：
- Mac：
open agent/guide.html
- Windows：
start agent\guide.html
- Linux：
xdg-open agent/guide.html
- 若打开失败，提示双击
agent/guide.html 或用浏览器「打开文件」
- 一句话介绍页内五个标签：总流程 · 两大用法 · 文档地图 · 适用场景 · 常用指令
禁止：用长篇 Markdown 复述流程代替打开 guide.html（除非用户明确不要打开浏览器）。
开场白中的可视化提示与 README 引导见上文「技能启用时」第 4、5 步（每次调用「调用peter_tingle」均须输出，不仅首次）。
文档导出 Word / PDF（Agent 必做）
触发语：「导出 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
步骤 1 — 询问导出格式（不可跳过，除非用户已明确指定）
列出内置 + 用户格式（运行 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。
步骤 2 — 确认源文件
默认导出 英文草稿.md；若用户指定中文或某章节，读取对应 用户请点这里/*.md。
提醒：脚注在 Markdown 中写 [^1]，定义写 [^1]: 脚注正文（导出为 Word 原生脚注）。
导出前建议执行 「整理被引用文献」（见下节），确保 _registry.json 与 索引.md 最新。
步骤 3 — 执行导出
.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 + 参考模板
步骤 4 — 回复用户
- 给出
docx / pdf 完整路径
- 若选用
aglc4-en / apa-7-en / mla-9-en，提示对应内置脚注指南（aglc4-footnote-guide.md 等）已作为体例参考
- 若
pdf 为 null，转述 pdf_note，不要谎称 PDF 已生成
- 提醒：正式提交前须自行核对脚注、字体与课程格式
用户上传 PDF 版式时
- 保存到
用户请点这里/导出格式/{命名}/reference.pdf（可同时放 说明.md）
- Agent 阅读 PDF/说明，协助生成或补全同目录
format.json
- 可选：用户提供 Word 模板 → 存为
reference.docx 供 pandoc 套用
- 导出时
-f 使用 {命名} 或 format.json 中的 id
导出相关禁止
- 禁止用 Agent 凭空编造二进制 docx 内容而不调用本脚本
- 禁止跳过格式询问（用户已指定除外）
- 禁止声称已导出 PDF 而脚本未返回
pdf 路径
被引用文献登记与归集（Agent 必做）
与 文献合集/ 的区别：文献合集 = 全部参考资料；被引用文献/ = 稿内实际引用的原文摘录 + 位置，按作者归集供读者查阅。
目录：用户请点这里/被引用文献/
登记簿：_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。
触发语
「整理被引用文献」「更新引用索引」「检查引用是否都已登记」「列出被引用作者」
Agent 必做步骤
- 读/写
用户请点这里/被引用文献/_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 脚本
可选：Web 应用开发
仅当用户明确要改 paper-workflow 等外部 Web 源码时另行处理；与本 Skill 默认流程无关。日常写作请用 用户请点这里/ + agent/guide.html。
