Locu任务管理

技能简介

本技能通过Locu公开API连接你的工作空间，实现任务和项目的查询与管理。支持获取用户信息、列出任务清单、查看项目列表等操作，兼容Locu原生任务及从Linear/Jira集成的外部任务。

业务背景

团队可统一管理工作空间内的Locu原生任务及外部集成的Linear/Jira任务，通过标准化API获取用户、任务与项目信息。消除多系统切换成本，实现任务状态的集中可视化管理。

落地案例：项目经理调用接口获取完整任务清单，识别出从Jira同步的需求评审任务与Locu原生的设计验收任务均临近截止日期，立即协调资源优先处理。开发成员通过环境变量配置Token后，在CI流水线中自动拉取个人待办，生成每日站会汇报材料。

能做什么

• 获取当前用户基本信息
• 列出工作空间中的所有任务
• 查看项目列表
• 解析任务详情（ID、名称、完成状态、类型）

使用说明

安装准备

1. 在Locu平台生成Personal Access Token（PAT）
2. 将Token配置为环境变量：export LOCU_API_TOKEN="your_token_here"

基本调用

所有接口需携带Authorization头：

curl -X GET "https://api.locu.app/api/v1/me" \
  -H "Authorization: Bearer $LOCU_API_TOKEN"

常用端点

• 获取用户信息：/api/v1/me
• 获取任务列表：/api/v1/tasks
• 获取项目列表：/api/v1/projects

数据处理

返回结果为JSON格式，需解析提取字段：id（标识）、name（名称）、done（完成状态）、type（任务类型）。注意区分native类型与linear/jira集成类型。

输入与输出

见下方输入与输出表格。

风险提示

• API Token具有账户操作权限，勿泄露或提交到代码仓库
• 建议定期轮换Personal Access Token
• 生产环境使用需配合IP白名单或额外鉴权层
• Linear/Jira集成任务的字段可能因源系统差异而不同

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/davidsmorais/locu/SKILL.md
来源类型：GitHub开源技能库