@wagemule/daemon 0.1.0 → 0.1.3

package/dist/skills/larksuite/lark-slides/scripts/template_tool_test.py

@@ -0,0 +1,177 @@
+# Copyright (c) 2026 Lark Technologies Pte. Ltd.
+# SPDX-License-Identifier: MIT
+from __future__ import annotations
+
+import tempfile
+import unittest
+from pathlib import Path
+
+import template_tool
+
+
+class TemplateToolTest(unittest.TestCase):
+    @classmethod
+    def setUpClass(cls) -> None:
+        cls.index_data = template_tool.build_index_data()
+
+    def test_build_index_data_exposes_light_general_metadata(self) -> None:
+        template = next(
+            entry for entry in self.index_data["templates"] if entry["template_id"] == "office--light_general"
+        )
+        expected_keys = {
+            "template_id",
+            "category",
+            "category_label",
+            "scene",
+            "tone",
+            "formality",
+            "is_general_template",
+            "slide_count",
+            "presentation_title",
+            "palette",
+            "structure",
+            "page_types",
+            "layout_tags",
+            "use_cases",
+            "ranges",
+        }
+        self.assertEqual(set(template.keys()), expected_keys)
+        self.assertEqual(template["tone"], "light")
+        self.assertEqual(template["formality"], "formal")
+        self.assertEqual(template["slide_count"], 54)
+        self.assertEqual(template["presentation_title"], "白底通用模板")
+        self.assertIsInstance(template["layout_tags"], list)
+        self.assertNotIn("theme_summary", template)
+        self.assertNotIn("editable_regions", template)
+        self.assertNotIn("bbox_summary", template)
+
+    def test_search_templates_keeps_work_report_templates_in_top_results(self) -> None:
+        results = template_tool.search_templates(self.index_data, {"query": "工作汇报", "limit": 3})
+        self.assertTrue(results)
+        self.assertTrue(any(entry["template_id"] == "office--work_report" for entry in results))
+
+    def test_search_templates_extracts_scene_from_long_chinese_prompt(self) -> None:
+        results = template_tool.search_templates(
+            self.index_data,
+            {"query": "帮我做一个季度工作汇报PPT，偏正式", "limit": 3},
+        )
+        self.assertTrue(results)
+        self.assertTrue(any(entry["template_id"] == "office--work_report" for entry in results))
+
+    def test_search_templates_maps_chinese_tone_words(self) -> None:
+        results = template_tool.search_templates(
+            self.index_data,
+            {"query": "深色科技感产品发布", "limit": 5},
+        )
+        self.assertTrue(results)
+        self.assertTrue(any(entry["tone"] == "dark" for entry in results))
+
+    def test_search_templates_finds_product_launch_and_promotion_defense(self) -> None:
+        product_results = template_tool.search_templates(
+            self.index_data,
+            {"query": "产品发布会新品介绍", "limit": 5},
+        )
+        self.assertTrue(product_results)
+        self.assertTrue(
+            any(
+                entry["template_id"]
+                in {"office--project_kickoff", "product--product_intro", "product--product_promotion"}
+                for entry in product_results
+            )
+        )
+
+        defense_results = template_tool.search_templates(
+            self.index_data,
+            {"query": "晋升答辩 个人述职", "limit": 5},
+        )
+        self.assertTrue(defense_results)
+        self.assertTrue(any(entry["template_id"] == "personal--promotion_defense" for entry in defense_results))
+
+    def test_extract_selection_xml_keeps_only_requested_slides_and_theme(self) -> None:
+        xml = template_tool.extract_selection_xml(self.index_data, "office--light_general", {"label": "封面"})
+        self.assertEqual(len(template_tool.re.findall(r"<slide\b", xml)), 2)
+        self.assertIn("<theme>", xml)
+        self.assertIn("<title>白底通用模板</title>", xml)
+
+    def test_summarize_selection_aggregates_slide_titles_and_counts(self) -> None:
+        summary = template_tool.summarize_selection(self.index_data, "office--light_general", {"label": "封面"})
+        self.assertEqual(summary["selection"]["range"], "1-2")
+        self.assertEqual(summary["summary"]["slide_count"], 2)
+        self.assertTrue(summary["theme_summary"]["has_theme_node"])
+        self.assertIn("通用模板", summary["summary"]["title_hints"])
+        self.assertGreater(summary["summary"]["element_totals"]["shape"], 0)
+        self.assertIsInstance(summary["slides"][0]["layout_tags"], list)
+        self.assertIn("bbox_summary", summary["slides"][0])
+        self.assertIn("editable_regions", summary["slides"][0])
+
+    def test_template_selector_accepts_catalog_visible_filename(self) -> None:
+        entry = template_tool.resolve_template_entry(self.index_data, "work_report.xml")
+        self.assertEqual(entry["template_id"], "office--work_report")
+
+    def test_template_path_uses_user_supplied_file(self) -> None:
+        source_path = template_tool.TEMPLATES_DIR / "office--work_report.xml"
+        with tempfile.TemporaryDirectory() as temp_dir:
+            copied_path = Path(temp_dir) / "work_report.xml"
+            copied_path.write_text(
+                source_path.read_text(encoding="utf-8").replace(
+                    "<title>工作汇报</title>",
+                    "<title>Copied Path Template</title>",
+                    1,
+                ),
+                encoding="utf-8",
+            )
+
+            xml = template_tool.extract_selection_xml(
+                self.index_data,
+                str(copied_path),
+                {"range": "1"},
+            )
+
+        self.assertIn("<title>Copied Path Template</title>", xml)
+
+    def test_template_path_accepts_unindexed_xml_with_range(self) -> None:
+        xml = (
+            '<presentation xmlns="http://www.larkoffice.com/sml/2.0">'
+            "<title>Generated Template</title>"
+            "<slide><data></data></slide>"
+            "</presentation>"
+        )
+        with tempfile.TemporaryDirectory() as temp_dir:
+            template_path = Path(temp_dir) / "generated.xml"
+            template_path.write_text(xml, encoding="utf-8")
+
+            extracted = template_tool.extract_selection_xml(
+                self.index_data,
+                str(template_path),
+                {"range": "1"},
+            )
+
+        self.assertIn("<title>Generated Template</title>", extracted)
+
+    def test_search_templates_supports_layout_tag_filtering(self) -> None:
+        results = template_tool.search_templates(
+            self.index_data,
+            {"query": "", "layout-tag": "full-bleed-image-caption", "limit": 10},
+        )
+        self.assertTrue(results)
+        self.assertTrue(
+            any("full-bleed-image-caption" in entry["layout_tags"] for entry in results)
+        )
+
+    def test_all_template_files_are_cataloged_and_indexed(self) -> None:
+        template_files = sorted(path.stem for path in template_tool.TEMPLATES_DIR.glob("*.xml"))
+        indexed_templates = sorted(entry["template_id"] for entry in self.index_data["templates"])
+        self.assertEqual(indexed_templates, template_files)
+        self.assertEqual(self.index_data["template_count"], len(template_files))
+        self.assertTrue(template_files)
+
+    def test_catalog_range_parser_keeps_comma_separated_ranges(self) -> None:
+        template = next(
+            entry for entry in self.index_data["templates"] if entry["template_id"] == "operations--product_promotion"
+        )
+        content_range = next(item for item in template["ranges"] if item["label"] == "内容")
+        self.assertEqual(content_range["range"], "3-8, 10-12")
+
+
+if __name__ == "__main__":
+    unittest.main()

package/dist/skills/larksuite/lark-task/SKILL.md

@@ -0,0 +1,165 @@
+---
+name: lark-task
+version: 1.0.0
+description: "飞书任务：管理任务、清单和任务智能体。创建待办任务、查看和更新任务状态、拆分子任务、组织任务清单、分配协作成员、上传任务附件、注册或注销任务智能体、更新任务智能体的主页数据、写入智能体任务记录。当用户需要创建待办事项、查看任务列表、跟踪任务进度、管理项目清单或给他人分配任务、为任务上传附件文件、注册注销任务智能体、更新智能体主页数据、写入任务记录时使用。"
+metadata:
+  requires:
+    bins: ["lark-cli"]
+  cliHelp: "lark-cli task --help"
+---
+
+# task (v2)
+
+**CRITICAL — 开始前 MUST 先用 Read 工具读取 [`../lark-shared/SKILL.md`](../lark-shared/SKILL.md)，其中包含认证、权限处理**
+
+> **任务搜索技巧**：先区分用户是否**特地指定使用搜索 skill**，以及是否真的提供了**查询关键字**（例如任务名称、关键词、片段描述）。如果用户特地指定使用搜索 skill，或明确给出了任务查询关键字，则目标是**任务**时优先使用 `+search`。如果用户没有特地指定使用搜索 skill，且意图里没有查询关键字，只有范围条件（例如“今年以来”“已完成”“由我创建”“我关注的”），并且使用 `+search` 与 `+get-related-tasks` / `+get-my-tasks` 都能达到目的时，应优先使用列表型能力，而不是搜索型能力。其中，“与我相关 / 我关注的 / 由我创建”等优先考虑 `+get-related-tasks`；“我负责的 / 分配给我”的列表优先考虑 `+get-my-tasks`。不要把时间范围词（例如“今年以来”）本身误当成 `query` 去走搜索。
+> **任务清单搜索技巧**：任务清单也遵循同样的判断逻辑。先区分用户是否**特地指定使用搜索 skill**，以及是否真的提供了**清单查询关键字**（例如清单名称、关键词、片段描述）。如果用户特地指定使用搜索 skill，或明确给出了清单查询关键字，则优先使用 `+tasklist-search`。如果用户没有特地指定使用搜索 skill，且意图里没有查询关键字，只有范围条件（例如“由我创建的任务清单”“今年以来创建的清单”），并且使用搜索或原生列取清单都能达到目的时，应优先使用原生 `tasklists.list` 接口列取清单（先 `schema task.tasklists.list`，再 `lark-cli task tasklists list --as user ...`），再按 `creator`、`created_at` 等字段做本地筛选和分页控制。
+> **意图区分补充**：像“搜索飞书中今年以来我关注的任务”这类表达，虽然字面带有“搜索”，但如果没有真正的查询关键字，且本质是在限定“与我相关 + 时间范围”，则应优先走 `+get-related-tasks`；像“搜索飞书中由我创建的任务清单”这类表达，如果没有清单关键字，且本质是在限定“清单范围 + 创建者”，则应优先走原生 `tasklists.list` 后筛选，而不是直接走搜索型 shortcut。
+> **用户身份识别**：在用户身份（user identity）场景下，如果用户提到了“我”（例如“分配给我”、“由我创建”），请默认获取当前登录用户的 `open_id` 作为对应的参数值。
+> **术语理解**：如果用户提到 “todo”（待办），应当思考其是否是指“task”（任务），并优先尝试使用本 Skill 提供的命令来处理。
+> **友好输出**：在输出任务（或清单）的执行结果给用户时，建议同时提取并输出命令返回结果中的 `url` 字段（任务链接），以便用户可以直接点击跳转查看详情。
+
+> **创建/更新注意**：
+> 1. 只有在设置了 `due`（截止时间）的情况下，才能设置 `repeat_rule`（重复规则）和 `reminder`（提醒时间）。
+> 2. 若同时设置了 `start`（开始时间）和 `due`（截止时间），开始时间必须小于或等于截止时间。
+> 3. 使用 tenant_access_token（应用身份）时，无法跨租户添加任务成员。
+
+> **查询注意**：
+> 1. 在输出任务详情时，如果需要渲染负责人、创建人等人员字段，除了展示 `id` (例如 open_id) 外，还必须通过其他方式（例如调用通讯录技能）尝试获取并展示这个人的真实名字，以便用户更容易识别。
+> 2. 在输出清单详情时，如果需要渲染 owner、member、角色成员等人员字段，也必须像任务成员展示一样，除了展示 `id` 外，尽量解析并展示对应人员的真实名字。
+> 3. 在输出任务或清单详情时，如果需要渲染创建时间、截止时间等字段，需要使用本地时区来渲染（格式为2006-01-02 15:04:05）。
+
+> **Task GUID 定义**：
+> Task OpenAPI 中用于更新/操作任务的 `guid` 是任务的全局唯一标识（GUID），不是客户端展示的任务编号（例如 `t104121` / `suite_entity_num`）。
+> 对于 Feishu 的任务 applink（例如 `.../client/todo/task?guid=...`），必须使用 URL query 里的 `guid` 参数作为 task guid。
+
+## Shortcuts
+
+- [`+create`](./references/lark-task-create.md) — Create a task
+- [`+update`](./references/lark-task-update.md) — Update a task
+- [`+comment`](./references/lark-task-comment.md) — Add a comment to a task
+- [`+complete`](./references/lark-task-complete.md) — Complete a task
+- [`+reopen`](./references/lark-task-reopen.md) — Reopen a task
+- [`+assign`](./references/lark-task-assign.md) — Assign or remove members from a task
+- [`+followers`](./references/lark-task-followers.md) — Manage task followers
+- [`+reminder`](./references/lark-task-reminder.md) — Manage task reminders
+- [`+get-my-tasks`](./references/lark-task-get-my-tasks.md) — List tasks assigned to me
+- [`+get-related-tasks`](./references/lark-task-get-related-tasks.md) — List tasks related to me
+- [`+search`](./references/lark-task-search.md) — Search tasks
+- [`+subscribe-event`](./references/lark-task-subscribe-event.md) — Subscribe to task events
+- [`+set-ancestor`](./references/lark-task-set-ancestor.md) — Set or clear a task ancestor
+- [`+tasklist-create`](./references/lark-task-tasklist-create.md) — Create a tasklist and batch add tasks
+- [`+tasklist-search`](./references/lark-task-tasklist-search.md) — Search tasklists
+- [`+tasklist-task-add`](./references/lark-task-tasklist-task-add.md) — Add existing tasks to a tasklist
+- [`+tasklist-members`](./references/lark-task-tasklist-members.md) — Manage tasklist members
+- [`+upload-attachment`](./references/lark-task-upload-attachment.md) — Upload a file as a task attachment
+
+## API Resources
+
+```bash
+lark-cli schema task.<resource>.<method>   # 调用 API 前必须先查看参数结构
+lark-cli task <resource> <method> [flags] # 调用 API
+```
+
+> **重要**：使用原生 API 时，必须先运行 `schema` 查看 `--data` / `--params` 参数结构，不要猜测字段格式。
+
+### tasks
+
+  - `create` — 创建任务
+  - `delete` — 删除任务
+  - `get` — 获取任务详情
+  - `list` — 列取任务列表
+  - `patch` — 更新任务
+
+### tasklists
+
+  - `add_members` — 添加清单成员
+  - `create` — 创建清单
+  - `delete` — 删除清单
+  - `get` — 获取清单详情
+  - `list` — 获取清单列表
+  - `patch` — 更新清单
+  - `remove_members` — 移除清单成员
+  - `tasks` — 获取清单任务列表
+
+### subtasks
+
+  - `create` — 创建子任务
+  - `list` — 获取任务的子任务列表
+
+### members
+
+  - `add` — 添加任务成员
+  - `remove` — 移除任务成员
+
+### sections
+
+  - `create` — 创建自定义分组
+  - `delete` — 删除自定义分组
+  - `get` — 获取自定义分组详情
+  - `list` — 获取自定义分组列表
+  - `patch` — 更新自定义分组
+  - `tasks` — 获取自定义分组任务列表
+
+### custom_fields
+
+  - `create` — 创建自定义字段
+  - `get` — 获取自定义字段详情
+  - `patch` — 更新自定义字段
+  - `list` — 获取自定义字段列表
+  - `add` — 将自定义字段加入资源
+  - `remove` — 将自定义字段移出资源
+
+### custom_field_options
+
+  - `create` — 创建自定义字段选项
+  - `patch` — 更新自定义字段选项
+
+### agent
+
+  - `update_agent_profile` — 更新任务代理的主页内容数据。
+  - `register_agent` — 注册AI 智能体
+
+### agent_task_step_info
+
+  - `append_task_steps` — 写入任务记录。
+
+## 权限表
+
+| 方法 | 所需 scope |
+|------|-----------|
+| `tasks.create` | `task:task:write` |
+| `tasks.delete` | `task:task:write` |
+| `tasks.get` | `task:task:read` |
+| `tasks.list` | `task:task:read` |
+| `tasks.patch` | `task:task:write` |
+| `tasklists.add_members` | `task:tasklist:write` |
+| `tasklists.create` | `task:tasklist:write` |
+| `tasklists.delete` | `task:tasklist:write` |
+| `tasklists.get` | `task:tasklist:read` |
+| `tasklists.list` | `task:tasklist:read` |
+| `tasklists.patch` | `task:tasklist:write` |
+| `tasklists.remove_members` | `task:tasklist:write` |
+| `tasklists.tasks` | `task:tasklist:read` |
+| `subtasks.create` | `task:task:write` |
+| `subtasks.list` | `task:task:read` |
+| `members.add` | `task:task:write` |
+| `members.remove` | `task:task:write` |
+| `sections.create` | `task:section:write` |
+| `sections.delete` | `task:section:write` |
+| `sections.get` | `task:section:read` |
+| `sections.list` | `task:section:read` |
+| `sections.patch` | `task:section:write` |
+| `sections.tasks` | `task:section:read` |
+| `custom_fields.create` | `task:custom_field:write` |
+| `custom_fields.get` | `task:custom_field:read` |
+| `custom_fields.patch` | `task:custom_field:write` |
+| `custom_fields.list` | `task:custom_field:read` |
+| `custom_fields.add` | `task:custom_field:write` |
+| `custom_fields.remove` | `task:custom_field:write` |
+| `custom_field_options.create` | `task:custom_field:write` |
+| `custom_field_options.patch` | `task:custom_field:write` |
+| `agent.update_agent_profile` | `task:task:write` |
+| `agent.register_agent` | `task:task:write` |
+| `agent_task_step_info.append_task_steps` | `task:task:write` |
+| `+upload-attachment` | `task:attachment:write` |

package/dist/skills/larksuite/lark-task/references/lark-task-assign.md

@@ -0,0 +1,38 @@
+# task +assign
+
+> **Prerequisites:** Please read `../lark-shared/SKILL.md` to understand authentication, global parameters, and security rules.
+
+Assign or remove members (assignees) from a task.
+
+## Recommended Commands
+
+```bash
+# Add an assignee
+lark-cli task +assign --task-id "<task_guid>" --add "ou_aaa"
+
+# Add an app assignee
+lark-cli task +assign --task-id "<task_guid>" --add "cli_xxx"
+
+# Transfer an assignee (remove old, add new)
+lark-cli task +assign --task-id "<task_guid>" --remove "ou_old" --add "ou_new"
+
+# Add multiple assignees
+lark-cli task +assign --task-id "<task_guid>" --add "ou_aaa,ou_bbb"
+```
+
+## Parameters
+
+| Parameter | Required | Description |
+|-----------|----------|-------------|
+| `--task-id <guid>` | Yes | The task GUID to modify. For Feishu task applinks, use the `guid` query parameter, not the `suite_entity_num` / display task ID like `t104121`. |
+| `--add <ids>` | No | Comma-separated assignee IDs. Use user `open_id`s like `ou_xxx` for people, or app IDs like `cli_xxx` for apps. |
+| `--remove <ids>` | No | Comma-separated assignee IDs. Use user `open_id`s like `ou_xxx` for people, or app IDs like `cli_xxx` for apps. |
+
+## Workflow
+
+1. Confirm the task and members to add/remove.
+2. Execute the command.
+3. Report success and the new count of assignees.
+
+> [!CAUTION]
+> This is a **Write Operation** -- You must confirm the user's intent before executing.

package/dist/skills/larksuite/lark-task/references/lark-task-comment.md

@@ -0,0 +1,28 @@
+# task +comment
+
+> **Prerequisites:** Please read `../lark-shared/SKILL.md` to understand authentication, global parameters, and security rules.
+
+Add a comment to an existing task.
+
+## Recommended Commands
+
+```bash
+# Add a comment
+lark-cli task +comment --task-id "<task_guid>" --content "Looks good!"
+```
+
+## Parameters
+
+| Parameter | Required | Description |
+|-----------|----------|-------------|
+| `--task-id <guid>` | Yes | The task GUID to comment on. For Feishu task applinks, use the `guid` query parameter, not the `suite_entity_num` / display task ID like `t104121`. |
+| `--content <text>` | Yes | The text content of the comment. |
+
+## Workflow
+
+1. Confirm the task and comment content.
+2. Execute `lark-cli task +comment --task-id "..." --content "..."`
+3. Report success and comment ID.
+
+> [!CAUTION]
+> This is a **Write Operation** -- You must confirm the user's intent before executing.

package/dist/skills/larksuite/lark-task/references/lark-task-complete.md

@@ -0,0 +1,27 @@
+# task +complete
+
+> **Prerequisites:** Please read `../lark-shared/SKILL.md` to understand authentication, global parameters, and security rules.
+
+Mark a task as completed.
+
+## Recommended Commands
+
+```bash
+# Complete a task
+lark-cli task +complete --task-id "<task_guid>"
+```
+
+## Parameters
+
+| Parameter | Required | Description |
+|-----------|----------|-------------|
+| `--task-id <guid>` | Yes | The task GUID to complete. For Feishu task applinks, use the `guid` query parameter, not the `suite_entity_num` / display task ID like `t104121`. |
+
+## Workflow
+
+1. Confirm the task to complete.
+2. Execute the command.
+3. Report success.
+
+> [!CAUTION]
+> This is a **Write Operation** -- You must confirm the user's intent before executing.

package/dist/skills/larksuite/lark-task/references/lark-task-create.md

@@ -0,0 +1,57 @@
+# task +create
+
+> **Prerequisites:** Please read `../lark-shared/SKILL.md` to understand authentication, global parameters, and security rules.
+
+Create a new task in Lark.
+
+## Recommended Commands
+
+```bash
+# Create a task with all details
+lark-cli task +create \
+  --summary "Quarterly Sales Review" \
+  --description "Review the sales performance for the last quarter." \
+  --assignee "ou_xxx" \
+  --due "2026-03-25" \
+  --tasklist-id "https://applink.larkoffice.com/client/todo/task_list?guid=a4b00000-000-000-000-00000000036c"
+
+# Create a task assigned to an app
+lark-cli task +create \
+  --summary "Nightly Sync" \
+  --assignee "cli_xxx"
+
+# Create a simple task
+lark-cli task +create \
+  --summary "Buy milk"
+
+# Preview the API call without executing
+lark-cli task +create --summary "Test Task" --dry-run
+```
+
+## Parameters
+
+| Parameter | Required | Description |
+|-----------|----------|-------------|
+| `--summary <text>` | Yes | The title or summary of the task |
+| `--description <text>` | No | Detailed description of the task |
+| `--assignee <id>` | No | Assignee ID. Use user `open_id` like `ou_xxx` for people, or app ID like `cli_xxx` for apps. |
+| `--follower <id>` | No | Follower ID. Use user `open_id` like `ou_xxx` for people, or app ID like `cli_xxx` for apps. |
+| `--due <time>` | No | Due date. Supports ISO 8601, `YYYY-MM-DD`, relative time (e.g., `+2d`), or ms timestamp. `YYYY-MM-DD` and relative time will automatically set it as an all-day task. |
+| `--tasklist-id <id>` | No | The GUID of the tasklist, or a full AppLink URL (the CLI will automatically extract the `guid` parameter from the URL). |
+| `--idempotency-key <key>` | No | Client token to ensure idempotency of the request. |
+| `--dry-run` | No | Preview the API call (JSON payload) without actually creating the task. |
+
+## Workflow
+
+1. Confirm with the user: task summary, due date, assignee, and tasklist if necessary.
+   - **Crucial Rule for Assignee**: If the user explicitly or implicitly says "create a task for me" (给我创建一个任务), or "help me create a task" (帮我新建/创建一个任务), you MUST assign the task to the current logged-in user. You can get the current user's `open_id` by executing `lark-cli auth status` (it already outputs JSON by default, so do not add `--json`) or `lark-cli contact +get-user` first, extracting the `userOpenId` or `open_id`, and then passing it to the `--assignee` parameter.
+2. Execute `lark-cli task +create --summary "..." ...`
+3. Report the result: task ID and summary.
+
+> [!CAUTION]
+> This is a **Write Operation** -- You must confirm the user's intent before executing.
+
+## References
+
+- [lark-task](../SKILL.md) -- All task commands
+- [lark-shared](../../lark-shared/SKILL.md) -- Authentication and global parameters

package/dist/skills/larksuite/lark-task/references/lark-task-followers.md

@@ -0,0 +1,35 @@
+# task +followers
+
+> **Prerequisites:** Please read `../lark-shared/SKILL.md` to understand authentication, global parameters, and security rules.
+
+Manage task followers. Add or remove followers from an existing task.
+
+## Recommended Commands
+
+```bash
+# Add a follower
+lark-cli task +followers --task-id "<task_guid>" --add "ou_aaa"
+
+# Add an app follower
+lark-cli task +followers --task-id "<task_guid>" --add "cli_xxx"
+
+# Remove a follower
+lark-cli task +followers --task-id "<task_guid>" --remove "ou_aaa"
+```
+
+## Parameters
+
+| Parameter | Required | Description |
+|-----------|----------|-------------|
+| `--task-id <guid>` | Yes | The task GUID to modify. For Feishu task applinks, use the `guid` query parameter, not the `suite_entity_num` / display task ID like `t104121`. |
+| `--add <ids>` | No | Comma-separated follower IDs. Use user `open_id`s like `ou_xxx` for people, or app IDs like `cli_xxx` for apps. |
+| `--remove <ids>` | No | Comma-separated follower IDs. Use user `open_id`s like `ou_xxx` for people, or app IDs like `cli_xxx` for apps. |
+
+## Workflow
+
+1. Confirm the task and followers to add/remove.
+2. Execute the command.
+3. Report success.
+
+> [!CAUTION]
+> This is a **Write Operation** -- You must confirm the user's intent before executing.

package/dist/skills/larksuite/lark-task/references/lark-task-get-my-tasks.md

@@ -0,0 +1,55 @@
+# task +get-my-tasks
+
+If the user query only specifies a task name (e.g., "Complete task Lobster No. 1"), use this command to list and search for the task by its summary.
+
+> **Prerequisites:** Please read `../lark-shared/SKILL.md` to understand authentication, global parameters, and security rules.
+> 
+> **⚠️ Note:** This API must be called with a user identity. **Do NOT use an app identity, otherwise the call will fail.**
+>
+> **Output rendering note:**
+> 1. If you need to present user fields (assignee, creator, etc.), do not only output the raw `id` (e.g. open_id). Also try to resolve and display the user's real name (e.g. via the contact skill) for readability.
+> 2. When rendering timestamps (e.g. created time, due time), use the local timezone. Format is 2006-01-02 15:04:05
+
+List tasks assigned to the current user, with support for filtering by completion status, creation time, and due date.
+By default, the command will automatically paginate up to 20 times. Use `--page-all` to fetch more (up to 40 pages).
+
+## Recommended Commands
+
+```bash
+# Search for a specific task by name
+lark-cli task +get-my-tasks --query "Lobster No. 1"
+
+# Get all my tasks (fetches up to 20 pages by default)
+lark-cli task +get-my-tasks
+
+# Get my incomplete tasks (fetches up to 20 pages by default)
+lark-cli task +get-my-tasks --complete=false
+
+# Fetch all my tasks (up to 40 pages)
+lark-cli task +get-my-tasks --page-all
+
+# Fetch up to 10 pages
+lark-cli task +get-my-tasks --page-limit 10
+
+# Resume from a known page token
+lark-cli task +get-my-tasks --page-token "pt_xxx"
+```
+
+## Parameters
+
+| Parameter | Required | Description |
+|-----------|----------|-------------|
+| `--query <string>` | No | Search for tasks by summary. Returns exact matches if any; otherwise returns partial matches. |
+| `--complete=<bool>` | No | Optional. If not provided, it fetches all tasks (both incomplete and completed). Set to `true` to fetch only completed tasks, or `false` for incomplete tasks. |
+| `--created_at <string>` | No | Query tasks created after this time. Supports date: `YYYY-MM-DD`, relative: `-2d`, or ms timestamp. |
+| `--due-start <string>` | No | Query tasks with a due date after this time. Supports date: `YYYY-MM-DD`, relative: `-2d`, or ms timestamp. |
+| `--due-end <string>` | No | Query tasks with a due date before this time. Supports date: `YYYY-MM-DD`, relative: `-2d`, or ms timestamp. |
+| `--page-all` | No | Automatically paginate through all pages (max 40). |
+| `--page-limit <int>` | No | Max page limit (default 20). |
+| `--page-token <string>` | No | Start from the specified page token (useful for resuming a previous query). |
+
+## Workflow
+
+1. Determine the filters based on the user's request.
+2. Execute the command. The CLI will automatically loop up to the specified limit (default 20, or 40 with `--page-all`) to fetch records.
+3. Show the results (ID, summary, due time, and created date).

package/dist/skills/larksuite/lark-task/references/lark-task-get-related-tasks.md

@@ -0,0 +1,53 @@
+# task +get-related-tasks
+
+> **Prerequisites:** Please read `../lark-shared/SKILL.md` to understand authentication, global parameters, and security rules.
+>
+> **⚠️ Note:** This API must be called with a user identity. **Do NOT use an app identity, otherwise the call will fail.**
+>
+> **Pagination / Time Cursor Rule:**
+> In `+get-related-tasks`, `page_token` is the task `updated_at` cursor in microseconds.
+>
+> **Execution Priority:**
+> 1. If the request contains a start/end time boundary (for example, "今年以来", "最近一个月", "从 3 月 1 日开始"), first convert the **start time** boundary to a microsecond `page_token` and query from that token.
+> 2. Continue pagination using returned `page_token` until `has_more=false`, but never exceed 40 total page fetches.
+> 3. Do NOT default to `--page-all` for time-bounded queries.
+>
+> Only use `--page-all` from the beginning when:
+> 1. the user explicitly asks for a full scan of all related tasks, or
+> 2. no time boundary can be inferred from the request.
+
+List tasks related to the current user.
+
+## Recommended Commands
+
+```bash
+# List all related tasks
+lark-cli task +get-related-tasks
+
+# List incomplete related tasks starting from a page token
+lark-cli task +get-related-tasks --include-complete=false --page-token "1752730590582902"
+
+# Show only tasks created by me
+lark-cli task +get-related-tasks --created-by-me
+```
+
+## Parameters
+
+| Parameter | Required | Description |
+|-----------|----------|-------------|
+| `--include-complete=<bool>` | No | Default behavior includes completed tasks. Set to `false` to keep only incomplete tasks. |
+| `--page-all` | No | Automatically paginate through all pages (max 40). |
+| `--page-limit <int>` | No | Max page limit (default 20). |
+| `--page-token <string>` | No | Start from the specified page token. This token is the task's last update time cursor in microseconds. |
+| `--created-by-me` | No | Keep only tasks whose creator is the current user. This is a client-side filter applied after fetching related-task pages. |
+| `--followed-by-me` | No | Keep only tasks followed by the current user. This is a client-side filter applied after fetching related-task pages. |
+
+> **Page Token Note:** In `+get-related-tasks`, the `page_token` is a microsecond-level cursor representing the task's last update time. For example, `1752730590582902` should be treated as an updated-at cursor, not a task ID.
+>
+> **Pagination Note for Client-side Filters:** When `--created-by-me` or `--followed-by-me` is used, filtering happens locally after each upstream related-task page is fetched. The returned `has_more` and `page_token` still describe the upstream cursor, so later pages may contain more matching tasks, or may contain none.
+
+## Workflow
+
+1. Determine whether the user needs all related tasks or a filtered subset.
+2. Execute `lark-cli task +get-related-tasks ...`
+3. Report the matching tasks and, if present, the next `page_token`.