ae-things-progress

Thing 进展摘要

采用 aha-links 的事实收集和输出约定。请先阅读 Thing 操作 和 CLI 参考。CLI 负责收集事实，由当前模型进行摘要；不要调用单独的报告后端。报告及报告标题应使用用户的语言撰写。

处理与本次运行绑定的 Thing 时，请先按照执行快照和实时上下文中的说明读取其执行快照。然后按照以下工作流收集最新的评审或周期事实，并分别描述这些来源。未绑定 Thing 时，只使用用户明确指定的范围。

范围和时间

ae-cli things +digest --agent-space-id <space-id> --from 2026-09-07T00:00:00+08:00 --to 2026-09-14T00:00:00+08:00 --time-zone Asia/Shanghai --format json
ae-cli things +digest --agent-space-id <space-id> --assignee-id <member-id> --format json
ae-cli things +digest --agent-space-id <space-id> --thing-ids <id-a>,<id-b> --format json

绝不要猜测 ID 或选择个人默认空间。不支持关注列表、群组和跨空间摘要。日报覆盖日历日；周报从周一 00:00 开始，到下一个周一 00:00 结束，默认时区为 Asia/Shanghai。对于今天／本周，使用当前时间作为截止时间；对于昨天／上周，使用完整周期。自定义时间范围必须明确指定。命令中的 from/to 值必须包含时区，时间范围包含开始时间，不包含结束时间。

将记录的 ISO 时间戳转换为报告时区，并在时间范围、收集时间和证据日期旁标明时区。例如，2026-09-10T04:50:00Z 在 Asia/Shanghai 时区应显示为 2026-09-10 12:50 (Asia/Shanghai)。去掉 Z 并将 04:50 称为「上海时间」是不正确的。如果无法可靠地进行转换，则保留原始 ISO 值，标明为 UTC，并说明该值尚未转换；绝不要编造本地时间。

证据和完整性

检查 fetchedCount、truncated、consistency 和 collectedAt；对于明确指定的集合，还要检查 requestedCount 和 unreadable。字段缺失时，停止得出完整覆盖范围的结论。CLI 会自动分页，每条链最多 100 页／10000 个条目，并将错误或达到限制的情况标记为截断。单页列表不能替代完整收集。

• thing 表示当前状态，entries 表示时间范围内的记录，baseline 表示根据完整的业务变更记录还原出的时间范围开始前状态。若缺少基线，或收集期间版本发生变化，不要臆造基线。
• lastEffectiveRecordBeforeWindow 用于定位时间范围开始前的证据。当前状态不是该周期内的变更，不能直接代替周期结束时的状态。
• 输出前，将 collectedAt 与时间范围的 to 进行比较。当 collectedAt < to 时（包括用户指定的完整日历周尚未结束的情况），说明这是截至收集时间的中期摘要，且该周期仍在进行。三种状态的计数应标为「收集时状态」，而非「周期结束时状态」或「之后没有更新」。例如，9 月 10 日收集的 9 月 7 日至 14 日周报，不能声称 9 月 14 日的状态与当前状态相同。即使时间范围已结束，也只有在完整的周期后变更证据支持时，才能还原周期结束时的状态。
• 分别统计 open／paused／done，并单独报告已归档的 Thing。最新进展来自 thing.latestProgress；历史变更请读取进展／状态记录。
• 备注和重复的流程描述不属于有效进展。effectiveProgressCount 是待核实的候选计数；应排除内容未提供新信息的记录。
• 没有记录时，只能说「没有记录更新」。此限制同样适用于摘要和下一步建议。open 不能证明工作尚未开始；只能报告当前状态以及缺少已记录事实的情况。应披露未读或无法访问的附件、截断情况，以及多个请求之间不具事务性的限制。对于 changed_during_collection，应先重新读取；如果变更仍在继续，则保留此限制，不要声称收集结果是静态且完整的。

输出与回写

先说明范围、时间窗口、收集时间和覆盖限制。然后给出三种状态和归档数量、期间变更、阻碍因素及后续步骤。每项重要判断都附上 Thing 来源和日期，并区分事实、推断和建议。默认不显示内部记录 ID。

默认仅在对话中输出。明确要求回写时，使用 +detail 读取目标 Thing 的所有报告条目，并检查是否已有标题涵盖相同范围和期间。然后使用 ae-cli things entry append --id <target-id> --type note --title "Things weekly report | date range | scope" --stdin --command-id <uuid> --format json 写入最终正文。建议的标题格式为 Things weekly report | date range | scope（或 daily report），并本地化为用户使用的语言。如果已存在相同范围和期间的报告，应提出修订建议，而不是静默覆盖或追加重复内容。仅在用户明确要求时才追加新修订，并保留原报告。一旦获得回写许可，不要再次询问相同的许可。

不要自动发送消息、更改状态、分配负责人或创建定时任务。

文件证据：+detail/+digest 会自动分页读取资源关联记录。availability=missing 或 verification_failed 的文件不是可用的交付物。即使文件可用，也仅表示该引用可用，不代表已读取其内容或通过验收。披露未读取的文件和非事务性收集的限制。只有当前用户有权访问时，才读取私有对话来源。在报告中引用共享 Thing 事实；不要自动披露私有历史。