AG-02 · Agent
01 / 18
Agent 怎样理解项目并验证结果
把陌生仓库整理成可以执行、验证和接续的任务环境。
- 沿实际入口和数据建立阅读路线。
- 组织规则、任务、详细资料与当前状态。
- 让结论回到源码、日志和产物。
AG-02 · Agent
02 / 18
项目理解与验证架构
AG-02 · Agent
03 / 18
项目事实清单
- 目标、技术栈、入口、依赖和运行方法。
- 数据格式、单位、默认值与当前问题。
- 允许修改的文件与成果接受条件。
- 版本、工作区变化和已读范围，不能只记目录。
AG-02 · Agent
04 / 18
代码阅读路线
01
从根说明与项目地图找到发起入口。
02
追调用方、参数与实际被调用模块。
03
核对数据、配置、返回与错误分支。
04
查看对应样本、测试和日志，再写行为结论。
AG-02 · Agent
05 / 18
上下文分层
| 层次 | 放什么 | 更新时机 |
|---|---|---|
| 稳定规则 | 长期项目约束 | 规则与版本变化 |
| 任务说明 | 本次目标和验收 | 任务调整 |
| 按需资料 | 详细代码与规范 | 实现变化 |
| 当前状态 | 结果、失败和下一步 | 每个阶段结束 |
AG-02 · Agent
06 / 18
信息选择与压缩
保留
- 目标、只读边界与关键单位。
- 已确认事实和对应来源。
- 失败尝试、未完成项和下一步。
移入记录
- 重复长日志与无关文件。
- 已经解释过的详细实现。
- 原始证据保留路径，随时可回查。
AG-02 · Agent
07 / 18
搜索方法与确认
rg --files
rg -n 'inspect_csv' 示例
找到命中后，打开上下文。- 文件名找模块，符号找调用，错误文本找失败路径。
- 语义检索适合发现线索，不能替代读正文。
- 确认当前工作目录与目标机器后再执行。
AG-02 · Agent
08 / 18
版本与矛盾检查
- 同名旧文件要比较 HEAD、哈希和运行配置。
- 文档的设计意图与源码实现分别记录。
- Cindy 导读称零依赖，清单却有协议依赖。
- 保留宿主注入的结构判断，另登记包依赖措辞差异。
AG-02 · Agent
09 / 18
记忆分类
| 内容 | 用途 | 适合的边界 |
|---|---|---|
| 用户偏好 | 持续要求 | 保留适用条件 |
| 项目决定 | 稳定约束与理由 | 附来源与日期 |
| 会话摘要 | 中断接续 | 保存目标与未完成项 |
| 任务进度 | 当前工作状态 | 完成后不当永久规则 |
AG-02 · Agent
10 / 18
更新与过期处理
01
新资料与旧摘要冲突时，确定适用版本。
02
回读源码或配置，而后更新派生知识。
03
写明核验日期与失效条件。
04
配置变了就更新默认值，不能用旧记忆覆盖当前事实。
AG-02 · Agent
11 / 18
长任务拆解
- 每步说明输入、产物、依赖和完成条件。
- 先解决影响后续工作的主要不确定性。
- 独立资料读取可并行，共享协议应先统一。
- 按交付成果衡量进度，不按工具调用数衡量。
AG-02 · Agent
12 / 18
验证方法与证据
| 目标 | 对应证据 | 覆盖边界 |
|---|---|---|
| 规则行为 | 固定答案与实际命令 | 局部样本 |
| 数据交接 | 字段与数值一致性 | 接口合同 |
| 界面或地图 | 浏览器、引擎与视觉检查 | 真实环境 |
| 资料整理 | 正文、日期和来源核对 | 解释与出处 |
AG-02 · Agent
13 / 18
可接续任务包
项目与任务
- 项目导读：入口、数据、运行方法。
- 任务说明：目标、范围和接受标准。
- 给出真实样本，不让接手者重新猜测。
结果与交接
- 完成项、命令与实际结果。
- 未验证部分及原因。
- 下一步、文件位置与恢复条件。
AG-02 · Agent
14 / 18
中断与交接
01
先读交接，恢复目标与已确认事实。
02
检查文件、环境和配置是否改变。
03
判断旧检查仍适用，必要时重跑相关项。
04
继续未完成步骤，保留旧观察与新观察的区别。
AG-02 · Agent
15 / 18
模板填写练习
项目：CSV 资产检查器
入口：lab.py
任务：缺少 kind 列时失败
样本：missing_columns.csv
验收：正常答案保持正确
交接：命令、结果、未测范围- 项目导读、任务和交接各写一份。
- 由另一位读者寻找入口并运行。
- 未运行模型对照时明确保留空白。
AG-02 · Agent
16 / 18
常见失败与改进
| 失败 | 需要补充 | 可以看到的改进 |
|---|---|---|
| 读错版本 | 源码哈希与当前配置 | 事实属于明确版本 |
| 只列目录 | 入口与调用追踪 | 解释真实数据流 |
| 进度写成规则 | 知识分类与范围 | 长期约束不受偶然事件污染 |
| 验证不对应成果 | 目标与检查映射 | 每项结论有实际依据 |
AG-02 · Agent
17 / 18
项目理解思维导图
AG-02 · Agent
18 / 18
来源与后续章节
- Cindy 仓库地图
导航入口，需继续追实际调用
- Cindy 开发工作流
任务与工程检查约束
- Aipcg 代码学习总览
入口、模块与数据线索
- 学习实验结果
本次实测与模型未运行范围
- 本章完整学习稿
含解释、案例、练习与逐项来源
- 版本来源索引
来源、版本、核验日期与使用位置
核验日期：2026-10-10。具体机制见 CC-02，项目追踪见 PCG-01／CY-02。