Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 1 addition & 0 deletions skills/lark-calendar/SKILL.md
Original file line number Diff line number Diff line change
Expand Up @@ -139,6 +139,7 @@ lark-cli calendar +freebusy --start 2026-03-11 --end 2026-03-12 --user-id ou_xxx

## 时间推断规范

- **日期锚点**:解析“今天”“明天”“下周一”等相对日期前,必须先按 [`lark-shared` 的「日期锚点与相对日期」](../lark-shared/SKILL.md#日期锚点与相对日期) 确定真实当前日期和时区,再生成日历查询或写入所需的绝对时间。
- **星期的定义**:周一是一周的第一天,周日是最后一天。计算"下周一"等相对日期时,基于当前真实日期推算。
- **一天的范围**:用户提到"明天""今天"等泛指某天时,时间范围应覆盖整天,不要自行缩减。
- **历史时间约束**:不能预约已经完全过去的时间。唯一例外是"跨越当前时间"的日程(开始在过去、结束在未来)。
Expand Down
10 changes: 9 additions & 1 deletion skills/lark-shared/SKILL.md
Original file line number Diff line number Diff line change
@@ -1,13 +1,21 @@
---
name: lark-shared
version: 1.0.0
description: "Use for lark-cli setup/auth tasks: auth login/status/logout, user vs bot identity, business-domain permissions (--domain, including all/docs/drive), missing scopes, revoking authorization, or handling _notice JSON."
description: "Use for lark-cli shared rules: current-date anchoring, auth login/status/logout, user vs bot identity, business-domain permissions (--domain, including all/docs/drive), missing scopes, revoking authorization, or handling _notice JSON."
---

# lark-cli 共享规则

本技能指导你如何通过lark-cli操作飞书资源, 以及有哪些注意事项。

## 日期锚点与相对日期

当用户使用“今天 / 明天 / 本周 / 上周 / 今年 / 当前年份”等相对日期时:

1. 先以运行环境或系统消息中的当前日期和时区为锚点;如果缺少可靠锚点,先执行 `date` 获取本机日期,再解析用户请求。
2. 日期加减、周边界和时间戳转换必须使用系统命令或脚本计算,不要心算。
3. 示例中的日期只用于说明格式;禁止从示例、历史对话、模型训练时间或旧文档推断当前年份,尤其不要默认使用 2025。

## 配置初始化

首次使用需运行 `lark-cli config init` 完成应用配置。
Expand Down
1 change: 1 addition & 0 deletions skills/lark-task/SKILL.md
Original file line number Diff line number Diff line change
Expand Up @@ -12,6 +12,7 @@ metadata:

**CRITICAL — 开始前 MUST 先用 Read 工具读取 [`../lark-shared/SKILL.md`](../lark-shared/SKILL.md),其中包含认证、权限处理**

> **日期范围规则**:用户以“今天”“本周”“今年以来”等相对日期限定任务范围、开始时间或截止时间时,必须先按 [`lark-shared` 的「日期锚点与相对日期」](../lark-shared/SKILL.md#日期锚点与相对日期) 确定真实当前日期和时区,再将范围转换为 API 参数或本地筛选条件。
> **任务搜索技巧**:先区分用户是否**特地指定使用搜索 skill**,以及是否真的提供了**查询关键字**(例如任务名称、关键词、片段描述)。如果用户特地指定使用搜索 skill,或明确给出了任务查询关键字,则目标是**任务**时优先使用 `+search`。如果用户没有特地指定使用搜索 skill,且意图里没有查询关键字,只有范围条件(例如“今年以来”“已完成”“由我创建”“我关注的”),并且使用 `+search` 与 `+get-related-tasks` / `+get-my-tasks` 都能达到目的时,应优先使用列表型能力,而不是搜索型能力。其中,“与我相关 / 我关注的 / 由我创建”等优先考虑 `+get-related-tasks`;“我负责的 / 分配给我”的列表优先考虑 `+get-my-tasks`。不要把时间范围词(例如“今年以来”)本身误当成 `query` 去走搜索。
> **任务搜索相关性提示**:`+search` 当前不会自动判断搜索结果与搜索发起人的相关性。如果用户明确要求搜索“与我相关”的任务,必须先识别具体关系,获取当前用户的 `open_id`,并显式传入对应的 `--assignee`(负责人)、`--creator`(创建人)或 `--follower`(关注人)过滤条件;不能只依赖 `query` 期待自动返回与当前用户相关的任务。
> **任务清单搜索技巧**:任务清单也遵循同样的判断逻辑。先区分用户是否**特地指定使用搜索 skill**,以及是否真的提供了**清单查询关键字**(例如清单名称、关键词、片段描述)。如果用户特地指定使用搜索 skill,或明确给出了清单查询关键字,则优先使用 `+tasklist-search`。如果用户没有特地指定使用搜索 skill,且意图里没有查询关键字,只有范围条件(例如“由我创建的任务清单”“今年以来创建的清单”),并且使用搜索或原生列取清单都能达到目的时,应优先使用原生 `tasklists.list` 接口列取清单(先 `schema task.tasklists.list`,再 `lark-cli task tasklists list --as user ...`),再按 `creator`、`created_at` 等字段做本地筛选和分页控制。
Expand Down
4 changes: 2 additions & 2 deletions skills/lark-workflow-meeting-summary/SKILL.md
Original file line number Diff line number Diff line change
Expand Up @@ -51,7 +51,7 @@ lark-cli auth login --domain vc,drive # 含读取纪要文档正文、生成

### Step 1: 确定时间范围

默认**过去 7 天**。推断规则:"今天"→当天,"这周"→本周一~now,"上周"→上周一~上周日,"这个月"→1日~now。
先按 [`lark-shared` 的「日期锚点与相对日期」](../lark-shared/SKILL.md#日期锚点与相对日期) 确定真实当前日期和时区。默认**过去 7 天**。推断规则:"今天"→当天,"这周"→本周一~now,"上周"→上周一~上周日,"这个月"→1日~now。

> **注意**:日期转换必须调用系统命令(如 `date`),不要心算。时间范围参数需根据 CLI 实际要求格式化(通常为 `YYYY-MM-DD` 或 ISO 8601)。

Expand Down Expand Up @@ -119,4 +119,4 @@ lark-cli docs +update --doc "<url_or_token>" --command append --doc-format markd
- [lark-shared](../lark-shared/SKILL.md) — 认证、权限(必读)
- [lark-vc](../lark-vc/SKILL.md) — `+search`、`+detail` 详细用法
- [lark-note](../lark-note/SKILL.md) — `note +detail`、`note +transcript`(unified 纪要逐字稿)
- [lark-doc](../lark-doc/SKILL.md) — `+fetch`、`+create`、`+update` 详细用法
- [lark-doc](../lark-doc/SKILL.md) — `+fetch`、`+create`、`+update` 详细用法
4 changes: 4 additions & 0 deletions skills/lark-workflow-standup-report/SKILL.md
Original file line number Diff line number Diff line change
Expand Up @@ -37,6 +37,10 @@ lark-cli auth login --domain calendar,task
AI 汇总(时间转换 + 冲突检测 + 排序)──► 摘要
```

### Step 0: 确定目标日期

对“今天”“明天”“本周”等相对日期,先按 [`lark-shared` 的「日期锚点与相对日期」](../lark-shared/SKILL.md#日期锚点与相对日期) 确定真实当前日期和时区,再计算 `--start` / `--end` / `--due-end` 需要的绝对时间。下方示例日期只说明格式,不代表当前年份。

### Step 1: 获取日程

```bash
Expand Down
Loading