# Changelog

本项目遵循 [Keep a Changelog](https://keepachangelog.com/zh-CN/1.1.0/)，版本号遵循 [语义化版本](https://semver.org/lang/zh-CN/)。

## [2.0.0] — 2026-04-15

首个面向公众的正式发布版本。基于上游 `revfactory/harness` 的 v1.2.0 韩文原版，完整重构为简体中文并新增生产级 QA/测试维度。

### Added
- **QA 时序一致性维度**（`references/qa-agent-guide.md` §2-5）
  - 6 步验证流程：异步操作识别 → 幂等性 → 并发写冲突 → 回调乱序 → 超时补偿 → 缓存失效
  - 5 类常见时序 bug 模式对照表
  - 最终检查清单新增 6 项
- **对抗性测试变体**（`references/skill-testing-guide.md`）
  - 4 类扰动：输入残缺 / 格式异常 / 矛盾指令 / 多义表达
  - 差异化评估标准（不要求产出完美，但禁止 silent failure）
- **触发短语扩展**（SKILL.md frontmatter）
  - 新增第 6 类：「组织 agent」「多 agent 协作」「搭建自动化流程」「agent 怎么分工」等泛化表达
- **领域示例新增**（`qa-agent-guide.md`）
  - §6 Web 应用（Next.js）
  - §7 数据管道
- **分级模型策略**（SKILL.md）
  - 新增"任务复杂度 × 推荐模型"表
  - 允许低复杂度结构化任务降级为 sonnet

### Changed
- **模型策略松绑**：由"所有 agent 硬性 `model: opus`"改为"默认 opus，允许 sonnet 分级"。依赖全 opus 的上层调用方需显式感知此变化。
- **QA 方法论泛化**：`qa-agent-guide.md` §2 从 Next.js 专属改写为领域中性，具体域示例独立成节。
- **文档瘦身**：
  - `SKILL.md` 443 → 356 行（-20%），执行模式示意图迁移至 `orchestrator-template.md`
  - `orchestrator-template.md` 428 → 267 行（-38%），删除 ~160 行冗余"Phase 再叙述"
  - 数据传递策略矩阵从 SKILL.md 迁至 orchestrator-template.md
- **Skill 标识**：`name: harness_zh` → `name: harness-zh`（符合 Claude Code 命名约定，使用连字符）

### Removed
- SKILL.md 中的 `cloud-deploy/` 目录树示例
- SKILL.md 中的显式变更历史 markdown 代码块示例
- `qa-agent-guide.md` 中的 SatangSlide 项目特定内容（保留方法论，移除项目归属）

### Preserved
- Phase 0–7 命名、顺序、子 phase 结构
- 6 种架构模式（Pipeline / Fan-out·Fan-in / Expert Pool / Producer-Reviewer / Supervisor / Hierarchical Delegation）
- 3 种执行模式（Agent Teams / Subagents / Hybrid）
- 完整参考文档集（6 份）

### Migration Notes
从 `revfactory/harness` 上游切换到本版本：
- **Skill 名不同**，两者可并存安装，不会冲突。
- **模型约束变化**：若你有外部校验"全 agent 必须 opus"，需调整为"必须指定 `model` 字段"。
- **触发短语扩展**：本版本命中面更广，可能在不希望激活 harness 的"泛 agent 讨论"中被触发；可在会话中显式说「不使用 harness-zh skill」。

## [1.0.0-internal] — 2026-04-15

内部 v1 版本，未公开发布。主要变化：
- 从韩文原版重构为中文
- 文档瘦身（SKILL -20%、Orchestrator -38%）
- 触发短语与领域示例扩展
- 模型策略分级化

未收录 QA 时序一致性与对抗性测试——这两项于 v2.0.0 补齐。

---

## 上游版本关联

本仓库上游：[revfactory/harness](https://github.com/revfactory/harness)，当前参照其 `v1.2.0`（2026-03 前后）。

[2.0.0]: https://github.com/nilecui/harness-zh-release/releases/tag/v2.0.0