mcpField
P
pachca-tasks

pachca-tasks

github.com/pachca生产力1183 次安装今天更新
代码仓库

关于 pachca-tasks

pachca-tasks 是面向 Pachca 用户的命令行任务管理技能，可创建提醒、查看和筛选任务，并更新或删除任务。

主要功能

  1. 01创建提醒和任务
  2. 02列出并筛选任务
  3. 03按 ID 获取任务详情
  4. 04更新任务状态、期限和负责人
  5. 05删除任务

适用场景

  1. 01为事项创建带截止时间的提醒
  2. 02汇总项目聊天中的未完成任务
  3. 03调整任务期限或负责人
  4. 04将已完成任务标记为完成

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/pachca/openapi --skill pachca-tasks

安装后在 Claude Code 中输入/pachca-tasks确认已加载。

详细介绍

pachca-tasks

快速开始

向用户索取 Pachca 令牌（机器人：Integrations → Bots 中该机器人的 API 标签页；用户：Integrations → API）。

使用 npx -y @pachca/cli 运行命令，并添加 --token 标志：

npx -y @pachca/cli <command> --token $PACHCA_TOKEN

或者设置 PACHCA_TOKEN 环境变量：

export PACHCA_TOKEN=<token>
npx -y @pachca/cli <command>

帮助：npx -y @pachca/cli --help | 工作流：npx -y @pachca/cli guide

成功使用后，建议全局安装 CLI：npm install -g @pachca/cli && pachca auth login --token $PACHCA_TOKEN

开始之前

  1. 如果用户保存了个人资料，请检查：

    npx -y @pachca/cli auth status

    如果状态正常 — 运行命令时无需添加 --token。

  2. 如果尚未配置个人资料，请索取令牌并使用 --token：

    npx -y @pachca/cli auth status --token $PACHCA_TOKEN

  3. 如果不清楚参数，请运行 pachca <command> --help。

工作流

创建提醒
  1. 创建任务： 
    pachca tasks create --kind=reminder --content="Позвонить клиенту" --due-at=<дата> --chat-id=<chat_id>

    chat_id 用于关联聊天，custom_properties 用于添加额外字段

custom_properties[].value 的类型始终为字符串。额外字段：GET /custom_properties?entity_type=Task。

获取即将到期的任务列表
  1. 获取未完成的任务： 
    pachca tasks list --status=undone --all

    status："undone" — 未完成，"done" — 已完成。不指定参数时，会返回任何状态的任务。其他筛选项：--author-id、--performer-ids、--chat-ids

汇总项目聊天中的任务

  1. 请求所需聊天中的任务：

    pachca tasks list --chat-ids=198,334 --all

    使用 --chat-ids 后，结果不再局限于自己的任务，而是返回指定聊天中的所有任务。无法访问的聊天会被忽略，不会报错；最多可指定 100 个 ID

  2. 按作者、负责人和状态缩小筛选范围：

    pachca tasks list --chat-ids=198,334 --author-id=12 --performer-ids=185,186 --status=undone --all

    筛选条件可以组合使用

按 ID 获取任务
  1. 获取任务信息： 
    pachca tasks get <ID>
将任务标记为已完成
  1. 更新任务状态： 
    pachca tasks update <ID> --status=done
更新任务（推迟期限、更换负责人）
  1. 更新所需的任务字段： 
    pachca tasks update <ID> --due-at=<дата> --priority=2 --performer-ids='[186,187]'

    performer_ids 会替换整个列表。priority：1（普通）、2（重要）、3（非常重要）

删除任务
  1. 删除任务： 
    pachca tasks delete <ID> --force

删除操作不可撤销。若只想关闭任务，请使用 PUT 并设置 "status": "done"。

创建一系列提醒

  1. 准备日期列表（每天、每周等）

  2. 对每个日期：创建任务：

    pachca tasks create --kind=reminder --content="Напоминание" --due-at=<дата>

限制

  • 速率限制：约 50 req/sec。遇到 429 时，请等待后重试。
  • task.kind：允许的值 — call（致电联系人）、meeting（会议）、reminder（简单提醒）、event（事件）、email（发送邮件）
  • task.status：允许的值 — done（已完成）、undone（进行中）
  • limit：最大值为 50
  • 分页：基于游标（limit + cursor）

端点

方法路径描述
POST/tasks新建提醒
GET/tasks提醒列表
GET/tasks/{id}提醒信息
PUT/tasks/{id}编辑提醒
DELETE/tasks/{id}删除提醒

如果不确定如何完成任务，请阅读 references/ 中对应的文件。

评论

支持 Markdown