# Cindy 调用与开发交接模板

用途：分别记录产品 Agent 的调用过程与使用 Agent 开发项目的过程。配套章节：[CY-01](<../学习成果/Cindy/CY-01_文档与软件结构.md>)、[CY-02](<../学习成果/Cindy/CY-02_Agent使用与开发过程.md>)。本模板不执行真实工具或外部服务。

## A. 产品任务调用记录

```text
任务目标：
用户原始要求与限制：
源码／产品版本与记录日期：
控制端：Desktop／Mobile／其他。
执行端与工作目录：本地还是 SSH？文件真实在哪里？
输入材料：文件引用、附件、历史状态。
完成条件：具体结果和检查办法。

输入入口：例如 input.enqueue；标明普通路径或兼容入口。
接受边界：何时只说明受理，何时实际派发？
上下文：稳定规则、当前输入、历史摘要、实时工具结果。
能力发现：已有 ID、ghost_info 或 ghost_list；真实 schema 的来源。
工具调用：名称、参数、调用 ID、执行位置与返回。
状态反馈：进度、正文、结果、终态、持久记录各有什么？
失败分支：参数错误／不可用／取消／执行器退出／结果未知。
恢复条件：允许查询或重试什么？怎样避免重复副作用？
交付：结果路径、实际核验、遗留项。
证据：源码静态关系／历史日志／本次实测，各自标明。
```

| 步骤 | 决策者／执行者 | 参数或状态 | 实际证据 | 当前还不知道什么 |
|---|---|---|---|---|
| 输入接受 |  |  |  |  |
| 执行派发 |  |  |  |  |
| 工具结果 |  |  |  |  |
| 产品终态 |  |  |  |  |
| 目标验收 |  |  |  |  |

检查要点：发现信息与授权分开；`accepted` 与任务完成分开；广播与异步持久化完成分开；原生 turn 终态与产品续段分开。没有日志时只画静态调用链，不填假时间戳。

## B. 开发修复任务记录

```text
问题：用户触发动作、看到的症状、预期行为。
环境：系统、提交、执行器、依赖版本。
范围：改动模块、保持的接口、明确不处理的其他问题。
适用规则：规范索引与对应权威文档。
假设：候选原因和可反证观察。
最小复现：输入、受控前提、关键状态与结果。
对照：正常、边界、取消或错误情况。
人员与 Agent 工作：只记录材料支持的分工，不猜贡献比例。
最终修改：行为怎样变化，在哪个执行位置落实。
验证：实际命令、结果、版本、日志／报告；历史结果另列。
评审：发现的问题、修正与仍有争议的结论。
未覆盖：真实环境、服务端、模型性能等，按实际填写。
交接：文件位置、当前状态、下一步最小证据。
```

## C. Pi 案例的填写参照

资料见 [研究记录](<../sources.html#ref-73fa23b0a5e810>)。原症状是 Windows 长 exe 打包停在“已工作”；受控复现证明 Pi 已退出而后代仍持有输出管道时退出通知缺失。当前修复在确认 child `exit` 后最多排空尾帧 250ms，再通知上层，不自动重放请求。

历史 134 定向用例与根级 511 通过、1 跳过必须保留为历史结果，本模板没有重跑。Windows 后代 detached 和 EBUSY 清理属于测试前提与清理补充，不能写成真实打包已通过。下一步最小缺口是同轮 Pi／构建 PID、退出码、最后 RPC 帧和 Session 终态时间线。

完成条件：另一位开发者能找到入口、解释已确认的原因、复用复现条件，并区分已做验证、旧记录与待验证项。