ooodc
a7883dbed9
- 移除 TodoItem 中的 priority、created_at 和 updated_at 字段 - 强制每个任务都必须有唯一 id，且由用户负责生成 - 修改合并模式逻辑，merge=true 下保留未提及的旧任务 - 支持已完成和已取消任务重新激活（状态改回 pending 或 in_progress） - 禁止 in_progress 状态退回到 pending，必须标记为 completed 或 cancelled - 优化状态转换校验，允许特定状态间合法切换 - 简化任务变更消息，移除详细的新增/更新/移除统计 - 更新文档和示例，明确 id 必须由用户生成和使用 - 修复和补充测试，增强状态转换和合并模式验证 - 调整任务时间戳生成逻辑，统一使用当前时间及索引 - 该变更提供更合理的任务状态机械及管理模式，提升稳定性和易用性
7.3 KiB
7.3 KiB
Lark Sheet Sparkline
真对象硬约束
当用户要求"迷你图 / 趋势线 / 单元格内图表"时，必须通过 +sparkline-{create|update|delete} 创建真实的迷你图对象。禁止用文本字符（如 ▁▂▃▅▇）拼接在单元格里、或用 SPARKLINE() 公式函数（已禁用）代替。判断标准：交付后 +sparkline-list 必须能返回该对象。
使用场景
读写迷你图对象。本 reference 覆盖 4 个 shortcut：
| 操作需求 | 使用工具 | 说明 |
|---|---|---|
| 查看已有迷你图 | +sparkline-list |
获取迷你图的类型、数据源和样式配置 |
| 创建/更新/删除迷你图 | `+sparkline-{create | update |
典型工作流：先读取现有迷你图了解配置 → 执行创建/更新/删除 → 必须再次读取验证结果。
常见配置错误（必须注意）：
- 数据源范围要精确：迷你图的数据源范围必须与实际数据行列精确对应，范围偏移会导致图形展示错误
- 不要与 SPARKLINE() 公式混淆：飞书表格的
SPARKLINE()公式函数已被禁用，迷你图只能通过本 Skill 的对象方式创建 - 创建后必须验证：调用
+sparkline-list确认迷你图配置正确
Shortcuts
| Shortcut | Risk | 分组 |
|---|---|---|
+sparkline-list |
read | 对象 |
+sparkline-create |
write | 对象 |
+sparkline-update |
write | 对象 |
+sparkline-delete |
high-risk-write | 对象 |
Flags
+sparkline-list
公共四件套 · 系统：--dry-run
| Flag | Type | 必填 | 说明 |
|---|---|---|---|
--group-id |
string | optional | 按 group_id 过滤 |
+sparkline-create
公共四件套 · 系统：--dry-run
| Flag | Type | 必填 | 说明 |
|---|---|---|---|
--properties |
string + File + Stdin（复合 JSON） | required | JSON：{config（共享样式配置）, sparklines（迷你图数组）}；完整字段结构跑 --print-schema |
+sparkline-update
公共四件套 · 系统：--dry-run
| Flag | Type | 必填 | 说明 |
|---|---|---|---|
--group-id |
string | required | 目标组 id |
--properties |
string + File + Stdin（复合 JSON） | required | JSON：{config, sparklines}；先 +sparkline-list --group-id <id> 回读再 patch；完整字段结构跑 --print-schema |
+sparkline-delete
公共四件套 · 系统：--yes、--dry-run
| Flag | Type | 必填 | 说明 |
|---|---|---|---|
--group-id |
string | required | 目标组 id |
Schemas
复合 JSON flag 字段速查（只列顶层 + 一层嵌套）。深层结构看下方
## Examples，或用--print-schema读完整 JSON Schema（用法见 SKILL.md「公共 flag 速查」与「Agent 使用提示」）。
+sparkline-create --properties / +sparkline-update --properties
创建/更新/部分删除的迷你图属性
顶层字段：
config(object?) — 迷你图样式配置, 相同 groupId 的迷你图共享相同的样式 { theme_type?: enum, non_num_show_as?: enum, empty_show_as?: enum, contain_hidden_cells?: boolean, series_color?: string, …共 13 项 }sparklines(array