feishu-task

核心用法

feishu-task 是一款面向飞书（Lark）平台的任务管理命令行工具，专为多人协作场景设计。该技能提供两大核心功能：任务创建与任务列表查询。用户可通过 create.js 脚本创建带标题、描述、截止日期和指派人的任务，支持多用户同时分配；通过 list.js 脚本可分页查询近期任务状态，便于团队进度跟踪。工具采用 Node.js 开发，通过环境变量配置飞书应用凭证，与飞书开放平台 API 无缝对接。

显著优点

官方生态集成：直接使用飞书官方 Node.js SDK（@larksuiteoapi/node-sdk），API 调用稳定可靠，功能对齐飞书原生任务能力。协作场景优化：原生支持多指派人（assignees）、任务完成状态追踪，区别于日历类工具的时间块管理，更适合需要明确责任人和验收节点的团队工作流。安全架构规范：敏感凭证完全通过环境变量管理，配合 dotenv 实现本地开发配置隔离，无硬编码风险；代码层面彻底杜绝 eval/exec 等危险函数，输入参数经过严格类型校验和边界检查。工程化成熟：依赖版本锁定（package-lock.json），使用 commander 实现健壮的命令行解析，错误处理机制完善且不泄露系统敏感信息。

潜在缺点与局限性

功能覆盖有限：当前仅支持任务创建和列表查询，缺少任务编辑、删除、评论、附件管理等进阶功能，复杂项目管理场景需配合飞书原生界面使用。时区处理固定：日期解析强制采用 Asia/Shanghai 时区，国际化团队使用时可能存在时区理解偏差。环境配置门槛：必须预先在飞书开放平台创建应用并获取 App ID/Secret，对非技术用户有一定上手成本。OpenID 依赖：指派任务需使用飞书用户的 OpenID（ou_xxx），无法直接通过邮箱或姓名指派，需额外查询转换。

适合的目标群体

研发团队：适合在 CI/CD 流水线中自动创建缺陷跟踪任务、发布检查项。项目经理：批量创建迭代任务、定期生成团队任务状态报告。运维工程师：将告警事件自动转化为待办任务并指派值班人员。飞书深度用户：已搭建飞书应用体系、希望将任务管理脚本化的组织。

使用风险

凭证泄露风险：FEISHU_APP_ID 和 FEISHU_APP_SECRET 若配置不当（如误提交至代码仓库），可能导致飞书应用被滥用。API 限流影响：高频调用可能触发飞书开放平台频率限制，影响任务创建成功率。时区理解偏差：跨时区团队成员对截止日期可能存在 8 小时认知差异。功能依赖风险：飞书 API 升级可能导致 SDK 兼容性问题，需关注官方更新。