v0.7.0：轻量初始化与可选协作技能

更新内容

默认项目初始化从 22 个文件收敛到 9 个，保留真实项目约束、按需计划、恢复/运行记录模板与测试 runbook。四个通用技能移为独立的 project-workflows 插件包，可共享使用，也可通过 --skill 选择仓库副本。

• Bash、PowerShell 共用 Python 标准库实现，模板目录自动发现，减少重复文件清单。
• 默认保留已有 README、AGENTS、技能、Makefile 和历史文件；.gitignore 只维护标记块，原有规则保留。
• 当前请求与已有授权持续有效；计划、state、runs 与 runbook 按需使用，事实优先引用，避免重复状态和审批。
• 归档支持 issue_id 及旧字段。缺少完成证据的计划跳过；无 Issue 计划需要明确 --done-plan。修复移动计划内引用回写重新创建旧路径的问题。
• 发版辅助工具不再把 go.mod 或普通 manifest 变化直接视为升版；纯版本写入限定为 VERSION/version.txt，拒绝越界、符号链接与清单文件。修复 Unreleased 与既有版本段的边界。
• 移除旧控制面源和固定数量/禁词检查，历史内容仍可通过旧 tag 查询。

升级要求

• 初始化环境需要 Python 3.10+，无需第三方 Python 依赖。
• --force / -Force 已取消，会明确报错。替换已审阅的具体文件使用 --overwrite RELATIVE_PATH / -Overwrite。
• 默认不安装任何技能，已有技能副本也不会被自动删除。按需指定 --skill，或复用共享插件。
• 普通初始化不执行历史清理。旧文件应先核对归属、项目定制和引用，再单独处理；不能仅凭文件名删除 Makefile。

详细说明：迁移指南、可选技能包。

验证证据

开发阶段 make verify 共 38 项：37 项通过，1 项因缺少 PowerShell runtime 跳过。Bash 包装入口、共享 Python 核心、初始化边界、技能副本、归档和版本文件行为已验证；Python 3.10 语法解析、Bash 语法、插件 manifest、四个技能格式、Markdown 本地链接及 Git 差异检查通过。

PowerShell / Windows 未实跑。GitHub 未配置 CI checks；上述结果是本地开发证据。本次按约定未在提交和发版收尾重复执行测试。

来源

• PR #4，已合并。
• 合并提交：b20e5e8ece6a529c7d74aa0a8b1de77bd06c374c。
• 本次仅发布 GitHub，未更新 GitLab，源分支保留。

v0.6.0

更新内容

• 默认初始化进入极限模式，目标项目不再生成 Harness 流程、Makefile、Harness 文档、Harness 脚本和强制执行 gate。
• 默认保留 issue_provider=linear，并同步仓库 Issue 配置与模板约定。
• 模板中的 13 个 repo-local skills 已同步到项目。
• 保留 .agents/PLANS.md、.agents/plans/、.agents/state/、.agents/runs/ 等计划、状态和运行记录入口。
• 同步 Bash / PowerShell 初始化器、契约检查、文档和模板元数据。

迁移提示

已有目标文件默认不会覆盖；需要更新旧初始化产物时显式使用 --force / -Force。旧版本声明过的 Harness 文件只会在 force 模式下清理，未声明的业务文件不会被处理。

验证

• 开发阶段 make verify 已通过。
• 开发阶段 Bash 语法检查与 git diff --check 已通过。
• 当前机器没有 PowerShell runtime，已完成静态契约与双端一致性检查。
• 本次发版收尾按约定未重复执行测试或验证命令。

来源

• Commit: 838b539f60dbb94a1637aebfc1d2bd6a0ffcf17d
• Merge Request: !3（已合并）

v0.5.0

更新内容

• 将 docs/harness/ 聚合为单一 control-plane.md，项目 README 回归业务说明，项目真实约束统一归入 AGENTS.md。
• 将 .agents/prompts/ 收敛为 README、手动 issue workflow 与 thread handoff，删除重复的交互、自动化和维护 loop prompt。
• 引入渐进式读取，避免默认预加载整个 Harness；Plan 三件套由 854 行压缩为 428 行。
• 同步更新 Bash / PowerShell initializer、gate、obsolete cleanup、Goal Prompt 与 source/target/policy contract tests。

迁移提示

• docs/harness/issue-workflow.md 与 docs/harness/linear.md 已合入 docs/harness/control-plane.md。
• docs/harness/project-constraints.md 已移除，项目约束改由 AGENTS.md 维护。
• loop-codex.md、loop-automation.md、maintenance-loop.md 不再生成；force 初始化会清理这些旧文件。

验证

• make verify
• make -C template harness-verify
• git diff --check
• fresh init + full extensions + Cursor adapter 审计
• 当前机器无 PowerShell runtime；PowerShell 仅完成静态契约与双端一致性检查

v0.4.0

更新内容

• 拆分 harness 源仓完整回归与目标仓日常检查，新增根级 make verify，减少目标项目因模板文案变化产生的误阻塞。
• 新增 Bash / PowerShell verification evidence snapshot，对 HEAD、暂存区、工作区、未跟踪文件和 submodule 生成稳定证据指纹。
• 引入 standard / strict 自适应评审策略和严格的验证证据复用边界，同时保持 Issue 状态机、plan contract 与 review gate 接口兼容。
• 同步更新初始化器、Goal Prompt、扩展 Prompt、控制面文档及 source/target/policy contract 测试。

验证

• make verify
• make -C template harness-verify
• git diff --check
• Bash 脚本语法检查通过
• 当前机器无 PowerShell runtime；PowerShell 已通过静态契约与双端一致性检查

v0.3.0

更新内容

• 新增通用 issue-goal-prompt repo-local skill，用于从任务系统条目生成执行级目标提示词和 .agents/state/GOAL-* 长提示词恢复文件。
• 将该 skill 接入 Bash / PowerShell 初始化器与 harness gate，确保新仓初始化与校验覆盖新 skill。
• 同步更新 harness 模板导航和初始化 SOP，并将 issue-goal-prompt 目录文案改为中文。

验证

• python3 .../quick_validate.py template/.agents/skills/issue-goal-prompt
• cd template && make harness-verify
• git diff --check

v0.2.1

更新内容

• 移除 docs/test/ 外关于敏感信息、脱敏信息不能提交或不能写入的原则性约束。
• 将相关说明改为中性的结果摘要、配置示例和运行记录描述。
• 同步调整 Bash / PowerShell harness gate，不再强制检查非 docs/test/ 的敏感信息规则。

验证

• cd template && make harness-verify
• git diff --check

v0.2.0

新增内容

这次版本把 harness 扩展成可以支持 Codex 多 thread 协作的工作流模板。

以前一个目标通常放在一个 thread 里从头做到尾。现在可以由一个主 thread 负责拆分任务，把不同部分交给子 thread、worktree thread、review thread 或 test thread，然后再把结果收回来统一集成、验证和回写。

主要变化

• 新增了主 thread 编排规则
  主 thread 现在有明确职责：拆分目标、分配任务、跟踪子 thread 状态、回收结果、集成改动、做最终验证，并把结果写回 Issue 或仓库文档。

• 新增了 write_lease 写入授权机制
  当多个 thread 可能同时工作时，需要先声明自己要改哪些文件或目录。这样可以避免两个 thread 同时修改同一块代码导致冲突。
  支持两种方式：串行多写入，或者多个 thread 并行写入但写入范围必须互不重叠。

• 新增了 Current State 和 Thread Status 状态区
  Issue 里可以维护当前整体状态，子 thread 也可以用固定评论格式汇报自己的进度、写入范围、验证结果和是否完成。
  这样主 thread 不需要只靠聊天上下文，也能从 Issue 或本地状态文件恢复现场。

• 新增了双重验证要求
  子 thread 完成自己的任务后要先验证。主 thread 集成所有结果后，还要再做一次最终验证。
  如果主 thread 的目标里要求 live E2E 或真实环境验证，最终验证阶段必须覆盖它。

• 新增了完成标识规则
  子 thread 完成后不默认归档，而是在标题前加 【完成】。这样历史 thread 仍然可见，也方便之后继续追溯。

• 新增了 Codex 主 thread prompt
  orchestrator-thread.md 提供了可以直接复制使用的主 thread Goal Prompt 和子 thread handoff 模板。
  full 模式提供完整模板；placeholder 模式只保留入口和边界说明。

• 更新了本地恢复和结果模板
  .agents/state 和 .agents/runs 现在可以记录 root goal、子任务列表、活跃写入授权、等待中的子 thread、下次检查时间、集成结果和最终验证结果。

• 更新了 repo issue 模板
  当没有 Linear 或 GitHub Issue 这类外部 Issue 工具时，仓库内的 docs/issues 模板也能表达多 thread 编排状态。

• 更新了 harness 自检脚本
  Bash 和 PowerShell 的检查脚本都同步加入了新规则，避免模板文件缺失或关键约定没有落地。

Codex 专用能力说明

这次新增的 thread 创建、读取、继续、发送消息、修改标题和标记 【完成】 是 Codex 专用能力。

但 harness 的核心状态机不是 Codex 专属。即使没有 Codex thread 工具，也可以通过人工 handoff、Issue 评论、Current State 和 Thread Status 使用同一套协作规则。

使用建议

如果是普通单任务，继续按原来的 issue workflow 使用即可。

如果一个目标很大，或者需要多个方向同时推进，可以使用新的主 thread 编排 prompt：先由主 thread 明确 root goal，再拆分给子 thread 或 worktree thread。所有可写 thread 都要声明自己的写入范围，最后由主 thread 统一集成和验证。