# 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` 与迁移回归测试；原框架与研究规范保持不变。