2.0 KiB
2.0 KiB
创建任务(+create)
必填信息收集
在调用 task_create 前,引导用户提供:
| 字段 | 必填 | 说明 |
|---|---|---|
module_id |
✅ | 所属模块(从缓存解析名字 → ID) |
title |
✅ | 任务标题(简洁明了) |
description |
可选 | 任务详情、背景、验收标准 |
due_date |
可选 | 截止日期(YYYY-MM-DD 格式) |
priority |
可选 | low / medium / high / urgent,默认 medium |
assignee_ids |
可选 | 执行人(从缓存解析人名 → user_id) |
执行步骤
Step 1: 解析模块名 → module_id
→ Read ~/.claude/huanxi-cache/modules.json
→ 模糊匹配模块名(详见 huanxi-org resolve-ids.md)
Step 2: [若用户提到执行人] 解析人名 → user_id
→ Read ~/.claude/huanxi-cache/users.json
→ 未命中 → mcp__huanxi__user_list(name=<人名>) → 追加写缓存
Step 3: 创建任务
→ mcp__huanxi__task_create(
module_id = "<模块ID>",
title = "任务标题",
description = "...", ← 可选
due_date = "YYYY-MM-DD", ← 可选
priority = "medium" ← 可选
)
→ 返回:task_id
Step 4: 设置执行人(若 Step 2 有解析到)
→ mcp__huanxi__task_set_assignees(
task_id = "<刚创建的 task_id>",
assignee_ids = ["<user_id>"]
)
Step 5: 告知创建结果
→ 展示:任务标题、所属模块、执行人、截止日、task_id
→ 询问:"是否需要进一步调整?"
权限说明
用户必须是所属模块的成员(任意角色)才能创建任务。若返回 403:
- 可能未加入该模块
- 建议联系模块负责人添加成员,或请管理员使用 Admin MCP 操作
子任务支持
若需创建子任务:
mcp__huanxi__task_create(
module_id = "<模块ID>",
title = "子任务标题",
parent_task_id = "<父任务ID>" ← 传此字段即为子任务
)