核心用法
linear-todos 是一个基于 Linear 项目管理平台的 CLI 任务管理技能，通过执行 Python 源码实现与 Linear GraphQL API 的交互。用户可通过自然语言创建、查询、完成和延期任务，支持智能日期解析（如"明天"、"下周五"、"3天后"）和五级优先级系统。
主要工作流程：
1. 初始化配置：运行 setup 命令完成交互式配置，或使用环境变量直接启动
2. 创建任务：create 命令支持 --when（day/week/month）、--date（自然语言日期）、--priority（urgent/high/normal/low/none）
3. 任务管理：list 查看待办、done 标记完成、snooze 延期、review 生成每日简报
4. 自动化集成：可选配置 cron 任务实现每日摘要推送
显著优点
- 自然语言处理：支持"next Monday"、"in 2 weeks"等直观日期表达，降低操作门槛
- 与 Linear 深度集成：直接利用 Linear 的 issue 系统，适合已有 Linear 工作流的团队
- 灵活的认证方式：支持环境变量（推荐）或本地配置文件（~/.config/linear-todos/config.json，权限 0o600）
- 时区感知：可配置本地时区，确保"今天截止"等概念符合用户实际
- 源码透明：作为 SOURCE-EXECUTION 技能，所有代码可查（src/linear_todos/），便于安全审计
- 无遥测设计：仅连接 api.linear.app，无第三方数据上报
潜在缺点与局限性
- 依赖 Linear 平台：无 Linear 账户则无法使用，不适用于通用 todo 场景
- API 密钥明文存储风险：若使用
setup命令，密钥以明文存储于 JSON 文件（虽有 600 权限保护） - Python 运行时依赖：需要 uv 管理 Python 环境，增加部署复杂度
- 无离线能力：所有数据实时从 Linear API 获取，无本地缓存
- 权限配置门槛：需理解 Linear 的 team/state 概念才能正确配置
适合人群
- 已有 Linear 工作流的开发者/团队：希望将个人待办与团队项目管理统一
- 命令行偏好者：习惯 CLI 工具且需要快速创建任务
- 自动化需求用户：希望通过 cron/OpenClaw 定时任务生成每日简报
常规风险
| 风险类别 | 具体描述 | 缓解建议 |
|---------|---------|---------|
| 凭证泄露 | API key 明文存储于 ~/.config/linear-todos/config.json | 优先使用 LINEAR_API_KEY 环境变量；若用配置文件，确保 0o600 权限 |
| 密钥权限过大 | 用户可能复用高权限 Linear token | 创建专用 API key，最小化 scope（仅 issues 读写）|
| 代码执行风险 | SOURCE-EXECUTION 模式运行 Python 源码 | 首次使用前审计 src/linear_todos/api.py 确认仅访问 api.linear.app |
| 时区配置错误 | 未配置时区导致"今天"判断偏差 | 务必设置 LINEAR_TIMEZONE 或配置 timezone 字段 |
安全等级综合评估：S（需审计源码但设计透明，密钥管理有明确最佳实践）