SuperAPI AI 工具集

things-week-ahead-digest

办公与效率

查看项目

更新于 10-15 21:49

技能介绍

用途:为 Things 生成可重复的规划摘要,包含快照、近期活跃、未来一周/周末预览、建议四部分,帮助确定下一步行动。

主要能力:使用 Things MCP 工具采集数据,包括 things_read_areas、things_read_projects(status="open")、things_read_todos(status="open",完整视图通常设 limit 为 300-500)、things_read_todos(status="completed" 且 completed_after=<today-7d>);需要时对候选任务用 things_read_todo(include_notes=true)获取笔记/清单信号。按配置权重对项目与领域评分:近期完成(近 7 天)、未完成任务、即将到期/逾期数量、笔记中的类清单提示(- [ ]、- [x]、多行项目符号块),据此找出最活跃的项目与领域,并生成配置数量的具体建议(顶部项目的下一步、逾期风险/分类处理、周末或周一准备的规划动作)。输出按 references/output-format.md 模板格式化,风格简洁、可操作,优先动词与具体任务标题。

使用方式:读取生效配置,优先 <skill_root>/config/customization.yaml,回退到 <skill_root>/config/customization.template.yaml。若偏好确定性评分/格式化(自动化、可重复、大数据集),运行脚本: uv run --with pyyaml python scripts/build_digest.py
--areas areas.json
--projects projects.json
--open-todos open_todos.json
--recent-done recent_done.json 脚本读取由 Things MCP 响应导出的 JSON,输出 Markdown 摘要。配置优先级:CLI 参数、config/customization.yaml、config/customization.template.yaml、脚本硬编码默认值。自定义流程:读取生效配置,确认到期与规划窗口、项目/领域数量、评分权重与未完成数量上限、建议上限与输出风格,提出 2-4 个选项包(含一个推荐默认值),据模板创建或更新 config/customization.yaml 并设置 schemaVersion: 1、isCustomized: true、profile: <selected-profile>,生成样例摘要验证并报告变更键与行为差异。自动化提示中使用 $things-week-ahead-digest 让 Codex 可靠加载该流程,模板见 references/automation-prompts.md。

适用场景:定期(如每周)回顾 Things 任务、识别近期活跃项目、准备周末或下周计划。

限制:若某次 MCP 调用因权限失败,需报告缺失权限并继续使用现有可用子集;更细的评分与建议规则见 references/suggestion-rules.md,YAML 模式与取值见 references/config-schema.md,自定义参数见 references/customization.md。其他未在资料中说明的事项暂未提供。