# Codex Harness Agent Package

本包默认使用方案 A 的极简根目录布局。安装后目标项目使用 `task.json + tools/harness/codex-loop.ps1` 作为自动执行入口，driver 负责选择任务、运行验证、写 trace、更新进度和提交结果。

SpecKit 相关 `.specify/`、`workflows/speckit.*` 和 `speckit-*` skills 仍随 full 包安装，但它们用于需求、计划和任务输入生成；方案确认后应转入 `task.json`，再交给 full driver 执行。

## 安装

从包含 当前仓库包根目录的项目父目录运行：

```powershell
powershell -NoProfile -ExecutionPolicy Bypass -File .\tools\install\install-agent-here.ps1 -InitGitIfNeeded
```

从已安装的 `.agents/` 自更新：

```powershell
powershell -NoProfile -ExecutionPolicy Bypass -File .\tools\\install/install-agent.ps1 -ProjectRoot . -Mode full -Force
```

## 安装产物

- 项目根 `AGENTS.md`
- `tools/harness/` 下的 `tools/harness/codex-loop.ps1`、`tools/harness/doctor.ps1`、`tools/harness/verify.ps1`
- `tools/install/` 下的 `tools/install/bootstrap-codex-harness.ps1`、`tools/install/env-check.ps1`、安装脚本
- 项目根 `task.json`、`progress.txt`
- `tools/harness/templates/` 下的 `smoke-task.json`、`tools/harness/templates/project-task-template.json`
- `docs/harness/trace.schema.json`
- 项目根 `.codex/`
- 项目根 `docs/harness/`、`docs/testing/`
- 项目根 `.agents/` 完整能力包，包括 rules、skills、workflows、`.specify/` 和模板复制源

## 使用顺序

1. 读取项目根 `AGENTS.md`。
2. 用 `docs/harness/new-project-usage.md`、`docs/harness/architecture.md` 和 `docs/testing/*` 收敛项目上下文。
3. 必要时使用 SpecKit workflow 生成 spec / plan / tasks 输入。
4. 将确认后的任务写入 `task.json`。
5. 运行：

```powershell
powershell -NoProfile -ExecutionPolicy Bypass -File .\tools\\harness/verify.ps1
powershell -NoProfile -ExecutionPolicy Bypass -File .\tools\\harness/codex-loop.ps1
```

## 验证安装包

```powershell
powershell -NoProfile -ExecutionPolicy Bypass -File .\scripts\harness\test-install-modes.ps1
```

该脚本现在只验证 full 安装形状。
