v2.5.2

v2.5.2 — Skill trigger eval tooling

Added

• evals/skill-triggers/ — 8 skills × should/should-not queries + description_signals
• validate_skill_triggers.py — static checks (no LLM / no claude CLI)
• Local test test_skill_trigger_static.py

Changed

• Session hook: read profile/PROJECT.md + skill-index.md each round

---

新增

• evals/skill-triggers/ — 8 个 Skill 的触发评测集
• validate_skill_triggers.py — 静态校验 description 关键词
• 本地测试 test_skill_trigger_static.py

变更

• Session 钩子：每回合提醒读 profile/PROJECT.md 与 skill-index.md

v2.5.1

v2.5.1 — Skill rewrite & trigger optimization

Changed

• All built-in Skills rewritten (skill-creator: lean bodies, pushier descriptions)
• using-harness + skill-index.md; docs refresh with emoji
• Full docs/zh-CN & docs/en rewrite; TRIAL & plugin README
• Local trigger eval: evals/skill-trigger-eval.json

Includes v2.5.0

• Removed harness/rules/ bundle; template 0.6.0

---

变更

• 全部内置 Skill 按 skill-creator 重写（正文精简、description 强化触发）
• 新增 skill-index.md；文档 emoji 焕新
• docs 中英文全套重写
• 维护者触发评测：evals/skill-trigger-eval.json（本地）

含 v2.5.0

• 移除 harness/rules/；模板 0.6.0

v2.4.0

v2.4.0 — Project profile & local evolution eval

Added

• harness/profile/ — project-owned portrait (PROJECT.md) and evolution audit log (evolution.jsonl)
• Install scaffolds profile; update never overwrites it
• Workflow evolution ritual: propose → user confirm → append log

Changed

• using-harness reads profile/PROJECT.md every round
• DECISIONS.md — topic-based major decisions; toolchain lives in pyproject.toml / commands.gate
• python-code-style no longer writes toolchain summary to DECISIONS
• doctor warns if profile is missing
• GitHub repo stays plugin-only: mini-harness/tests/ and mini-harness/evals/ are gitignored (maintainers run locally)

---

新增

• harness/profile/ — 项目自有画像（PROJECT.md）与进化审计（evolution.jsonl）
• install 脚手架 profile；update 永不覆盖
• 工作流进化仪式：提案 → 用户确认 → 追加日志

变更

• using-harness 每回合读取 profile/PROJECT.md
• DECISIONS.md — 按主题记录重大决策；工具链以 pyproject.toml / commands.gate 为准
• python-code-style 不再向 DECISIONS 写入工具链摘要
• doctor 在缺少 profile 时告警
• GitHub 仅发布插件产物：mini-harness/tests/、mini-harness/evals/ 已 gitignore（维护者本地运行）

v2.3.0

v2.3.0 — Remove GOAL mode

Removed

• Built-in goal-md skill and harness/goal/ scaffold
• Dual-path workflow (regular vs GOAL); single todo + AC path only

Notes

• Existing repos with harness/goal/ are unaffected until update; the directory is no longer created on fresh install
• Run harness/scripts/mini_harness.py update to drop managed goal-md skill copy

---

移除

• 内置 goal-md Skill 与 harness/goal/ 脚手架
• 双路径工作流（常规 vs GOAL）；恢复单一 todo + AC 流程

说明

• 已有 harness/goal/ 的仓库在 update 前不受影响；新 install 不再创建该目录
• 执行 harness/scripts/mini_harness.py update 可移除受管副本中的 goal-md

v2.2.1

v2.2.1 — AGENTS.md 遗留安装器修复

English

• Fix: update from an old harness/scripts/mini_harness.py (v2.0) no longer recreates root AGENTS.md
• Repo-local install/update now force-syncs harness/scripts/ from harness/.package
• Legacy harness AGENTS.md files are removed when they match the old playbook fingerprint
• doctor warns if root AGENTS.md exists or if harness/scripts/mini_harness.py drifts from .package

If you still have AGENTS.md: run python mini-harness/scripts/mini_harness.py install --root . (from the plugin), then python harness/scripts/mini_harness.py update --root .

中文

• 修复： 从旧的 harness/scripts/mini_harness.py（v2.0）执行 update 时不再重新生成根目录 AGENTS.md
• 仓库内 install/update 现会强制同步 harness/scripts/（来自 harness/.package）
• 识别旧 Playbook 指纹时自动清理 harness 遗留的 AGENTS.md
• doctor 对根目录 AGENTS.md 及安装器与 .package 漂移给出警告

若仍有 AGENTS.md： 先从插件执行 python mini-harness/scripts/mini_harness.py install --root .，再 python harness/scripts/mini_harness.py update --root .

goal-md / GOAL 自主改进

• 新增内置 Skill goal-md：适应度函数 + 多轮自主改进循环
• GOAL 产物统一在 harness/goal/（index.md、GOAL.md、score.py、iterations.jsonl）
• 与常规 todo + AC 流程互补（todo 元任务 + iterations.jsonl 记迭代）
• 脚手架：python harness/skills/goal-md/scripts/init_goal.py --name "你的目标"（须先 install）
• 已激活仓库请执行 python harness/scripts/mini_harness.py update --root . 同步新 Skill

using-harness skill entry / 工作流入口 Skill

• 破坏性变更： 移除 AGENTS.md；工作流在 skills/using-harness/SKILL.md 与 references/workflow.md
• 核心 Skill 重命名为 using-harness
• 插件安装即可用；未 install 的仓库也会收到 Session 钩子提醒
• 已激活仓库请执行 python harness/scripts/mini_harness.py update --root . 完成迁移

v2.0.0 — Plugin architecture

v2.0.0 — Plugin architecture / 插件架构

English

• Breaking: replaced mini-harness-en/ and mini-harness-zh/ skill packages with unified mini-harness/ plugin
• New installer: python mini-harness/scripts/mini_harness.py install --root .
• Built-in skills, session hooks (Cursor / Codex / Claude Code), AC workflow, harness/rules/
• Tests at repo root tests/; maintenance via doctor / update
• Upgrade: remove old skill installs; run install in each target repo

中文

• 破坏性变更： 用统一 mini-harness/ 插件取代 mini-harness-en/、mini-harness-zh/ Skill 包
• 新安装器： python mini-harness/scripts/mini_harness.py install --root .
• 内置 Skills、Session 钩子（Cursor / Codex / Claude Code）、AC 工作流、harness/rules/
• 测试在仓库根 tests/；维护用 doctor / update
• 升级：移除旧 Skill 安装；在各目标仓库重新 install

v1.2.0 — Monday Agent Weekly Review

v1.2.0 — Monday Agent Weekly Review / 每周一 Agent 周回顾

English

• New: harness/docs/weekly-review.md — Agent-driven weekly harness review (active vs archive checklist)
• AGENTS.md: weekly review round on first Monday session (or first session of a new week if skipped)
• init_harness.py: scaffolds weekly-review doc; CI validates the file
• No dedicated weekly review script — Agent follows the doc; uses archive_harness_todo.py + sync_progress.py
• Install: npx skills add HYX-LHJ/mini-harness@v1.2.0 --skill mini-harness-en -g -y (or mini-harness-zh)

中文

• 新增：harness/docs/weekly-review.md — Agent 主导的 harness 周回顾（活跃/归档清单）
• AGENTS.md：每周一当天首个会话（或新自然周首个会话）须先完成周回顾
• init_harness.py：初始化落盘周回顾文档；CI 校验该文件
• 无专用周回顾脚本 — Agent 按文档逐项落盘，可调用 archive_harness_todo.py 与 sync_progress.py
• 安装：npx skills add HYX-LHJ/mini-harness@v1.2.0 --skill mini-harness-zh -g -y（或 mini-harness-en）

v1.1.0

v1.1.0 — Bilingual Skill Packages / 双语 Skill 包

English

• Two Skill packages: agent-harness-en/ (English) and agent-harness-zh/ (Chinese)
• Split docs: docs/en/ and docs/zh-CN/
• Install: npx skills add HYX-LHJ/round-harness --skill agent-harness-en -g -y (or agent-harness-zh)

中文

• 两个 Skill 包：agent-harness-zh/（中文）、agent-harness-en/（英文）
• 文档拆分：docs/zh-CN/ 与 docs/en/
• 安装：npx skills add HYX-LHJ/round-harness --skill agent-harness-zh -g -y（或 agent-harness-en）