README.md

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，任何电脑都能直接跑。

运行方法

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

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

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 后输出修复报告并结束循环。