用途:从 Things MCP 数据或等价 JSON 导出构建可重复的 Things 规划摘要,报告近期活动、未来一周至周末的安排、即将到期的截止和具体下一步行动。
主要能力:读取区域、进行中的项目、进行中的待办、近七天已完成待办,以及可选的清单或备注信号;从进行中和近期完成的待办构建紧急度分桶与活动评分;对项目和区域排序并生成有上限的建议;按固定章节顺序输出 Markdown 摘要。
使用方式:优先使用 Things MCP 读取(things_read_areas、things_read_projects、things_read_todos 等)。当 MCP 不可用或需要确定性脚本执行时,改用 JSON 输入:--areas、--projects、--open-todos,可选 --recent-done、--detailed-todos。可用覆盖参数包括 --days-ahead、--due-soon-days、--top-projects、--top-areas、--max-suggestions、--open-count-cap、--output-style、--config、--today。设置解析顺序为 CLI 覆盖、config/customization.yaml、config/customization.template.yaml、脚本默认值。
输出契约:以 # Things Planning Digest - YYYY-MM-DD 开头的 Markdown;章节顺序为 Executive Summary(仅当 outputStyle=executive)、Snapshot、Recently Active、Week/Weekend Ahead、Suggestions;尽量使用准确的任务、项目和区域名称。若范围内没有进行中的待办且没有近期完成的待办,输出恰好 No findings。
限制与守卫:除非明确要求,绝不修改 Things 数据;MCP 不可用时报告缺失权限并在提供 JSON 输入时回退;两者皆无时停止并报告一条确定性的 Input error,指明缺失文件、不可读路径、无效 JSON 或不支持的 JSON 结构。参考文件包括 references/output-format.md、customization.md、config-schema.md、suggestion-rules.md、automation-prompts.md。其他细节暂未提供。