# AI Brief 001｜AI 编程工具接手旧项目

公开教学练习包 v1.0 · 2026-10-30

这份材料帮助你练习任务拆解、AI 协作和改动验收。它不是产品对比实测，不含跑分或预填的成功记录。`starter/brief_tasks.py` 刻意保留了一个时区日期错误，状态筛选尚未实现。

## 开始

1. 保留解压后的原件。复制 `starter` 为 `work`，只在 `work` 中修改；也可以用自己的版本控制工具保存原件。
2. 需要本机 Python 3.10 或更新版本。Windows 可使用已安装的 `python`，部分系统使用 `python3`，据实际环境替换。无需安装任何第三方依赖。
3. 阅读 `TASK.md` 和 `ACCEPTANCE.md`。先做日期修复，验收后再做状态筛选。
4. 把相关文件与 `PROMPTS.md` 中的模板交给你选择的助手。模板要求先分析、确认计划，再修改。
5. 在练习目录中运行程序并对照验收。程序只读取与自身同目录的 `tasks.json`、输出 JSON，不联网，也不写文件。

示例（进入 `work` 文件夹后）：

```console
python brief_tasks.py --on 2026-10-31
```

**原始代码的已知行为：**此命令会输出 b03、b04；正确目标是 b01、b03。这是对教学代码的说明，不表示某款工具已经运行过或修好了它。

## 文件用途

- `TASK.md`：任务边界、输入和输出约定（双语）。
- `ACCEPTANCE.md`：期望结果、核对命令和人工审查清单（双语）。
- `PROMPTS.md`：中英文起步提示词。
- `DECISION.md`：选择工作方式与复盘问题（双语）。
- `runs.csv`：只有表头的记录文件；请用真实结果填写。
- `starter/`：练习源码与五条固定示例数据。

## 记录口径

分别记录环境准备与执行耗时。`human_interventions` 指你为纠正理解、错误或范围而发出的干预次数；普通观察不计。`criteria_passed` 和 `criteria_total` 对应 ACCEPTANCE.md 的条件，未执行的写入 `not_checked`，不要算作通过。实际命令输出另存到你自己的记录位置，在 `evidence_path` 中填写位置。

对比时每次从相同的原始副本开始。记录模型、工具、权限、上下文和日期；一次小练习不能推出产品整体排名。涉及真实项目时，先核对你能否向所选服务提供代码与数据。

## 使用许可

本练习包的原创代码与文字可免费用于个人或团队内部练习、修改。对外再分发请注明 AI Brief 并保留“教学材料、非产品实测”的说明。引用的第三方产品文档遵循各自条款，不包含在本包中。

网页样刊：https://ai-brief-5c6a15.pages.dev/briefs/ai-coding-existing-project.html