things-digest-generator

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Things Digest Generator

Build a repeatable Things planning digest from Things MCP data or equivalent JSON exports.

基于Things MCP数据或等效的JSON导出文件，构建可重复生成的Things规划摘要。

Inputs

输入项

Preferred data source: Things MCP reads

```
things_read_areas
```
```
things_read_projects
```
with
```
status="open"
```
```
things_read_todos
```
with
```
status="open"
```

things_read_todos

with

status="completed"

and

completed_after=<today-7d>

Optional
```
things_read_todo
```
for checklist or note signals

JSON fallback for deterministic script usage:
- ```
--areas
```
- ```
--projects
```
- ```
--open-todos
```
- optional
```
--recent-done
```
- optional
```
--detailed-todos
```

Optional overrides:

```
--days-ahead
```
```
--due-soon-days
```
```
--top-projects
```
```
--top-areas
```
```
--max-suggestions
```
```
--open-count-cap
```
```
--output-style
```
```
--config
```
```
--today
```

首选数据源：Things MCP读取

```
things_read_areas
```
```
things_read_projects
```
（
```
status="open"
```
）
```
things_read_todos
```
（
```
status="open"
```
）

things_read_todos

（

status="completed"

且

completed_after=<today-7d>

）

可选：用于清单或笔记信号的
```
things_read_todo
```

用于确定性脚本执行的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
```

Workflow

工作流程

Resolve settings from CLI overrides,
```
config/customization.yaml
```
,
```
config/customization.template.yaml
```
, then script defaults.
Prefer live Things MCP reads; fall back to JSON inputs when MCP is unavailable or when deterministic script execution is required.
Build urgency buckets and activity scores from open and recently completed todos.
Rank top projects and areas, then generate bounded suggestions.
If there are no open todos and no recent completed todos, output exactly
```
No findings.
```
Otherwise render the digest using the canonical section order in
```
references/output-format.md
```
.

从CLI覆盖配置、
```
config/customization.yaml
```
、
```
config/customization.template.yaml
```
，再到脚本默认值，依次解析设置。
优先使用实时Things MCP读取；当MCP不可用或需要确定性脚本执行时，回退到JSON输入。
基于未完成和近期已完成的待办事项，构建紧急程度分组和活动评分。
对顶级项目和区域进行排名，然后生成受限的建议内容。
如果没有未完成的待办事项且没有近期已完成的待办事项，则输出内容为
```
No findings.
```
。
否则，按照
```
references/output-format.md
```
中的标准章节顺序渲染摘要。

Output Contract

输出约定

Return markdown that begins at
```
# Things Planning Digest - YYYY-MM-DD
```
.

Return these sections in order after the title:

```
Executive Summary
```
only when
```
outputStyle=executive
```
```
Snapshot
```
```
Recently Active
```
```
Week/Weekend Ahead
```
```
Suggestions
```

Use exact task, project, and area names where available.
If there are no open todos and no recent completed todos in scope, output exactly
```
No findings.
```

返回以
```
# Things Planning Digest - YYYY-MM-DD
```
开头的Markdown内容。

标题后按以下顺序返回这些章节：

仅当
```
outputStyle=executive
```
时显示
```
Executive Summary
```
```
Snapshot
```
```
Recently Active
```
```
Week/Weekend Ahead
```
```
Suggestions
```

尽可能使用确切的任务、项目和区域名称。
如果范围内没有未完成的待办事项且没有近期已完成的待办事项，则输出内容为
```
No findings.
```
。

Guardrails

约束规则

Never modify Things data unless explicitly requested.
If MCP is unavailable, report the missing permission and use JSON fallback when provided.
If neither MCP nor JSON inputs are available, stop and report one deterministic
```
Input error:
```
message that names the missing file, unreadable path, invalid JSON, or unsupported JSON shape.

除非明确要求，否则绝不修改Things数据。
如果MCP不可用，报告缺失的权限，并在提供JSON备选方案时使用该方案。
如果MCP和JSON输入均不可用，则停止执行并返回一条确定性的
```
Input error:
```
消息，说明缺失的文件、无法读取的路径、无效JSON或不支持的JSON格式。

References

参考资料

```
references/output-format.md
```
```
references/customization.md
```
```
references/config-schema.md
```
```
references/suggestion-rules.md
```
```
references/automation-prompts.md
```

```
references/output-format.md
```
```
references/customization.md
```
```
references/config-schema.md
```
```
references/suggestion-rules.md
```
```
references/automation-prompts.md
```