task-management

Sales task management tool for SCRM. Create, update, delete, and list sales follow-up tasks. 销售任务管理工具，支持查询、创建、更新、删除销售人员的客户跟进任务。

Security Scan

The skill's code and instructions match its stated purpose (create/list/update/delete sales tasks) and request no unusual privileges, but it will send user-provided task data to an external backend (iautomark.sdm.qq.com) and does not declare any authentication mechanism — verify the endpoint before use.

Purpose & Capability

Name/description, SKILL.md and agent.py are consistent: functions implement list/create/update/delete task operations and call the documented backend endpoints. There are no unrelated binaries, env vars, or config paths requested.

Instruction Scope

SKILL.md instructs the agent to extract parameters from user messages and call agent.py functions which make network POST requests to the declared backend. This is within scope, but it means user-provided content (task title, content, customer IDs, etc.) will be transmitted to the external API.

Install Mechanism

No install spec is present (instruction-only install), so nothing is downloaded or written to disk by an installer. The code depends on aiohttp; the skill does not include an install step to ensure that dependency is present.

Credentials

The skill requests no environment variables or credentials. This is plausible but notable: the backend endpoints are used without any authentication headers (only Content-Type/Accept). Typically task APIs require authentication, so either the backend accepts unauthenticated calls or auth is handled externally. Verify how the backend authenticates and that sending customer/sales data to that domain is acceptable.

Persistence & Privilege

The skill does not request always:true, does not modify other skills or system config, and is user-invocable. It requires network access to the backend but has no elevated platform persistence.

Assessment

Before installing, verify the backend endpoint (https://iautomark.sdm.qq.com/ai-assistant) is owned/trusted by whoever provided the skill and that its privacy/security practices meet your requirements. Ask the author how authentication is handled (the code sends requests without API keys or tokens) and confirm whether sensitive customer data will be stored or logged by that service. Ensure aiohttp will be available in the runtime, and consider testing with non-sensitive data in a sandbox. If you cannot verify the backend or its auth, do not use this skill with real PII or production accounts.

销售任务管理 Skill

1. Description

这是一个销售任务管理技能，用于帮助销售人员管理客户跟进任务。支持以下操作：

• 查询任务：查询指定销售和客户的任务列表，支持按日期筛选
• 创建任务：为销售人员创建新的客户跟进任务
• 更新任务：修改已有任务的标题、内容或时间
• 删除任务：根据任务 ID 删除一个或多个任务

后端 API 地址：https://iautomark.sdm.qq.com/ai-assistant

2. When to use

• 用户说："帮我查一下销售 XXX 的任务"
• 用户说："查看客户 XXX 今天的跟进任务"
• 用户说："帮我创建一个任务，明天下午3点跟进客户"
• 用户说："新建一个任务提醒我联系客户"
• 用户说："把任务 123 的时间改成后天上午10点"
• 用户说："更新任务标题为..."
• 用户说："删除任务 456"
• 用户说："批量删除任务 1,2,3"
• 用户提到"日程"、"任务"、"跟进"、"提醒"等与销售任务相关的关键词

3. How to use

3.1 查询任务 (list_tasks)

从用户消息中提取参数，调用 agent.py 中的 list_tasks 函数：

• sale_id（必填）：销售人员 ID
• external_id（可选）：客户 ID。不传则查询该销售的所有任务
• task_date（可选）：指定日期，格式为 yyyy-MM-dd

返回任务列表，包含任务 ID、标题、详情、时间、目标客户昵称。

3.2 创建任务 (create_task)

从用户消息中提取参数，调用 agent.py 中的 create_task 函数：

• sale_id（必填）：销售人员 ID
• external_id（必填）：客户 ID
• title（必填）：任务标题
• content（必填）：任务内容
• task_time（必填）：任务时间，格式为 yyyy-MM-dd HH:mm
• sop_id（可选）：SOP ID，格式为 sopId 或 sopId-groupId

3.3 更新任务 (update_task)

使用前需已知任务的详情信息（建议先查询）。调用 agent.py 中的 update_task 函数：

• sale_id（必填）：销售人员 ID
• task_id（必填）：任务 ID（数字）
• title（可选）：新的任务标题
• content（可选）：新的任务内容
• task_time（可选）：新的任务时间，格式为 yyyy-MM-dd HH:mm

3.4 删除任务 (delete_task)

调用 agent.py 中的 delete_task 函数：

• task_ids（必填）：要删除的任务 ID，多个用逗号分隔，如 "1,2,3"

4. Implementation

• 核心文件：agent.py
• 依赖库：aiohttp（异步 HTTP 请求）
• 后端 API 基础地址：https://iautomark.sdm.qq.com/ai-assistant
• 接口列表：
  • POST /v1/task/getMyTask - 查询任务
  • POST /v1/task/create - 创建任务
  • POST /v1/task/updateMyTask - 更新任务
  • POST /v1/task/deleteMyTask - 删除任务
• 时间格式：yyyy-MM-dd HH:mm（上海时区）

5. Edge cases

• 时间格式不正确：提示用户使用 yyyy-MM-dd HH:mm 格式
• 未提供必填参数：提示用户补充
• 查询无结果：告知用户没有找到匹配的任务
• API 请求失败：返回错误信息，建议用户重试
• 删除部分失败：返回失败的任务 ID 列表
• 更新任务前建议先查询确认任务存在