WantongC/journal-adapt-writing-skill

# 期刊适应写作技能     目前已经存在许多有用的**静态学术写作技能**：学科模板、反AI措辞规则、引用/公式安全规范以及通用的学术风格指南。它们很有价值，但通常对每篇稿件都应用相同的规则。 缺失的关键部分是**期刊适配**。即使是同一篇稿件，为期刊A写作与为期刊B写作可能需要不同的引言逻辑、贡献框架、方法阐述、结果侧重点和讨论范围。一个强大的修订工作流应能从实际定义目标写作方向的论文中学习。 **journal-adapt 在可选的静态技能之上增加了这个动态层。** - **静态技能**是可复用的基础规则：学科规范、通用学术写作约束、反AI措辞清理、引用/公式安全规范，或你自己的实验室/导师指南。 - **动态技能**是为一篇稿件和一个写作目标生成的，基于用户提供的语料库：目标期刊论文、可选的领域顶尖或主题相似论文，以及可选的用户/实验室范例。 其产出是一个可见、可编辑的 `dynamic_writing_skill.md`。它不会自动撰写论文；而是为智能体提供一个可审计的、逐节进行的学术改写修订框架。 ## 静态 + 动态 ``` flowchart TD A[Optional Static Skills\nreusable base rules] --> E[Dynamic Writing Skill] B[Target Journal Papers\nprimary corpus] --> D[Corpus Style Profile] C[Field-top or Topic-similar Papers\noptional] --> D U[User / Lab Exemplars\noptional] --> D D --> E E --> F[Human Review] F --> G[Section Revision] G --> H[Revision Log] style E fill:#e8f5e9,stroke:#4caf50 style F fill:#f5f0e8,stroke:#999 ``` ## 可选的静态技能 静态层是可选的。你可以选择一个现有的开源技能，带上你自己的，或者跳过这一层。 | 静态选项 | 领域 / 目的 | 来源 | |---------------|-----------------|--------| | 经济学写作 | 经济学写作与审稿风格指导 | [hanlulong/econ-writing-skill](https://github.com/hanlulong/econ-writing-skill) | | ML / CV / NLP 写作 | 面向 ML 类论文的研究论文写作 | [Master-cai/Research-Paper-Writing-Skills](https://github.com/Master-cai/Research-Paper-Writing-Skills) | | CS / 研究论文写作 | 面向计算机系统、网络及 ML 相关论文的研究论文流程 | [SNL-UCSB/paper-writing-skill](https://github.com/SNL-UCSB/paper-writing-skill) | | 哲学 / 跨学科写作 | 学术论文的规划与写作 | [lishix520/academic-paper-skills](https://github.com/lishix520/academic-paper-skills) | | 通用 AI 写作清理 | 通用 AI 写作清理 / 人性化约束 | [blader/humanizer](https://github.com/blader/humanizer) | 更多详情：[静态技能推荐](docs/STATIC_SKILL_RECOMMENDATIONS.md)。 你也可以使用自定义的静态技能： | 自定义输入 | 适用场景 | |--------------|----------| | 你自己的 `SKILL.md` | 你已经拥有可复用的智能体指令。 | | 实验室/导师写作指南 | 你的小组有稳定的风格偏好。 | | 期刊或领域检查表 | 你想要一个轻量级的规则表，而不是一个完整的技能。 | | 无静态技能 | 你希望动态语料库自行驱动工作流。 | ## 动态语料库 动态语料库是主要功能。它的范围比“来自目标期刊的论文”更广。 | 语料库角色 | 是否必需？ | 其贡献 | |-------------|-----------|---------------------| | **主要语料库：目标期刊论文** | 是 | 期刊的本地写作文化：结构、贡献框架、方法/结果阐述、讨论范围。 | | **次要语料库：领域顶尖或主题相似论文** | 可选 | 当目标期刊语料库较小或主题需要额外参考点时，提供高质量的领域写作。 | | **用户/实验室范例** | 可选 | 应保留的作者、导师或实验室偏好（当它们不与目标期刊冲突时）。 | 目标期刊通常具有最高优先级。可选的次要论文和用户/实验室范例丰富了动态技能，但除非用户明确选择该行为，否则它们不会覆盖经审阅的目标期刊模式。 ## 优先级系统 | 优先级 | 来源 | 规则 | |----------|--------|------| | P1 | 硬约束 | 保留事实、引用、公式、符号、数值结果、标签和作者定义的术语。 | | P2 | 目标期刊语料库 | 遵循经审阅的目标期刊模式。 | | P3 | 次要语料库和范例 | 当目标期刊证据缺失或较弱时，使用高质量的领域模式或用户/实验室偏好。 | | P4 | 静态基础技能 | 当语料库信号无法决定时，应用学科或通用写作规则。 | | P5 | 清理规则 | 移除 AI 口吻短语、空洞过渡、通用贡献和无依据的过度主张。 | P1 始终胜出。P2 通常优于 P3 和 P4。任何改变修订行为的冲突都应记录在修订日志中。 ## 语料库准备 推荐的起始规模： | 语料库角色 | 推荐规模 | |-------------|------------------| | 主要语料库：目标期刊论文 | 5-8 篇 | | 次要语料库：领域顶尖或主题相似论文 | 2-5 篇 | | 用户/实验室范例 | 1-3 份文档 | 所有语料库文件在阶段 1 之前应完全可读（Markdown/文本格式）。如果 PDF 转换不完整，请重试转换，使用其他转换器，提供干净的 Markdown/文本，或替换该论文。 ## 快速开始 ### 1. 安装技能 对于 Claude Code： ``` mkdir -p ~/.claude/skills/journal-adapt cp -R skill/* ~/.claude/skills/journal-adapt/ ``` 对于 Codex，如果你的本地设置支持自定义技能，请将 `skill/` 文件夹复制或符号链接到你的 Codex 技能目录中。你也可以保持仓库打开，并直接要求 Codex 使用 `skill/SKILL.md`。 更多详情：[安装与 PDF 转换](docs/INSTALLATION.md)。 ### 2. 准备输入 基本的 Markdown 工作流，无需 MinerU： ``` my_project/ ├── corpus/ │ ├── target_journal_001.md │ ├── target_journal_002.md │ └── field_top_paper_001.md └── manuscript.md ``` PDF 工作流： ``` my_project/ ├── corpus_pdfs/ │ ├── paper_001.pdf │ └── paper_002.pdf └── manuscript.pdf ``` PDF 输入需要 PDF 转 Markdown 转换器。支持 MinerU，但如果 MinerU 难以安装，推荐使用 Markdown 输入路径。 ### 3. 调用 ``` /journal-adapt ``` 或者询问： ``` Help me build a dynamic writing skill for my manuscript using these target-journal papers and this base writing skill. ``` 该技能将询问： 1. 目标期刊或写作目标 2. 主要语料库文件夹 3. 可选的次要语料库文件夹 4. 可选的用户/实验室范例文件 5. 可选的基础写作技能 6. 稿件文件 7. 需要修订的部分 ## 输出 保存在稿件旁边： ``` [manuscript_name]_revised/ ├── dynamic_writing_skill.md ├── style_profile.md ├── abstract_revised.md ├── introduction_revised.md ├── ... ├── [section]_revision_log.md └── revision_summary.md ``` 修订后的文件为 Markdown 格式。审核后，可将其移入 LaTeX、Word 或其他写作环境。 ## 示例 `examples/jeem/` 展示了针对《环境经济学与管理杂志》的一个匿名化 MVP 运行示例： - 语料库角色元数据 - 转换质量报告 - 汇总后的风格档案 - 生成的动态写作技能 - 匿名的部分诊断、修订示例和修订日志 原始 PDF、转换后的全文和私有稿件未包含在内。 ## 文档 - [安装与 PDF 转换](docs/INSTALLATION.md) - [静态技能推荐](docs/STATIC_SKILL_RECOMMENDATIONS.md) - [系统架构](docs/ARCHITECTURE.md) - [模块规格](docs/MODULES.md) - [模板](docs/templates/) ## 已知局限性 - 仅限英语学术写作。 - PDF 转换质量取决于转换器。MinerU 在某些本地设置上可能失败。 - 该项目仅提取写作结构和修辞模式。它不得引用或转述受版权保护的语料库论文。 - 生成的动态技能需要在修订开始前进行人工审核。 - 该工具不会添加稿件中尚未包含的事实、引用、结果或主张。 ## 许可证 MIT

标签：AI 辅助写作, Apex, Claude Code, Codex, 人工智能, 写作工具, 写作惯例, 出版辅助, 动态技能, 学术写作, 学术出版, 手稿修订, 文本分析, 文本编辑, 期刊适应, 机器学习, 用户模式Hook绕过, 论文修订, 防御加固, 静态技能, 风格学习