FAQ zh

🌐 English · 中文 · 🏠 首页

常见问题与排障

关于人文学科写作伙伴（Humanities Writing Companion）——一个为史学、哲学、文学、文化研究、艺术学、宗教学、古典学等"文字即论证"的人文领域打造的 Claude skill——你在上手前后最常问的那些问题，都在这里。

第一次用？先看 快速开始 和 11 个工作模式。

---

第一部分 · 常见问题

这是一个润色工具吗？

不是——而且"不是润色工具"恰恰是这个项目的全部立场。

润色工具从最底层做起：语法、句式、所谓"清晰度"、统一的学术腔。这个 skill 故意把顺序倒过来，论证优先、格式最后：

论证 → 概念 → 结构 → 表达 → 格式

它写死了一条硬规则：上层问题没解决，绝不在下层使劲。 如果你的核心概念只是一个修辞标签、而不是真正的分析工具，它不会去"帮你改逗号"——它会把你打回到概念本身。所以它早期给你的反馈，常常不会让你的文字"看起来"更漂亮，反而让你看见你不太想面对的东西。这是设计，不是缺陷。

它会替我把论文写出来吗？

不会。它对自己的定位说得很直白：它的存在不是替你"写"，而是替你"读"。

它扮演的是思想伙伴，不是枪手。它在四个层次上诊断——地基层（论证站得住吗？）、结构层（论证展开得好吗？）、段落层（这一段在干什么？）、句子层（这句话说对了吗、像不像你？）——给的是一个真正的人文学者会给的那种批评。它可以帮你生成新内容（那是 Mode C），但即便如此，它也会主动标出"AI 痕迹较重"的段落，提醒你用自己的话重新说一遍。方向盘始终在作者手里；skill 只是那个比你先一步、读得很挑剔的读者。

它和"裸"ChatGPT / Claude（不装 skill）有什么不同？

一个普通的对话窗口，既不记得你的项目，也对人文写作没有任何"主张"。而这个 skill 会跨会话持续携带：

• 写作风格档案（从你真实的写作样本里学到的"你的声音"）；
• 目标读者档案（你到底在为谁写）；
• 修订日志（每一处改动都带 diff 和理由——像 git commit）；
• 四层批评和那条严格的自上而下规则；
• 学科路由（史学查时代错置；哲学查模态范围；等等）；
• AI 痕迹清单，用来抓那些"未经审视的表达惯性"；
• 以及一整套引用工具链。

通用 AI 的引力方向是润色与求均值。这个 skill 的引力方向正相反：保护你的声音、压力测试你的论证、预演那个不友好的审稿人。

它和 Paperpal / Grammarly / DeepL Write 有什么不同？

工具	它们做的事	这个 skill 不同在哪
Grammarly / DeepL Write	语法 / 翻译润色	它绝不会为了"清晰"而牺牲你的声音。"我手写我口"是核心原则，不是一个可关的开关。
Paperpal	学术语言润色（偏 STEM / 生物医学）	它是一套写作架构——11 个模式、四层批评、学科路由——不是单点润色工具。
Jenni AI	实时自动续写	它做的是"思想对话"，不是自动补全。实时预测会跳过人文论证最需要的那段认知劳动。
HyperWrite Devil's Advocate	一次性反方论点	它的 Mode D 是完整的"魔鬼代言人"模式：1–5 级强度可调、有方法论专攻子模式、还有一道"反谄媚"的让步门槛。
Thesify（Purpose-Check）	检查承诺是否兑现	Mode G 受 Purpose-Check 启发，但被放进了一个更大的四层工作流里。

一句话：大多数工具是用完就放下的工具；这个想成为基础设施——在长达数月的项目里，你在它之上工作的那个底座。

它支持哪些引用格式？

引用格式在 onboarding（初始化）时由你声明。内置认识的有：

• Chicago / Turabian（史学和人文最常用）
• MLA（文学与语言类）
• APA 7th（教育、心理、部分社科）
• GB/T 7714（中国国家标准）
• 期刊特定格式（把刊名或模板给它即可）

拿不准选哪个？它会根据你的学科和目标刊物给建议。除了选格式之外，scripts/ 工具链还做实活：一个一致性检查器（括号、逗号、连接符、中英文人名形式、页码），一个格式转换器（Chicago/MLA/APA/GB7714 互转），以及基于 Crossref 的文献核验。

它需要联网吗？运行时会调 API 吗？

skill 本体是纯文本、无运行时 LLM 依赖——这是刻意的设计承诺，正因如此它能在任何 Claude 入口跑起来（Claude Code、Claude Agent SDK、Claude.ai）。SKILL.md 可以直接塞进系统提示里用。

两点实际说明：

• 你当然还是需要 Claude 在跑——skill 是那层指令，不是模型本身。
• 唯一一个可选脚本 citation-verify.py 会拿你的文献去 Crossref 核对，这一步需要联网。其余的——一致性检查、套话扫描、待办标记聚合——全部零依赖，可离线运行。

用一段话说清它的设计哲学？

作者曾把一篇长文丢给 AI"润色"，拿回来一看：比原文更"匀"了——每句都四平八稳，每段开头都是"值得注意的是"，整篇冷静得像会议纪要——他这才意识到，AI 拿走的不是错别字，而是思考本身：那些不对称的判断、那些他有意收着的迟疑、那些硬把两个领域拽到一起的跳跃，全没了。于是这个 skill 押的是相反的注：在人文学科里，作者的声音承载着认识论分量（它标示你从哪个传统里写作、哪些动作是你自己的），论证与文字不可分（一个松垮的句子就是一次论证失败），而且审稿人是真实且对抗性的（所以论文该在投稿之前、在内部就先遭遇这个对手）。思想优先、格式其次；用工程的严谨服务人文的表达；"我手写我口"不可让渡。

它会削弱我自己的思考吗？

这恰恰是项目最当回事的那个担忧，整个设计都在使劲往反方向顶：

• 自上而下规则不断把你逼回你自己的论证，不让你躲进改句子里。
• **Mode F.coach（修订教练）**故意不给答案——先抛诊断性问题，让你长出"自己看出问题"的肌肉。（它明说的目标是："五年后，学者应该不再需要这个 skill。"）
• Mode D 的反谄媚门槛拒绝在你一推回去就软掉——一句敷衍的"你说得有道理"什么也训练不出来。
• 行为准则里写得很明确：任何会把作者变成 AI 输出"橡皮图章"的提议，都不会被接受。

它给的重新定位是：该怕的不是"AI 改变了我的声音"（任何工具都会改变写作者），而是"我未经审视就接受了 AI 的输出"。区别在于——它改的时候，你在不在场。

它真的适合所有人文学科吗？

它的目标是这样，靠的是一套三层学科架构，而不是一张扁平的"七选一"清单：

• L1 · 六大主学科： 文学、史学、哲学、语言学、艺术学、宗教学。每一个都带着自己的方法论关切（史学→时代错置、史料处理；哲学→概念推导、模态范围；文学→细读 vs. 阐释；等等）。
• L2 · 子领域： 继承母 L1 的全部关切，并可叠加自己的（例如古代文学会加上文献学/校勘的关切）。
• L3 · 跨学科领域： 显式多重继承——文化研究、古典学、思想史、科学史、媒介研究、数字人文、性别研究、后殖民研究、环境人文。

它也欢迎那些带有强人文传统的"人文相邻"学科——比如传播学里的媒介生态学谱系（伊尼斯/麦克卢汉/波兹曼/凯瑞）、教育学里的教育史与教育哲学——同时也老实承认：对这些学科里的实证/量化那一支，它服务得并不好。

设计文档里的一句实话：这个 skill 是从一个非常具体的项目里长出来的（一篇带哲学倾向、中文写作、艺术史血统的科学史硕论），所以它可能带着那条谱系的偏向，未必能完美移植到每个领域。跨学科测试是目前最被需要的贡献。 万一你的领域没列出来，还有兜底：把你的研究对象和主要方法告诉它，它会推断出你最接近的 L1 加上相关的叠加层。

它和 academic-research-skills（ARS）是什么关系？

两者互补，不是竞争——而且分工很干净。

• ARS 负责实证研究流水线：文献检索、数据收集、方法论合规（PRISMA、RAISE）、引用忠实度审计、流程编排。
• 这个 skill 负责写作本身：声音、论证肌理、文字的生长。

心智模型是：让 ARS 管"写之前"和"写之后"，让这个 skill 管中间的"写"。它明确不替你做文献检索（那条路通向引用幻觉，还会跳过"读"这件无可替代的学术劳动）。它也直接致谢 ARS——Mode D 的"让步门槛"反谄媚机制，灵感正来自 ARS 的审稿人模块。如果你在一个项目里两个都用了，请同时引用两者。

它免费吗？什么许可证？

它是免费、开源的公共物品——但要看清版本说明。

• 当前许可证是 CC BY-NC 4.0（知识共享 署名–非商业性使用 4.0）：可免费用于非商业目的、可修改、可分发，但须署名。"非商业"涵盖学术研究、教学、个人项目、开源衍生作品，以及机构内部的研究工作流。
• 许可证变更（v3.0.0，2026-05-19）： 项目从 MIT 改为 CC BY-NC 4.0。≤ v2.1.0 的版本仍属 MIT，那些特定版本保留其原有的商业使用权。从 v3.0.0 起，商业使用需另行获得授权。
• 商业使用（嵌入付费产品、用本 skill 提供付费编辑/咨询服务、商业 SaaS 集成、代付费客户使用等）需向作者获取授权：shencong916@gmail.com。

无论哪一档许可证，在学术出版中引用本 skill 永远是被允许的，而且受鼓励（项目有 DOI 和 CITATION.cff）。

---

第二部分 · 排障

skill 好像"没激活" / 进不去模式

Claude Code 在启动时会自动扫描 ~/.claude/skills/ 和 ./.claude/skills/，所以第一步先确认 skill 确实装在那里（如果是项目级安装，还要确认你是从那个项目目录里启动的 Claude）。确认之后——激活靠的是你说了什么，不是你敲了某条命令。

试着用一句朴素的触发词，而不是一个抽象的请求：

• 中文： 论文 · 写作 · 改论文 · 帮我看看这一章 · 我手写我口 · 这个论证有没有问题 · 我写不下去了 · 审稿人会怎么攻击 · 研究问题 · 文献综述 · AI 使用披露 · 帮我看看这段话。
• 英文： "paper"、"chapter"、"dissertation"、"revise"、"devil's advocate"、"review my section"、"research question"、"AI disclosure"……连一句 "take a look at this paragraph" 都能触发。

要是还是不动，就直说："用人文学科写作伙伴这个 skill 帮我审一下这一章。" 安装步骤见 快速开始。

某个模式的输出不是我预期的样子

通常有两种情况：要么是触发了另一个模式（不是你想要的那个），要么是这个模式恰恰在按设计行事、只是设计本身让你意外。几个常见场景：

• 你要的是审一章，结果收到的是高层、让你不太舒服的"地基批评"。 这是 Mode B 在自上而下地工作——论证还破着的时候，它不会去打磨句子。如果你确实只想要句子层的帮助，就说"我只要句子层 / Layer 4 的帮助"（Mode A）。
• 盲读（Mode G）感觉怪机械的，还不管质量好坏。 没错——Mode G 故意关掉了学术判断。它只检查"你兑现了你承诺的东西吗"。它不会告诉你这个承诺值不值得做（那是地基层 Layer 1），也不替你改任何东西。要谈质量，请用 Mode B。
• Mode J 拒绝帮你写一段。 也是设计——Mode J 是"只列提纲、不写"模式，它的价值正在于"克制不写"这份纪律。它会主动提议把你切到 Mode C（起草）。
• 你想让它起草，它却给你一串苏格拉底式提问。 Mode C 先听后做（"接生婆，不是建筑师"）。如果你想让它直接产出草稿，直说即可——但请预期它会把"AI 痕迹重"的部分标出来，让你用自己的声音重写。

点名你想要的模式和层次，是最快的解法。 完整地图（A–K）见 11 个工作模式。

它没用我的引用格式 / 我的读者档案

这些都存在 skill 开工时会读的配置文件里。如果它没在用：

• 引用格式： 它本该在 onboarding 时创建 _writing-config/citation-style.md（中文路径 引用格式速查.md）。如果你跳过了 onboarding、或这个文件不存在/为空，格式就不会生效。直接告诉它："我用 Chicago"（或 MLA / APA 7th / GB/T 7714 / 某刊模板），并让它写进配置。
• 读者档案： 魔鬼代言人（Mode D）会读 _writing-config/reader-profile.md（目标读者档案.md），好让它的三位审稿人具体起来（比如"审稿人 A 扮演技术中立论者"）。如果这个文件是空的，Mode D 会退回到一个"学科通用"人设，并提醒你去填。先填"主要读者"那一节，其余可以增量补全。
• 学科路由感觉很泛： 检查 _writing-config/discipline.md（学科档案.md）。如果它不存在，skill 本该在给批评前先问你——但万一漏过去了，史学/哲学等等的专属检查就不会加载。重新声明你的 L1（外加任何 L2 子领域和 L3 跨学科领域）。

_writing-config/ 这些文件到底是什么？

它们是 skill 对你这个项目的持久记忆——一组小小的 Markdown 文件，每次开新会话时它都会读，这样你就不必反复交代背景。关键的几个：

文件	装什么	谁会读
style-profile.md	你的声音，从真实样本里学到	所有产出文字的环节
reader-profile.md	你在为谁写	Mode D（让审稿人具体化）、起草
citation-style.md	你选定的引用格式 + 本文特定约定	引用处理、Mode F
discipline.md	你的 L1 / L2 / L3 学科声明	每一次批评（路由）
research-question.md / literature-map.md / outline.md	Mode H / I / J 的产物	下游的规划与起草

另外，_meta/ 里放着修订日志、写作进度、互动日志（用于跨会话续写，以及 Mode K 的 AI 使用披露）。

两个有用的事实：（1）文件名可中可英——跟着你的写作语言走（比如 style-profile.md 或 写作风格档案.md）。（2）Mode G 故意不读 _writing-config/——这不是 bug，正是"盲读"得以站在"你的内部视角之外"的方式。

怎么在对话中途切换模式？

直说就行——这个 skill 天生就会升档和降档，而且它应当主动告诉你此刻在哪个层次工作、不会闷声切换。它能听懂的自然切换：

• 段落问题原来是结构问题 →"我们退一步看整章吧"（Mode A → Mode B）。
• 某章需要重写而不是修订 → 切到构思（Mode F → Mode C）。
• 审完了，现在做行文细改 →（Mode B → Mode A）。
• 教练教到一半，你只想要答案 →"别教练了，直接给我改法"（它会立刻照办）。

万一它没打招呼就换了层次，问一句"我们现在在哪个层次工作？"——这本就是它该有的行为。

某个模式感觉太凶了（比如魔鬼代言人太狠）

魔鬼代言人（Mode D）是 1–5 级可调的，挡位由你定：

级别	姿态
1 · 温和读者	鼓励为主，提一两个柔和的关切。适合脆弱期 / 早期草稿。
2 · 友善批评者	会追问，但仍是支持性的。
3 · 同行审稿人	默认。 标准强度，四位审稿人全开，反谄媚已启用。
4 · 敌意审稿人	对抗性，逐个弱点攻击。适合高风险投稿。
5 · 答辩刁难委员	往"挂掉你"的方向逼；让步门槛收紧到 5 选 3。仅用于答辩预演。

如果你没选级别，它默认跑 第 3 级。要调低，直接说*"降到第 2 级——我有点扛不住了"*，它会立刻照办、不跟你讨价还价。在 4–5 级，它还应当每 3–4 个质疑就来确认一次（"继续、降级，还是先休息？"）。

但有一件事它不会做：因为你烦了就软下来。反谄媚规则意味着——只有当你的反驳达到一个真实标准（引出具体文献、重新界定概念范围、给出反例、表明你已经处理过等等），它才会撤回一个质疑；因为一个一遇情绪压力就垮掉的批评，根本预演不了真实的审稿人。想让它真的收手，要么拿出实质，要么明确把级别调低。 还有别忘了：当你打开 Mode D，你要的就是一个不友好的对话者。

---

还是卡住了？

• 跟着 快速开始 走一遍初始化。
• 在 11 个工作模式 里看清每个模式具体做什么。
• 发现 bug，或你的学科套不进来？欢迎提 issue 和参与讨论——见仓库的 CONTRIBUTING.md。学科测试是单项价值最高的贡献。