Aight Utils

Native integration with the Aight iOS app.

Creates reminders, tasks, and tracked items that appear in the user's Aight Today view.

When to Use

User Says	Create Type	Example
"Remind me to..."	INLINECODE0	INLINECODE1
"Don't forget..."

Item Types

Type	Use For	Key Fields
INLINECODE11	Time-based, fire-once	INLINECODE12 (ISO 8601)
INLINECODE13

Usage Examples

Create a Reminder

CODEBLOCK0

Create a Task

CODEBLOCK1

Create a Deadline

CODEBLOCK2

Track a PR

CODEBLOCK3

Mark Complete

CODEBLOCK4

ID Generation Rules

- Format: INLINECODE19
Slug: kebab-case, 2-4 words describing the item
Timestamp: Unix epoch or short hash for uniqueness

Examples:

- INLINECODE20
INLINECODE21
INLINECODE22
INLINECODE23

Labels Convention

Use consistent labels for categorization:

Category	Labels
Work	INLINECODE24, `meeting`, `code-review`, INLINECODE27
Personal

Date Parsing

Parse natural language dates to ISO 8601:

User Input	ISO 8601
"tomorrow at 2pm"	INLINECODE36
"next Friday"

2026-03-27T09:00:00+08:00 |
| "end of day" | 2026-03-22T23:59:59+08:00 |
| "in 2 hours" | 2026-03-22T17:30:00+08:00 |

Current time: 2026-03-22 23:45 GMT+8 (Asia/Shanghai)

Rules

1. Always generate unique IDs — use slug + timestamp
Parse dates before calling — convert natural language to ISO 8601
Set labels for categorization — helps user filter in Today view
Default status is "active" — don't set unless changing
For reminders: always use type: "trigger" with INLINECODE41
For tasks: use type: "item" with INLINECODE43
For completions: update existing item with INLINECODE44

Integration with Other Skills

Skill	Integration Point
INLINECODE45	Outcome tracking → create deadline triggers
INLINECODE46

Important events → create reminder triggers | | watchdog | Task completion → update item status |

Error Handling

If item creation fails:

1. Log to INLINECODE48
Inform user: "Couldn't create reminder — adding to memory instead"
Create fallback in INLINECODE49

Version: 1.0.0
Author: alex
Last Updated: 2026-03-22

Aight 工具集

与 Aight iOS 应用的原生集成。

创建提醒、任务和追踪项目，这些内容将显示在用户的 Aight 今日视图中。

使用场景

用户表述	创建类型	示例
提醒我...	trigger	scheduledFor: ISO 8601
别忘了...

项目类型

类型	用途	关键字段
trigger	基于时间，触发一次	scheduledFor (ISO 8601)
item

使用示例

创建提醒

json
{
id: remind-dentist-1711123200,
type: trigger,
text: 打电话给牙医预约时间,
scheduledFor: 2026-03-23T14:00:00+08:00,
labels: [health, personal]
}

创建任务

json
{
id: task-bp-draft-1711123200,
type: item,
text: 起草Q2融资商业计划书,
labels: [work, fundraising],
status: active
}

创建截止日期

json
{
id: deadline-tax-1711123200,
type: trigger,
text: 提交纳税申报表,
scheduledFor: 2026-04-15T23:59:59+08:00,
type: deadline,
labels: [finance, urgent]
}

追踪 PR

json
{
id: pr-openclaw-123-1711123200,
type: item,
text: 审查 OpenClaw PR #123,
url: https://github.com/openclaw/openclaw/pull/123,
labels: [code-review],
status: active
}

标记完成

json
{
id: task-bp-draft-1711123200,
status: done
}

ID 生成规则

- 格式：<类型>-<短标识>-<时间戳>
短标识：短横线命名法，2-4个词描述项目
时间戳：Unix 纪元时间或短哈希以确保唯一性

示例：

- remind-groceries-1711123200
task-bp-draft-1711123200
deadline-tax-2026q1
pr-openclaw-123

标签约定

使用一致的标签进行分类：

类别	标签
工作	work, meeting, code-review, fundraising
个人

日期解析

将自然语言日期解析为 ISO 8601 格式：

用户输入	ISO 8601
明天下午2点	2026-03-23T14:00:00+08:00
下周五

2026-03-27T09:00:00+08:00 |
| 今天结束前 | 2026-03-22T23:59:59+08:00 |
| 2小时后 | 2026-03-22T17:30:00+08:00 |

当前时间： 2026-03-22 23:45 GMT+8 (亚洲/上海)

规则

1. 始终生成唯一 ID — 使用短标识 + 时间戳
调用前先解析日期 — 将自然语言转换为 ISO 8601
设置分类标签 — 帮助用户在今日视图中筛选
默认状态为 active — 除非更改状态，否则不设置
对于提醒： 始终使用 type: trigger 并附带 scheduledFor
对于任务： 使用 type: item 并附带 labels
对于完成操作： 使用 status: done 更新现有项目

与其他技能的集成

技能	集成点
proactive-agent	结果追踪 → 创建截止日期触发器
memory-manager

重要事件 → 创建提醒触发器 | | watchdog | 任务完成 → 更新项目状态 |

错误处理

如果项目创建失败：

1. 记录到 .learnings/ERRORS.md
通知用户：无法创建提醒 — 已改为存储到记忆中
在 memory/YYYY-MM-DD.md 中创建备用记录

版本： 1.0.0
作者： alex
最后更新： 2026-03-22

aight-utilsAight工具集成

aight-utils

Aight Utils

When to Use

Item Types