用途:面向项目工时日志,重建有证据支持的工作描述,并将用户确认的时长追加到项目的 TIME.csv,也处理修正记录。
主要能力:通过上下文解析确定唯一有效项目(仅凭文件夹、Git 根目录或当前目录不能确立项目);读取 DOCUMENTS.csv、PROJECT.md、TASKS.csv 及相关源文件,找出带日期的计划、决策与事件,作为工作描述的证据来源;为同一活动聚合证据,不按文件数量夸大工作量,并标记已记录过的证据;time.list 只读,time.append 追加一行已确认记录,编号(E 编号)永久不变,重复行返回已有条目;修正以引用原 E 编号的新条目表示,不修改、删除或重编号原记录。
使用方式:先确定请求的时间段,缺失则询问;执行 time.list 等原生读取并检查相关文档;准备含空时长、稳定来源 ID 与置信度的描述;每次写入前遵循“检查→准备→验证准备→应用→验证结果→完成”的变更流程,预览确切行后再应用并重新读取确认。
限制:小时数只能来自用户,会议时长、时间戳、提交记录和任务状态都不能作为时长依据;未知的来源或工作日期保持未解决;证据不足时不得声称工时表完整;不得把已有记录转为计费事实,也不得静默从原时长中扣除修正;若所需保证不可用,先保留已确认条目并报告限制。实际费用、平台支持等信息暂未提供。