1. 基本信息
| 项目 | 内容 | 数据来源 |
|---|---|---|
| 正式名称 | humanities-writing-companion | GitHub 仓库名 |
| 项目自述名称 | Humanities Writing Companion · 人文学科写作伙伴 | README 标题(与正式名称一致,仅记录) |
| 作者/维护者 | Shen Cong（中央美术学院实验艺术学士、清华大学科学史硕士，GitHub: tizzy916） | GitHub API + README |
| 来源链接 | https://github.com/tizzy916/humanities-writing-companion | — |
| 许可证 | CC BY-NC 4.0（署名-非商业性使用） | GitHub API + LICENSE 原文 |
| GitHub Stars | 158 | GitHub API |
| Forks | 18 | GitHub API |
| 最新版本 | v5.0.2（2026-07-13 发布） | GitHub Releases API |
| 安装方式 | git clone 到 ~/.claude/skills/，或下载 ZIP 手动放入 |
官方 README |
2. 功能介绍与亮点
这是一款专为人文学科学者设计的论文写作思考伙伴，覆盖从选题到投稿的完整生命周期：研究问题打磨（苏格拉底式追问）、文献地图梳理、纯计划式大纲、正文构思与对话式起草、四层级章节评审（基础严谨性→论证展开→段落功能→句子表达）、可校准强度的“魔鬼代言人”对抗性评审、写作瓶颈疏通、保留作者嗓音的修订、盲读式“承诺兑现”检查、期刊投稿所需的 AI 使用披露，以及答辩/外审意见整合。
亮点：① 定位是“思考伙伴”而非润色或代笔工具，核心是保护学者本人的论证嗓音，不把文字磨平成“标准学术腔”；② 附带引用工具链，可对照 Crossref、OpenAlex 核验论文引用的真实性，捕捉 AI 编造引用的幻觉问题；③ 拥有 Zenodo DOI 归档、CI、贡献指南等工程规范，版本历史（v4.1.0 → v5.0.2）持续细致迭代；④ 中英双语，并声明“不是文献检索工具、不是格式打磨工具、不是引用管理器”，划清能力边界。
3. 适用场景
固定分类：内容创作与知识管理
适用于历史学、哲学、文学、文化研究、艺术史、宗教学、古典学等人文学科的研究生、青年学者与独立研究者，在撰写期刊论文、学位论文章节或专著段落时使用；尤其适合“文字即论证本身”、需要在提交前自我模拟一次严苛同行评审的写作场景。
4. 跨 Agent 兼容性
| Agent | 结论 | 依据 |
|---|---|---|
| Claude Code | 原生支持 | 官方安装方式即 git clone 到 ~/.claude/skills/，README 明确说明 Claude Code 自动扫描该目录并可加载生效 |
| Codex | 未验证 | README 声明技能采用开放 SKILL.md 格式，脚本仅依赖 POSIX shell 与 Python 3、“无 Claude 专属依赖”，但未见作者对 Codex 的官方测试确认 |
| OpenClaw | 未验证 | 已抓取材料未提及 OpenClaw 支持 |
| Hermes Agent | 未验证 | 已抓取材料未提及 Hermes 支持 |
5. 推荐理由
对于把 AI 当作论文写作“陪练”而非“代笔”的人文学者，这个技能提供了少见的专项价值：多数 AI 写作工具会把文字磨成千篇一律的“标准学术腔”，而人文学科恰恰依赖作者独特的论证嗓音。它用四层级评审与可调强度的对抗性质询，模拟真实、不留情面的审稿人，帮助作者投稿前先经历一次“实战演练”；引用真实性核验脚本则直接对症 AI 编造文献这一痛点。整体设计克制、边界清晰，不试图替作者思考。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 4 | GitHub 158 Stars，星标数处于中低区间；GitHub 上仅有 1 条真实用户 Issue（功能建议，已解决），另有 1 条来自第三方群发账号（该账号在 GitHub 上对上千个仓库发过同类“已收录”通知，经核实不计入讨论证据），未见独立平台的具名评价 |
| 可用性 | 9 | git clone 一条命令即可安装，亦支持 ZIP 免 git 下载；SKILL.md 与配套文档（README、docs/、references/、Wiki）极为完整；最近一次发布为 2026-07-13，维护活跃；核心功能无需任何付费依赖或 API Key |
| 安全性 | 8 | 见下方安全检查清单 |
| 综合评分 | 7.0 | 三项均值 |
安全检查清单：
| 检查项 | 结果 |
|---|---|
| ① Shell 命令与权限范围 | 附带脚本仅在用户指定的本地文件/目录内做文本扫描（AI 痕迹检测、待办标记汇总），范围明确，无越权系统操作 |
| ② 运行时联网外发 | 仅 citation-verify.py 会将解析出的引用作者/标题/年份查询 Crossref、OpenAlex 两个公开学术 API（均无需鉴权），用途在脚本注释中完整公开说明 |
| ③ API Key/凭据 | 核心写作功能与引用核验均无需任何密钥或账号 |
| ④ 可疑指令排查 | 已抓取 SKILL.md 全文与全部脚本源码，未发现 prompt injection 或隐藏指令 |
| ⑤ 作者/组织信誉 | 作者实名公开（含学术背景与联系方式），提交历史体现真实、细致的长期迭代，附 Zenodo 学术存档与规范引用信息，无造假迹象 |
| ⑥ License | CC BY-NC 4.0，条款清晰（署名-非商业性使用） |
| ⑦ 最近维护 | 最新版本发布于 2026-07-13，近期持续维护 |
安全检查清单①②③④⑤⑥⑦全部通过，无可疑迹象、无权限滥用、License 明确、联网目标透明，故安全性定为 8（“有代码执行但范围明确、可审计；无外联或外联目标透明；License 清晰”档位）。
7. 跟同类 Skills 相比的优势
| 对比对象 | 定位 | 与本 skill 的差异 |
|---|---|---|
| academic-research-skills | 面向 STEM/多学科的学术全流程多智能体系统（文献检索-写作-同行评审-发表，内置 PRISMA 系统综述协议） | 规模更大、流程更工程化，但方法论偏经验科学；本 skill 专精人文学科，核心是保护作者独特论证嗓音与理论谱系，而非标准化产出 |
| 通用 AI 写作润色工具 | 面向泛用文本的语法/表达打磨 | 通用工具倾向把文字磨成“标准学术腔”；本 skill 明确反其道而行，四层级评审聚焦论证严谨性而非表面润色 |
核心差异化：多数学术写作工具解决的是“检索文献”或“打磨句子”，本 skill 聚焦人文学科特有的痛点——论证与文字不可分割、审稿人真实存在且尖锐——并用可校准的对抗性评审与引用真实性核验直接回应。
8. 用户评价
该技能目前在第三方平台尚无具名用户评价（论坛讨论、独立博客评测等）。GitHub 上仅有一条真实用户提交的功能建议 Issue，已获回应并关闭。
9. 其他补充
项目在 Zenodo 完成学术存档并分配 DOI，附带标准 CITATION.cff 引用文件，便于在学术写作中规范引用本工具本身；提供完整中英双语文档（README、SKILL.md、全部 references/ 参考资料均有中文版）。
10. 安装使用方式
Claude Code（推荐）：
git clone https://github.com/tizzy916/humanities-writing-companion.git \
~/.claude/skills/humanities-writing-companion
chmod +x ~/.claude/skills/humanities-writing-companion/scripts/*.sh免 git 安装： 在仓库页面点击 Code → Download ZIP，解压后将文件夹移入 ~/.claude/skills/humanities-writing-companion，同样需对 scripts/ 下脚本执行 chmod +x。
Claude Agent SDK： 可直接将 SKILL.md 内容加载进系统提示词，纯文本、无运行时依赖。
Claude 桌面版 / claude.ai： 将技能文件夹打包为 .zip 后在“技能”设置中上传；纯聊天环境下仅对话式功能可用，scripts/ 脚本需可执行 shell 环境才能运行。
安装后验证： 新开一次对话，询问 Claude “你现在加载了哪些技能？“确认列表中出现 humanities-writing-companion；或直接说出触发语（如”帮我看看这段“）观察是否以四层级评审的口吻响应。
11. 注意事项
- 引用核验脚本依赖 Crossref、OpenAlex，对专著、档案文献、非英语文献覆盖有限，未核验到不代表引用有误；
- License 为 CC BY-NC 4.0（非商业性使用），商业场景需另行确认授权；
- 除 Claude Code 外，其他 Agent（Codex、OpenClaw、Hermes Agent）尚无作者官方验证材料，虽技能采用开放 SKILL.md 格式且脚本无 Claude 专属依赖，建议使用前自行测试。