| name | researchwrite |
| description | Proposal-first scientific writing pipeline. Three modes (compose/revise/hybrid) with four-layer QA pipeline. Enforces evidence-before-prose, argument-before-sections, and contracts-before-paragraphs.
|
| version | 1.0.0 |
| author | 十五 (JL Lab) |
| license | MIT |
| metadata | {"hermes":{"tags":["research","writing","proposal","revision","qa","multi-agent"],"related_skills":["brainstorming","professor","avoid-ai-writing","docx"]}} |
researchwrite — proposal-first 科研写作 pipeline
受 autonovel(状态机+打分)、professor(动态专家)、brainstorming(入口追问)、anti-AI-writing(语言清理)启发的科研写作状态机。不是通用"帮我写论文"prompt。
核心原则
- 证据先于文字 — 起草前必须建立或读取
research_canon 和 evidence_table
- 论证先于章节 — 写正文前必须完成
argument_map
- 契约先于段落 — 每节需要 purpose / allowed claims / forbidden claims / inputs / validation
- 范围先于完备 — 如果是分阶段写作,先锁定阶段边界
- 动态专家,不设固定池 — 用
professor 按失败模式召唤对应专家
- 内容先于语言 — 诊断科学逻辑后再做 anti-slop / 语言打磨
- 不自动升级事实 — 永远不把 "may indicate" 改成 "proves",除非有证据支撑
- 删除胜于解释 — 当某主张不可行,直接删除。正文干净,解释留给答辩
- 该停就停 — 平台期、专家冲突、证据缺失是停止理由,不是润色理由
模式分派
| 输入 | 模式 |
|---|
| 题目、方向、模糊想法 | compose — 加载 references/compose-mode.md |
| 已有段落/章节/完整 proposal | revise — 加载 references/revise-mode.md |
| 已有草稿 + 扩写/补写/重构 | hybrid — 加载 references/hybrid-mode.md |
模糊时推断默认模式。只在选择会改变工作流时才问用户。
项目结构
工作目录:<outputs>/researchwrite/<project-slug>/
标准文件:
00_scope.md 写作任务边界
01_research_canon.md 硬事实和约束
02_evidence_table.md claim → evidence 映射表
03_argument_map.md 论证架构
04_section_contracts.md 每节的 purpose / inputs / allowed & forbidden claims
05_style_guide.md 风格、术语、禁用表达
state.json 项目状态(mode、round、scores、technical_debts)
sources/ 用户材料、文献、数据
drafts/ 草稿和分节文件
revision_briefs/ 修订简报
qa_logs/ 诊断、专家审查、anti-slop、打分记录
exports/ 最终输出(.md + .docx)
新建项目时从 templates/ 取空模板。references/worked-example-quaternary-proposal.md 提供了基于通用材料科学领域的完整填写示例。
Reference 文件索引
公开版本包含四个关键 reference:
| Reference | 用途 |
|---|
references/evaluation-rubric.md | 8 维 × 4 锚点评分体系 + 评分流程 |
references/stopping-rules.md | 迭代循环终止条件 |
references/foundation-files.md | 建立 foundation 五文件 |
references/validation-checklist.md | 自动校验清单 |
完整 reference 文件(compose/revise/hybrid 模式详解、专家分派、导出归档、综述框架等 12 份)未包含在公开版本中。如需获取,请通过 GitHub issue 或邮件联系作者。
运行交付
每次运行结束时输出:
- 当前文件路径或修订后文本
- 当前分数/状态
- 剩余风险
- 一条建议的下一步
QA Mode — 四层质量保障 Pipeline
当用户说"审查这段/跑 QA/检查方案/过 pipeline"时,进入 QA 模式。
情境挡位
| 挡位 | 适用场景 | 阈值 |
|---|
paper | 投稿论文 | 7.0 |
proposal | 研究方案/开题 | 7.0 |
internal | 内部汇报/周报 | 5.0 |
quick | 快速扫读 | 无 |
Pipeline 顺序(先内容后语言)
Gate 2: professor Convener(内容层)
├── 论文 → 方法论专家 + 领域专家
├── proposal → 可行性专家 + 创新性专家
└── 文献reviews → 覆盖面专家 + 批判深度专家
│
▼
Gate 1: avoid-ai-writing 模式 detect-only
└── 只对英文有效,中文跳过或降级为手工扫读
│
▼
Gate 3: auto-validation(格式/完整性层)
└── 每个 claim 有 citation?方法可复现?编号连续?
│
▼
Gate 4: 评分阈值(分维度打分)
├── 总分≥阈值 → 通过 ✅
└── 总分<阈值 → 按低分维度定向回退(不超过 3 轮)
Gate 2 在 Gate 1 之前 — 避免改了句子后被专家打回重写。
使用方法
用户: "用 researchwrite 审查这段 discussion,paper 挡位"
→ 自动走 Gate 2 → Gate 1 → Gate 3 → Gate 4
→ 返回审查报告 + 定向修改建议
用户: "快速扫一下这个邮件"
→ 走 quick 挡位,只标记 P0 问题
配置你的研究域
首次使用告诉 agent 你的研究背景,agent 会调用 professor 建立领域专家知识。后续写作中专家审查会基于你的领域。