项目导读、任务说明与交接
每次任务只填写相关项,写具体对象、动作与可检查结果。空缺信息标为“待确认”;没有运行的检查标为“未执行”。
项目导读
| 项目事实 | 填写内容 |
|---|---|
| 目标与使用者 | 工具解决什么问题、谁使用结果 |
| 版本 | HEAD、未提交变化、关键文件哈希或运行版本 |
| 入口 | 主命令、界面动作、输入路径 |
| 数据 | 字段、类型、单位、坐标、标识、真实样例 |
| 依赖 | 解释器、服务、插件、资产和运行机器 |
| 阅读顺序 | 根索引 → 适用规则 → 调用入口 → 数据 → 检查 |
| 状态与错误 | 接受、执行、保存、验证和失败分别怎样表达 |
任务说明
目标: 在哪个输入和动作下得到什么结果。
现状: 预期、实际、复现步骤和证据文件。
范围: 可修改的文件或模块、应保留的已有行为、允许的数据操作。
输入与输出: 输入文件、字段含义;报告、代码、页面或引擎产物的保存位置。
接受条件: 哪些样本应通过或失败;怎样确认结果符合业务;哪些部分需要人判断。
步骤: 先解决关键不确定性,再按依赖完成修改。每步写对应产物。
交接说明
| 内容 | 填写要求 |
|---|---|
| 行为变化 | 用一个触发例子说明前后结果 |
| 修改位置 | 文件和主要接口,可点击定位 |
| 关键判断 | 决定、原因、适用范围及反例 |
| 检查 | 实际命令、环境、时间、输出文件和结论 |
| 验证边界 | 静态分析/本次运行/历史结果/尚未执行分别列明 |
| 剩余问题 | 缺项、风险、继续所需的资料与动作 |
| 后续用法 | 下一位使用者怎样运行和判断结果 |
已填写的最小示例
目标:CSV 缺少 kind 时报告输入错误;正常清单仍按资产命名规则检查。输入:missing_columns.csv。检查:python V2.0/示例/学习实验/lab.py;实际结果见 学习实验,记录 missing columns: kind。这次实验执行确定性 Python,没有调用模型或修改真实资产。