关于 bitrix24-tasks
面向 Bitrix24 本地部署开发者的服务端任务处理指南，涵盖任务读写、成员、期限、清单和权限。重点说明通过 V2 命令写入，并在执行前检查操作用户权限。
主要功能
- 01任务创建、更新与删除指南
- 02任务列表筛选与分页
- 03成员、期限和清单处理
- 04访问权限与事件说明
- 05V2 命令及兼容方案
适用场景
- 01在本地部署门户中创建或更新任务
- 02查询并筛选任务列表
- 03设置任务成员、期限和标签
- 04执行写操作前核验用户权限
安装
复制下面的命令，在终端中运行。
$
npx skills add https:/安装后在 Claude Code 中输入/bitrix24-tasks确认已加载。
包含的文件
除 SKILL.md 外，安装时一起下载的参考资料和脚本。
rules/access-events.mddetails.mdreading.mdwriting.md详细介绍
Bitrix24 任务（服务端）
范围：Bitrix24 本地部署版 · 已验证版本：tasks 26.300.100、main 26.800.0
| 任务 | 阅读 |
|---|---|
| 选择 API 层；创建、更新、完成、删除；错误 | rules/writing.md |
| 单个任务或任务列表：筛选、排序、分页、日期 | rules/reading.md |
| 成员、截止时间和时区、检查清单、标签、项目、模板、评论 | rules/details.md |
| 访问权限操作、事件及其参数、REST 映射 | rules/access-events.md |
不变量
- 通过 V2 命令写入（
AddTaskCommand、UpdateTaskCommand等；旧版CTaskItem/CTasks最终也会调用相同的 V2 服务）。绝不要直接写入TaskTable或成员/检查清单表，否则会跳过计数器、聊天、搜索、事件和回收站。 - 命令不会检查权限。在调用
run()前，使用TaskAccessService/TaskAccessController检查执行操作的用户。 - 明确传入执行操作的用户 ID（在配置中使用
userId）。Agent 和 CLI 没有$USER；未设置USER_ID时，CTasks::Add会以用户 1 的身份执行。 - V2 实体中的日期是 Unix 时间戳（
deadlineTs）。后台代码绝不要传入站点格式的字符串。 - 将 V2 调用集中在一个
/local网关类中：命令接收V2\Internal\…实体和配置，这些内容可能在不同版本间发生变化。V2 层仅在 tasks 26.300.100 中经过验证；如果class_exists(AddTaskCommand::class)为 false，请使用CTaskItem。 - 新版任务卡：评论是任务聊天中的消息（参见
rules/details.md、bitrix24-im）。
评论
支持 Markdown