配套资料

Cindy 调用与开发交接模板

用途:分别记录产品 Agent 的调用过程与使用 Agent 开发项目的过程。配套章节:CY-01、CY-02。本模板不执行真实工具或外部服务。

A. 产品任务调用记录

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

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

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

B. 开发修复任务记录

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

C. Pi 案例的填写参照

资料见 研究记录。原症状是 Windows 长 exe 打包停在“已工作”;受控复现证明 Pi 已退出而后代仍持有输出管道时退出通知缺失。当前修复在确认 child exit 后最多排空尾帧 250ms,再通知上层,不自动重放请求。

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

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