# 6.9 用百行代码写一个极简 Coding Harness，并装上第一个 Skill

这份代码用不到 170 行 Python 标准库（零第三方依赖）实现了一个完整的极简 Coding Harness：

1. **三个正交原子工具**：`read_file`、`write_file`、`bash`（带 `safe_path` 工作区路径边界检查与 15 秒命令超时）。
2. **Skill 渐进式披露**：启动时扫描 `workspace/.agents/skills/*/SKILL.md` 的 YAML 头部，只在系统提示词里放一行摘要（`< 50` 个 token）；当模型判断任务和某个 Skill 有关时，自己调用 `read_file` 按需读取完整的 `SKILL.md` 检查单。
3. **Agent 主循环**：循环把模型工具调用和环境输出追加进 `messages`，直到测试与对账脚本全部通过。

## 需要什么设备

只用 Python 3 标准库和 AI Builder Space API Key，任何电脑都能直接跑。

## 运行方法

```bash
cd 6_9_mini_harness
export AI_BUILDER_TOKEN=sk_你的key
python3 mini_harness.py
```

也可以换成你自己的指令：

```bash
python3 mini_harness.py --task "请给 settlement.py 增加单笔最高减免 50 元的上限参数，并补一条单元测试跑通"
```

## 该看到什么

默认任务让 Agent 修复 `workspace/settlement.py` 里的订单结算函数。运行后你会看到 6 轮完整的闭环轨迹（参考输出保存在 `sample_output/deepseek_run.txt`）：

- **第 1 轮**：看到系统提示词里的 Skill 摘要后，主动调用 `read_file` 读取 `.agents/skills/settlement-reconcile/SKILL.md`；
- **第 2–3 轮**：读取 `settlement.py`、`test_settlement.py` 和 `verify_ledger.py`，并用 `bash` 跑测试复现两处分位取整与满减门槛错误；
- **第 4–5 轮**：调用 `write_file` 修复代码，并按 `SKILL.md` 检查单的要求连续运行 `unittest` 与 `verify_ledger.py` 双重验收；
- **第 6 轮**：确认退出码均为 0 后输出修复报告并结束循环。