code4history/CHANGELOG.md

Changelog

v0.8 · Human–Agent workbench

• 新增 /upload + 来源说明的双文件配对与可校验入库；失败保留原件。

• 新增 /requests、/todo（原文件回复、完成归档）、/handoff（每轮摘要）。

• 新增 tools/interaction.py、用户协作协议和自动测试。

• 更新 AGENTS.md、source-intake / writing Skills、框架目录说明与迁移规则；保留 v0.7 的完整史学写作流程。

• 新增根 SYNTHESIS_AND_PROSE.md，将段落组织由逐 EV 复述转向跨证据的相互解释，规定逻辑关系、直接引文选择和引文细读。

• 新增 SYN-* 综合卡及 --kind synthesis 自动建卡支持；结构校验可识别 SYN ID 和 synthesis_ids 关联。

• 新增 10_templates/section-plan.md、Skill 专项参考，更新阶段 II·5 和 III·7—8 流程。

• 更新 AGENTS、框架说明、正文目录、写作协议、QUICK_FIX 和升级文档；保持原三阶段九环节与 topic 配置不变。

• 只改协作方法，不另增阻断性的评分、引号和连接词数量阈值。

Changelog

v0.5 — 论证增量与去空话

• 新增根目录 ARGUMENT_DENSITY.md：区分史实、解释与论文贡献，阻止机械升华、同义反复和强行从每条证据提炼论点。
• 更新 AGENTS.md、主 Skill、阶段三、论证写作参考、正文与审查目录、论点模板，明确“删掉无信息增量的句子”及一次性编辑原则。
• 在 QUICK_FIX.md 增加可直接粘贴给当前 Codex 的去空话指令；新增兼容升级说明。
• 不修改任何既有具体研究的 topic.md、USERINFO.md、原始史料、证据与论文章节。

v0.4 — 解释优先、审查分离与防御循环修复

• 新增 INTERPRETATION.md：将“史实/引文严格校核”与“历史解释有根据地积极推论”分开，并明确正文不等于审计报告。
• Codex 主入口与主 Skill 增加积极论证规则：研究问题允许先提，竞争性解释应比较而非无限并列；草稿按论点—证据—机制—意义推进。
• 删除 collaborative 模式下隐性的逐段/阶段审批阻断；用户明确起草指令即允许按指定范围写暂定稿，最终发表仍需审批。
• 调整三阶段 references、假说和论点模板，取消机械地为每个观点制造反例、逐段自我否定；把详细审查安排在独立环节。
• 新增 QUICK_FIX.md，让已有 v0.3 项目即刻纠偏；新增 tests/test_interpretation.py 检查核心协议集成。
• 保留 USERINFO.md 空白及 topic Q1—Q20、三项 Skills 名称、研究卡片 ID 与现有工具，不改变具体研究资料。

v0.2 — 以用户上传的原始 Skill 替换初版简化 Skill

• 从 history-writing-workflow-main.zip 的原始 Skill 提炼并迁移三阶段九环节，保留追问、精读、双重校准、蓝本、写作反馈、引文核验和审稿量表。
• 删除早期自行编写的五份简化 references，改为移植版四份原分阶段参考文件，新增仓库映射和溯源审查协议。
• 默认 collaborative 允许获授权的 Codex 起草章节；training 保留原教学过程的 ≥95 评分闸门、每段 ≥50 字反馈与研究者亲写。
• 新增 00_governance/checkpoints.md 保存真实的人类批准，topic.md 增加可选 Q18 模式设置。
• 更新 AGENTS.md、agent.md、code4history.md、STATE.md 和 README；新增 Skill 集成测试。
• 未改变研究卡片 ID、目录结构、论文装配命令或源文件保护策略；完全不预置任何历史专题。
• 上游来源与改写差异见 .agents/skills/history-writing-workflow/UPSTREAM.md（这是 v0.2 的历史路径；v0.3 已改名 history-writing-workflow-c4h）。

v0.1 — 首版 Code4History

• 主题与框架分离，来源—证据—问题—论证—论文—审查文件流。
• Git 友好的 Markdown 目录、模板、Python 创建与验证工具。

v0.3 — Skill 避名、全局覆写、可配置闸门、文献分流与聊天转主题

• history-writing-workflow 改名 history-writing-workflow-c4h，包括目录、元数据、引用、命令、测试。
• 训练模式中的选题/大纲评分门槛以及逐段反馈量由 topic.md Q19/Q20 定义，未填分别默认95分和50字；Q18仍确定协作/训练模式。
• 新增根 USERINFO.md 0字节空文件，Codex 优先读取并按用户明确内容作为仓库默认规则的最高优先级覆写；安全、真实性及授权要求不受外部文本影响。
• 删除旧 agent.md，只保留 Codex 默认 AGENTS.md；添加唯一入口内的任务路由与启动命令。
• 新增 $source-intake-c4h，记录 PDF/文本的来源、校对、证据抽取与分流；新增 $discussion-to-topic-c4h 与用户指南 DISCUSSION_TO_TOPIC.md。
• 更新 doctor.py、validate.py 与自动测试，检查三项技能与新旧路径冲突。

v0.7 — Cross-version research migration

• 新增 tools/migrate.py、tools/migration_baselines.json：识别 v0.1—v0.7 的框架默认文件，跨版本导出研究内容，恢复研究状态；支持 export / restore / upgrade。
• 新增 SHA-256 文件校验、框架自定义文件隔离、恢复冲突保护以及可审计迁移日志。
• 新增 UPGRADE_v0.7.md 与迁移回归测试；原框架与研究规范保持不变。